Eigene APIs implementieren
Eigene APIs implementieren
Um eigene APIs zu implementieren, können Sie API-Plugins erstellen.
Der API Server lädt alle DLLs, auf die das Namensschema *.CompositionApi.Server.PlugIn.dll passen, und stellt die darin enthaltenen API-Definitionen zur Verfügung.
Um Ihre eigene APIs zu implementieren, stehen Ihnen folgende Möglichkeiten zur Verfügung:
Detaillierte Informationen zum Thema
API-Plugins verwalten
Mithilfe von API-Plugins können Sie eigens entwickelte APIs und API-Projekte implementieren und verwenden.
Voraussetzungen:
Detaillierte Informationen zum Thema
API-Plugins erstellen
Um eigens entwickelte APIs und API-Projekte zu implementieren, können Sie API-Plugins erstellen.
Um ein API-Plugin zu erstellen
-
Starten Sie Ihre IDE (beispielsweise Visual Studio).
-
Erstellen Sie ein neues .NET Framework 4.8-Projekt mit einem Namen nach dem folgenden Format: <Name des Projekts>.CompositionApi.Server.Plugin.
-
Fügen Sie Referenzen auf die folgenden DLL-Dateien aus dem One Identity Manager-Installationsverzeichnis hinzu:
-
Erstellen Sie den API-Code.
-
Kompilieren Sie die DLL-Datei in Ihrer IDE.
-
Kopieren Sie die DLL-Datei in den Unterordner bin Ihrer IIS-Installation.
-
Importieren Sie die DLL-Datei mithilfe des Software Loaders in Ihre One Identity Manager-Datenbank und weisen Sie sie der Maschinenrolle Business API Server zu. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
-
Kopieren Sie die DLL-Datei in das One Identity Manager-Installationsverzeichnis.
-
Importieren Sie die DLL-Datei mithilfe des Software Loaders in Ihre One Identity Manager-Datenbank und weisen Sie sie der Maschinenrolle Development and Testing zu. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
-
Starten Sie den API Server neu und stellen Sie sicher, dass die Datei <Name des Projekts>.CompositionApi.Server.Plugin im Ordner bin des API Server-Installationsverzeichnisses vorhanden ist.
-
Kompilieren Sie den entsprechenden TypeScript API-Client (siehe TypeScript API-Clients kompilieren).
API-Plugins bearbeiten
Sie können bestehende API-Plugins bearbeiten.
Um ein bestehendes API-Plugin zu bearbeiten
-
Starten Sie Ihre IDE (beispielsweise Visual Studio).
-
Öffnen Sie ein bestehendes .NET Framework 4.8-Projekt.
-
Bearbeiten Sie den API-Code.
-
Kompilieren Sie die DLL-Datei in Ihrer IDE.
-
Kopieren Sie die DLL-Datei in den Unterordner bin Ihrer IIS-Installation.
-
Importieren Sie die DLL-Datei mithilfe des Software Loaders in Ihre One Identity Manager-Datenbank. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
-
Kopieren Sie die DLL-Datei in das One Identity Manager-Installationsverzeichnis.
-
Importieren Sie die DLL-Datei mithilfe des Software Loaders in Ihre One Identity Manager-Datenbank. Weitere Informationen zum Importieren von Dateien mit dem Software Loader finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
-
Starten Sie den API Server neu und stellen Sie sicher, dass die Datei <Name des Projekts>.CompositionApi.Server.Plugin im Ordner bin des API Server-Installationsverzeichnisses vorhanden ist.
-
Kompilieren Sie den entsprechenden TypeScript API-Client (siehe TypeScript API-Clients kompilieren).
