Erweiterte Nutzung von Microsoft Graph

Azure-Sicherheit für Entwickler implementieren

Anushika Agarwal

Cloud Data Engineer

Analogie: Einkaufswege

Trag die Einkäufe in kleineren Gängen
Leichter, schneller, sicherer

Einkaufswege

Paginierung

Teilt große Ergebnisse in kleinere Seiten
Schnellere Antworten, weniger Timeouts

Wie holt man Folgeseiten?
- Antwort enthält einen Fortsetzungslink: `@odata.nextLink`

Paginierung

Beispiel: PeopleSphere mit Paginierung

Tausende Mitarbeitendendatensätze in handlichen Seiten geladen

Beispiel – PeopleSphere Paginierung

Serverseitige Paginierung

Dienst wählt eine Standardseitengröße
Client gibt keine Größe an
Beispiel
- GET /v1.0/users : (Standard) liefert 100 Elemente pro Seite

Serverseitige Paginierung

Clientseitige Paginierung

Client gibt die Elemente pro Seite an

Clientseitige Paginierung

Abfrageparameter für Paginierung

Abfrageparameter
- $top: Anzahl Elemente pro Seite.

$skip: Offset; beginne nach den ersten N Elementen

Beispiel: clientseitige Paginierung

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

Clientseitige Paginierung

Batching-Analogie: Online-Warenkorb

Mehrere Artikel in einem Warenkorb
Ein Checkout, ein Beleg

Analogie – Online-Warenkorb

Batching

Mehrere Graph-Anfragen in einem HTTP-Aufruf bündeln
Eine Nutzlast -> eine Antwort mit allen Ergebnissen
Vorteile
- Weniger Wege, geringere Latenz
- Ideal für Dashboards.
Limit
- Bis zu 20 Anfragen pro Batch

Batching

Batch-Request-Endpunkt

Endpunkt
- Methode: POST
- Endpunkt:https://graph.microsoft.com/v1.0/$batch
$batch statt einer konkreten Ressource wie users

Batch-Request-Endpunkt

Batch-Request-Body

Body ist ein JSON-Objekt
Enthält eine Eigenschaft: requests
requests ist ein Array (bis zu 20 Einträge)

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

Request-Elemente und Header

Jedes Request-Element benötigt
- id: eindeutiges Label zum Zuordnen der Antwort
- method: (GET/POST/PATCH/DELETE)
- url: relativer Pfad
Header: Content-Type: application/json

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

Batch-Antwort

Jeder Eintrag steht für eine Anfrage

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

Was jede Antwort enthält

Jedes Response-Element enthält
- id: passt zur ursprünglichen Anfrage
- status: HTTP-Status für dieses Element
  - 200: OK
  - 403: Verboten
- headers: (z. B. Content-Type)
- body: Daten- oder Fehlerobjekt

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

Lass uns üben!

Azure-Sicherheit für Entwickler implementieren