Seminar SCIM Spezifikation Deep Dive: Ressourcen, Endpunkte, Filter, PATCH, Bulk

Inhaltsverzeichnis

• Abstract
• Zielgruppe
• Voraussetzungen
• Lernziele
• Agenda
• Übungen
• Konformität und Interoperabilität
• Ergebnisartefakte
• Anschlussmodule

Abstract

Das Seminar vertieft die SCIM-2.0-Mechanik als Grundlage für robuste Implementierungen und Integrationen. Behandelt werden Ressourcen- und Schema-Definitionen, ServiceProviderConfig, ResourceTypes, Schemas sowie die Kerndomänen /Users und /Groups. Ein Schwerpunkt liegt auf Query-Verhalten (Filteroperatoren, Sortierung, Pagination), konsistentem Fehlerhandling und der korrekten Semantik von PATCH-Operationen. Optional wird Bulk für Massenänderungen behandelt, inklusive Grenzen, Partial Success und Auswirkungen auf Idempotenz. Praxislabs strukturieren die Spezifikationsinhalte in testbare Request-Suiten und helfen, typische Interop-Fallen systematisch zu vermeiden.

Zielgruppe

• Backend/API-Entwicklung und Integration
• IAM-Architektur und technische Projektleitung
• QA, Testautomatisierung, Plattformbetrieb

Voraussetzungen

• Seminar A empfohlen oder äquivalentes Grundwissen
• Sicherer Umgang mit HTTP/JSON

Lernziele

• SCIM-Endpoints und Ressourcenarten korrekt ableiten
• Filter- und Pagination-Verhalten spezifikationskonform implementieren oder testen
• PATCH korrekt modellieren und Edge-Cases vermeiden
• Fehlerbilder standardisiert und clientfreundlich ausprägen
• Bulk-Einsatz bewerten und sauber begrenzen

Agenda

• Spezifikationslandkarte und Compliance-Ziele
• Schemas, Attributeigenschaften, Mutability/Returned
• Filter, Sort, Pagination: Verhalten und Grenzen
• Query-Suite und Ergebnisvalidierung
• Endpunkte: /Users, /Groups, /Schemas, /ResourceTypes
• PATCH Semantik, Operationen, Pfade, Multi-Valued
• Bulk: Nutzen, Risiken, Partial Success
• Error Handling, scimType, Statuscodes
• PATCH/Bulk/Errors als Testsuite

Übungen

• Filter und Pagination als verifizierbare Spezifikation
  • Testdaten definieren: mindestens 20 User mit unterschiedlichen Attributen (emails, department, active)
  • Filterfälle formulieren: eq, co, sw, pr, gt/lt (wo sinnvoll), logische Operatoren
  • Erwartete Resultate als Prüfliste festhalten: totalResults, startIndex, itemsPerPage
  • Negative Tests ergänzen: ungültiger Filter, nicht unterstützter Operator, zu hohe page size
  • Akzeptanzkriterien: deterministische Sortierung, stabile Seiten, konsistente Fehlerstruktur
• PATCH korrekt einsetzen
  • Änderungsanforderungen in Operationen zerlegen: add, replace, remove
  • Pfade bestimmen: simple Attribute, Complex Types, Multi-Valued (z. B. emails[type eq "work"].value)
  • Konfliktfälle definieren: remove nicht vorhandenes Element, replace auf readOnly
  • Response-Verhalten festlegen: vollständige Ressource vs. Minimal Response (je nach Design)
  • Regressionstest ableiten: Patch-Reihenfolge, atomare Semantik, Validierung
• Bulk bewerten und begrenzen
  • Use Case prüfen: initiale Massenanlage vs. laufende Delta-Änderungen
  • Limits definieren: maxOperations, maxPayloadSize, maxErrors
  • Partial Success Verhalten festlegen: pro Operation status, detail
  • Idempotenzstrategie skizzieren: retries, request correlation, dedup
  • Entscheidung dokumentieren: Bulk aktivieren oder deaktivieren

Konformität und Interoperabilität

• Minimale SCIM-Featuresets definieren: „Must-Have“ für Client-Kompatibilität
• Konsistenzregeln: Identifier, Meta-Felder, Error Payload
• Interpretationsspielräume explizit dokumentieren (z. B. Response-Umfang)

Ergebnisartefakte

• SCIM Feature-Matrix (Client/Server)
• Testfallkatalog Query/PATCH/Bulk
• Referenz-Error-Schema (Textvorlage)

Anschlussmodule

• Server-Implementierung
• Client-Integration
• Test und Troubleshooting