Tchater maintenant avec le support
Tchattez avec un ingénieur du support

Identity Manager 8.2.1 - API-Entwicklungshandbuch

Grundlagen der API-Entwicklung Beispiele und Hilfe – Software Development Kit API-Konfiguration Eigene APIs implementieren Der API Designer Schnellstart – Eine API mit dem API Designer erstellen Arbeiten mit dem API Designer
API Designer starten Projekttypen Benutzeroberfläche Globale Einstellungen Datenbankobjekte Änderungen kennzeichnen Suchen und Ersetzen Mehrsprachige Texte Datenbankabfragen verwalten Tabreiter verwalten Layouts verwalten Änderungshistorie anzeigen (Befehlsliste) Lesezeichen API kompilieren Versionen verwalten (Kompilierungszweige) API testen C#-Projekte mit dem API Designer verbinden
API-Projekte API-Dateien ImxClient-Kommandozeilenprogramm

TypeScript API-Clients kompilieren

Nachdem Sie ein API-Plugin erstellt haben, müssen Sie einen entsprechenden TypeScript API-Client kompilieren.

Um einen TypeScript API-Client zu kompilieren

  1. Öffnen Sie ein Kommandozeilenprogramm.

  2. 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.

  3. 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.

  4. Unter Authentifizierungsverfahren geben Sie das Verfahren und die Anmeldedaten an, mit denen Sie sich an der Datenbank anmelden möchten.

  5. Klicken Sie Anmelden.

  6. Importieren Sie das npm-Paket imx-api-ccc in Ihre TypeScript-Anwendung.

Der API Designer

Mit dem API Designer können Sie auf schnellstem Wege eine REST-API (Representational State Transfer Application Programming Interface) erstellen, dokumentieren, kompilieren und veröffentlichen. Diese API basiert auf der OpenAPI-Spezifikation und dem One Identity Manager-Datenbankmodell.

Vorteile des API Designers auf einem Blick:

  • Einfache und schnelle Bedienung

  • Die fertige API "versteht" das One Identity Manager-Datenbankmodell.

  • Änderungen an der API sind nachvollziehbar.

  • Unterstützt Prinzipien eines guten API-Designs

  • OpenAPI-Unterstützung: APIs, die Sie mithilfe des API Designers erstellen, basieren grundsätzlich auf der OpenAPI-Spezifikation. Dies ermöglicht Ihnen auf weitere Hilfsmittel zuzugreifen:

    • Swagger: Verwenden Sie Swagger, um Code, Dokumentation und Testfälle zu erstellen.
    • Postman: Verwenden Sie Postman, um die verschiedenen API-Methoden Ihrer API zu testen.

Schnellstart – Eine API mit dem API Designer erstellen

HINWEIS: One Identity empfiehlt APIs nicht mithilfe des API Designers zu erstellen und zu implementieren, sondern stattdessen als API-Plugin (siehe Eigene APIs implementieren).

Nachfolgend finden Sie eine grobe Auflistung der Schritte, die Sie im API Designer durchführen müssen, um eine API zu erstellen.

  1. Starten Sie den API Designer.

  2. Erstellen Sie API-Dateien (in diesen können Sie beispielsweise eine API-Methode definieren).

  3. Erstellen Sie ein API-Projekt oder bearbeiten Sie ein bestehendes (beispielsweise von One Identity mitgeliefertes) Projekt, um die bereits vorhandenen Funktionen zu nutzen und Ihren eigenen Wünschen anzupassen.

  4. Konfigurieren Sie die Authentifizierung des API-Projektes (beispielsweise Single Sign-on).

    HINWEIS: Wenn Sie ein bestehendes von One Identity mitgeliefertes API-Projekt bearbeiten, können Sie die Authentifizierung nicht mehr ändern.

  5. Weisen Sie die erstellten API-Dateien dem API-Projekt zu.

  6. Testen Sie die API.

  7. Kompilieren Sie die API.

  8. Übertragen Sie die Änderungen in die Datenbank.

Verwandte Themen

Arbeiten mit dem API Designer

In diesem Kapitel finden Sie Informationen zur allgemeinen Arbeit mit dem API Designer.

Erfahren Sie hier unter anderem:

Documents connexes

The document was helpful.

Sélectionner une évaluation

I easily found the information I needed.

Sélectionner une évaluation