Chat now with support
Chat mit Support

Identity Manager 9.1.3 - API-Entwicklungshandbuch

API Server-Web-Oberfläche aufrufen

Von der Web-Oberfläche des API Servers aus können Sie:

  • den API Server konfigurieren

  • die Swagger-Dokumentation Ihrer API aufrufen

  • das Web Portal für Betriebsunterstützung öffnen

  • alle installierten Webanwendungen aufrufen

Um die API Server Web-Oberfläche aufzurufen

  • Rufen Sie die Web-Adressse (URL) Ihres API Servers in einem Browser auf.

Verschlüsselung

Der API Server legt Daten auf fälschungssichere Weise verschlüsselt auf dem Client ab.

Das Zertifikat wird bei der Installation des API Servers auf dem IIS konfiguriert. Weitere Informationen zur Installation des API Servers finden Sie im One Identity Manager Installationshandbuch.

Weitere Informationen zur Konfiguration der Verschlüsselung finden Sie im One Identity Manager Konfigurationshandbuch für Webanwendungen.

Allgemeine Hinweise zur Programmierung eigener API-Methoden

  • Da der API Server zustandslos ist (stateless), speichern Sie API-Methoden ohne Client-spezifischen Zustand.
    Sie dürfen daher beispielsweise keine globalen Variablen definieren oder am Session-Objekt Zustandsdaten hinterlegen. Beim Neustart des API Server-Prozesses werden diese Werte nicht wiederhergestellt.

  • Nach dem Aktivieren der Routen dürfen Sie die Definitionsobjekte nicht mehr verändern.

  • Verwenden Sie asynchronen Code beim Definieren von API-Methoden. Damit wird die effiziente Nutzung der Server-Ressourcen unterstützt sowie die System-Performance unter Last verbessert. Die Methoden der API und des zugrundeliegenden Objektmodells setzen diese Asynchronität mithilfe des Task-based Asynchronous Pattern (TAP) um. Weitere Informationen zu TAP finden Sie unter https://docs.microsoft.com/de-de/dotnet/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.

  • Verwenden Sie beim Definieren von API-Methoden NICHT die Methode HttpContext.Current. Die aktuelle HTTP-Anforderung können Sie mit der statischen Methode QBM.CompositionApi.OwinRequestScopeContext.Context.Current abfragen.

  • Verwenden Sie beim Definieren von API-Methoden, die Daten verändern, NICHT die Methode GET.

Richtlinien und Konventionen

In diesem Kapitel finden Sie allgemeine Richtlinien und Konvention, die Sie beim Erstellen einer API beachten müssen.

Detaillierte Informationen zum Thema
Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen