Avancerad användning av Microsoft Graph

Implementera Azure-säkerhet för utvecklare

Anushika Agarwal

Cloud Data Engineer

Analogi: matvaruärenden

Bär matvaror i fler men lättare omgångar
Lättare, snabbare och säkrare

Grocery trips

Paginering

Delar upp stora resultat i mindre sidor
Snabbare svar och färre timeout-fel

Hur hämtas nästa sida?
- Svaret innehåller en fortsättningslänk: `@odata.nextLink`

Pagination

Exempel: PeopleSphere med paginering

Tusentals anställdas poster hämtas i hanterbara sidor

Example - PeopleSphere Pagination

Serverpaginering

Tjänsten väljer en standardsidstorlek
Klienten anger ingen storlek
Exempel
- GET /v1.0/users : (standard) Returnerar 100 poster per sida

Server-Side Pagination

Klientpaginering

Klienten anger antal poster per sida

Client-Side Pagination

Frågeparametrar för paginering

Frågeparametrar
- $top: antal poster per sida.

$skip: förskjutning; hoppa över de första N posterna

Exempel på klientpaginering

Exempel:
- https://graph.microsoft.com/v1.0/groups?$top=2

Client-Side Pagination

Batchanalogi: kundvagnen vid näthandel

Flera varor i en korg
En betalning, ett kvitto

Analogy - Online shopping cart

Batching

Kombinera flera Graph-förfrågningar i ett HTTP-anrop
En nyttolast -> ett svar med alla resultat
Fördelar
- Färre anrop, lägre latens
- Idealiskt för dashboards.
Begränsning
- Upp till 20 förfrågningar per batch

Batching

Slutpunkt för batchförfrågan

Slutpunkt
- Metod: POST
- Slutpunkt:https://graph.microsoft.com/v1.0/$batch
$batch i stället för en specifik resurs som users

Batch request endpoint

Innehåll i batchförfrågan

Innehållet är ett JSON-objekt
Innehåller en egenskap: requests
requests är en array (upp till 20 poster)

{ "requests": 
   [ {
      "id": "1",
      "method": "GET",
      "url": "/me/memberOf"
    },
    {
      "id": "2",
      "method": "GET",
      "url": "/me/planner/tasks"
    } ]
}

Förfrågningsobjekt och headers

Varje förfrågningsobjekt behöver
- id: unik etikett för att matcha svaret
- method: (GET/POST/PATCH/DELETE)
- url: relativ sökväg
Headers: Content-Type: application/json

{ "requests": 
   [ {
      "id": "1",
      "method": "GET",
      "url": "/me/memberOf"
    },
    {
      "id": "2",
      "method": "GET",
      "url": "/me/planner/tasks"
    } ]
}

Batchsvar

Varje post representerar en förfrågan

{
  "responses": [
    {  "id": "1", 
        "status": 200, 
        "body": { "value": [/* ... */]}},
    { 
        "id": "2", 
        "status": 403, 
        "body": { "error": [/* ... */]}}
  ]
}

Vad varje svar innehåller

Varje svarsobjekt innehåller
- id: matchar den ursprungliga förfrågan
- status: HTTP-status för det objektet
  - 200: OK
  - 403: Förbjuden
- headers: (t.ex. Content-Type)
- body: data eller felobjekt

{
  "responses": [
    {  "id": "1", 
        "status": 200, 
        "body": { "value": [/* ... */]}},
    { 
        "id": "2", 
        "status": 403, 
        "body": { "error": [/* ... */]}}
  ]
}

Nu kör vi en övning!

Implementera Azure-säkerhet för utvecklare