Úvod do Microsoft Graph

Implementace zabezpečení Azure pro vývojáře

Anushika Agarwal

Cloud Data Engineer

Co je Microsoft Graph?

Jednotné API pro přístup k datům Microsoft 365
Jeden koncový bod pro všechny služby

Microsoft Graph – jeden koncový bod pro všechny služby

Příklad: PeopleSphere s Microsoft Graph

PeopleSphere používá:
- Outlook pro žádosti o dovolenou
- Teams pro HR schůzky
- OneDrive pro výplatní pásky
Graph je propojuje

Jak PeopleSphere využívá Microsoft Graph

Anatomie volání Graph API

Jednotné API: Jeden koncový bod pro přístup k prostředkům Microsoft Cloud Požadavek Microsoft Graph API

Rozbor požadavku

Součásti požadavku:
- Metoda: GET, POST, PATCH atd.
- Verze: v1.0, beta
- Prostředek: users, groups atd.
- Parametry dotazu: $select, $filter
- Hlavičky: Authorization, Content-Type

Požadavek Microsoft Graph API

Metody

Podporované metody:
- GET: Načtení dat
- POST: Vytvoření nových dat
- PUT: Úplné nahrazení dat
- PATCH: Aktualizace stávajících dat
- DELETE: Odebrání dat

Verzování: v1.0

https://graph.microsoft.com/v1.0/groups
Stabilní rozhraní API
Obecně dostupná rozhraní API
Používá se pro produkční aplikace

Verzování – v1.0

Verzování: beta

beta

https://graph.microsoft.com/beta/groups

Náhled, experimentální funkce
Nestabilní, může přestat fungovat
Pouze pro testování, ne pro produkci

`

Verzování – Beta

Prostředek

Konkrétní data, se kterými pracujete.
Příklad:
- Uživatelé: Přístup k informacím o uživatelích
  - /users, /me
- Skupiny: Práce se skupinami
  - /groups
- Události: Načtení událostí kalendáře
  - /users/{userId}/events

Uživatelé

Skupiny

Parametry dotazu

Možnosti filtrování, řazení nebo výběru dat
Select:
- Výběr konkrétních polí
- $select=id,displayName
Filter:
- Filtrování dat
- $filter=startswith(displayName, 'John')
Top:
- Omezení počtu výsledků
- $top=5

Parametry dotazu – Select

Parametry dotazu – Filter

Parametry dotazu – Top

Hlavičky

Přenášejí metadata v HTTP požadavcích a odpovědích

Dva typy hlaviček: standardní a specifické pro API

Hlavičky

Standardní: Společné pro všechny požadavky
- Authorization: Bearer {access_token}
- Content-Type: application/json

Specifické pro API: Liší se podle API
- Retry-After: 30
- Location: https://graph.microsoft.com/operationStatus

Pojďme procvičovat!

Implementace zabezpečení Azure pro vývojáře

Preparing Video For Download...