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 eine eigene API zu implementieren
Erstellen Sie ein API-Plugin (siehe API-Plugins erstellen und bearbeiten).
Kompilieren Sie den entsprechenden TypeScript API-Client (siehe TypeScript API-Clients kompilieren).
Mithilfe von API-Plugins können Sie eigens entwickelte APIs implementieren und verwenden.
Voraussetzungen:
Sie verwenden eine Versionsverwaltung (beispielsweise Git).
Sie verwenden eine integrierte Entwicklungsumgebung (IDE).
Um ein API-Plugin zu erstellen
Starten Sie Ihre IDE (beispielsweise Visual Studio).
Erstellen Sie ein neues .NET Framework 4.8-Projekt mit dem Namen CCC.CompositionApi.Server.Plugin.
Fügen Sie Referenzen auf die folgenden DLL-Dateien aus dem Installationsverzeichnis von One Identity Manager hinzu:
QBM.CompositionApi.Server.dll
VI.Base.dll
VI.DB.dll
Erstellen Sie den API-Code.
Kompilieren Sie die DLL-Datei in Ihrer IDE.
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.
Starten Sie den API Server neu und stellen Sie sicher, dass die Datei CCC.CompositionApi.Server.Plugin.dll vorhanden ist.
Um ein bestehendes API-Plugin zu bearbeiten
Starten Sie Ihre IDE (beispielsweise Visual Studio).
Öffnen Sie das bestehende .NET Framework 4.8-Projekt.
Bearbeiten Sie den API-Code.
Kompilieren Sie die DLL-Datei in Ihrer IDE.
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.
Starten Sie den API Server neu und stellen Sie sicher, dass die Datei CCC.CompositionApi.Server.Plugin.dll vorhanden ist.
Nachdem Sie ein API-Plugin erstellt haben, müssen Sie einen entsprechenden TypeScript API-Client kompilieren.
Um einen TypeScript API-Client zu kompilieren
Öffnen Sie ein Kommandozeilenprogramm.
Führen Sie folgenden Befehl aus:
imxclient compile-api -N -W /copyapi imx-api-ccc.tgz /packagename imx-api-ccc
Das Dialogfenster zum Auswählen der Datenbankverbindung öffnet sich.
Im Dialogfenster nehmen Sie eine der folgenden Aktionen vor:
Um eine bestehende Verbindung zur One Identity Manager-Datenbank zu verwenden, wählen Sie aus der Auswahlliste Datenbankverbindung auswählen die entsprechende Verbindung aus.
- ODER -
Um eine neue Verbindung zur One Identity Manager-Datenbank zu verwenden, klicken Sie Neue Verbindung erstellen und geben Sie eine neue Verbindung an.
Unter Authentifizierungsverfahren geben Sie das Verfahren und die Anmeldedaten an, mit denen Sie sich an der Datenbank anmelden möchten.
Klicken Sie Anmelden.
Importieren Sie das npm-Paket imx-api-ccc in Ihre TypeScript-Anwendung.
Mithilfe des ImxClient-Kommandozeilenprogramms können Sie verschiedene Funktionen zum Verwalten des API Servers und von Dateien in der Kommandozeile ausführen.
© ALL RIGHTS RESERVED. Termini di utilizzo Privacy Cookie Preference Center
