지금 지원 담당자와 채팅
지원 담당자와 채팅

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

API-Konfiguration

In diesem Kapitel finden Sie Informationen zur Konfiguration der API.

Detaillierte Informationen zum Thema

Primäre Authentifizierung mit Single Sign-on konfigurieren

Sie können für API-Projekte die Authentifizierung mit Single Sign-on über das Administration Portal konfigurieren. In diesem Fall ist keine eigene Anfrage an die Methode imx/login erforderlich.

HINWEIS: Konfigurieren Sie die Authentifizierung für das Web Portal für Betriebsunterstützung über das entsprechende API-Projekt (siehe Authentifizierung für das Web Portal für Betriebsunterstützung konfigurieren).

Um die Authentifizierung mit Single Sign-on zu konfigurieren

  1. Rufen Sie in Ihrem Web-Browser die Adresse Ihres API Servers auf.

  2. Auf der Übersichtsseite klicken Sie Administration Portal.

  3. Auf der Anmeldeseite wählen Sie aus, mit welcher Authentifizierungsmethode Sie sich am Administration Portal anmelden möchten.

  4. Geben Sie Ihren Benutzernamen und Ihr Passwort ein.

  5. Klicken Sie Anmelden.

  6. In der Navigation klicken Sie Konfiguration.

  7. Auf der Seite Konfiguration wählen Sie in der Auswahlliste Konfiguration für das folgende API-Projekt anzeigen das API-Projekt aus, für das Sie die Authentifizierung mit Single Sign-on konfigurieren möchten.

  8. Im Suchfeld geben Sie Single-Sign-on-Authentifizierungsmodule ein.

  9. Klappen Sie den Konfigurationsschlüssel Single-Sign-on-Authentifizierungsmodule auf.

  10. Klicken Sie Neu.

  11. In der Auswahlliste wählen Sie das Authentifizierungsmodul aus, das Sie verwenden möchten.

    TIPP: Sie können weitere Authentifizierungsmodule festlegen. Klicken Sie dazu Neu.

  12. Klicken Sie Übernehmen.

  13. Nehmen Sie eine der folgenden Aktionen vor:

    • Wenn Sie die Änderungen nur lokal übernehmen möchten, klicken Sie Lokal übernehmen.

    • Wenn Sie die Änderungen global übernehmen möchten, klicken Sie Global übernehmen.

  14. Klicken Sie Übernehmen.

Detaillierte Informationen zum Thema

Authentifizierung für das Web Portal für Betriebsunterstützung konfigurieren

Mithilfe des Knotens Authentifizierung im Definitionsbaumfenster des API Designers legen Sie fest, wie sich Clients am Web Portal für Betriebsunterstützung anmelden können.

Es gibt drei Authentifizierungsoptionen, die Sie konfigurieren können:

  • Standard: Es sind nur die Authentifizierungsmethoden zugelassen, die Sie hier auflisten. Für diese Methode können Sie zudem Single Sign-on aktivieren.

  • Alle manuellen Module zulassen: Es sind alle manuellen Authentifizierungsmodule zugelassen, sofern diese für das gewählte Produkt aktiviert sind. Für diese Methode können Sie zudem Single Sign-on aktivieren.

  • Festgelegte Anmeldedaten: Diese Einstellung ermöglicht eine Anmeldung mit fest hinterlegten Anmeldedaten an der API. In diesem Fall müssen Sie Anmeldedaten in der web.config-Datei jedes API Servers hinterlegen.

Um die zulässigen manuellen Authentifizierungsmöglichkeiten selber festzulegen

  1. Starten Sie das Programm API Designer.

  2. In der Menüleiste klicken Sie Ansicht > Navigation.

  3. In der Navigation klicken Sie API-Projekte.

  4. In der Baumstruktur doppelklicken Sie das API-Projekt, das Sie bearbeiten möchten.

  5. Im Definitionsbaumfenster klicken Sie den Knoten (Authentifizierung).

  6. In der Menüleiste klicken Sie Ansicht > Knotenbearbeitung.

  7. Im Knotenbearbeitungsfenster führen Sie die folgenden Aktionen aus:

    1. In der Auswahlliste Authentifizierungstyp wählen Sie Standard.

    2. Im Eingabefeld Control-ID geben Sie eine eindeutige ID für den Knoten ein.

    3. (Optional) Im Eingabefeld Authentifizierungseigenschaften geben Sie Eigenschaften der Authentifizierung ein. Weitere Informationen zu den Authentifizierungsmodulen erhalten Sie im One Identity Manager Konfigurationshandbuch.

    4. (Optional) Wenn Berechtigungen für Benutzer über ein Produkt gesteuert werden, aktivieren Sie die Option Produkt und wählen Sie in der Auswahlliste das entsprechende Produkt aus.

  8. Im Definitionsbaumfenster klappen Sie den Knoten (Authentifizierung) aus.

  9. Rechtsklicken Sie den Knoten (Manuelle Authentifizierungsmodule).

  10. Im Kontextmenü klicken Sie Authentifizierungsmodul.

    Der Knoten Authentifizierungsmodul wird dem Knoten untergeordnet.

  11. Klicken Sie den Knoten Authentifizierungsmodul.

  12. Im Knotenbearbeitungsfenster wählen Sie in der Auswahlliste Name das gewünschte Authentifizierungsmodul aus. Weitere Informationen zu den Authentifizierungsmodulen erhalten Sie im One Identity Manager Konfigurationshandbuch.

  13. Im Eingabefeld Control-ID geben Sie eine eindeutige ID für den Knoten ein.

  14. Wiederholen Sie die Schritte 8 bis 12, bis Sie alle gewünschten Authentifizierungsmethoden festgelegt haben.

  15. In der Menüleiste klicken Sie (Speichern).

Um alle manuellen Authentifizierungsmöglichkeiten zuzulassen

  1. Starten Sie das Programm API Designer.

  2. In der Menüleiste klicken Sie Ansicht > Navigation.

  3. In der Navigation klicken Sie (API-Projekte).

  4. In der Baumstruktur doppelklicken Sie das API-Projekt, das Sie bearbeiten möchten.

  5. Im Definitionsbaumfenster klicken Sie den Knoten (Authentifizierung).

  6. In der Menüleiste klicken Sie Ansicht > Knotenbearbeitung.

  7. Im Knotenbearbeitungsfenster führen Sie die folgenden Aktionen aus:

    1. In der Auswahlliste Authentifizierungstyp wählen Sie Alle manuellen Module zulassen.

    2. Im Eingabefeld Control-ID geben Sie eine eindeutige ID für den Knoten ein.

    3. (Optional) Im Eingabefeld Authentifizierungseigenschaftengeben Sie Eigenschaften der Authentifizierung ein.

    4. (Optional) Aktivieren Sie die Option Produkt und wählen Sie in der Auswahlliste das Produkt aus.

  8. In der Menüleiste klicken Sie (Speichern).

Um Single Sign-on zuzulassen

  1. Starten Sie das Programm API Designer.

  2. In der Menüleiste klicken Sie Ansicht > Navigation.

  3. In der Navigation klicken Sie (API-Projekte).

  4. In der Baumstruktur doppelklicken Sie das API-Projekt, das Sie bearbeiten möchten.

  5. Im Definitionsbaumfenster klappen Sie den Knoten (Authentifizierung) aus.

  6. Rechtsklicken Sie den Knoten (Authentifizierungsmodule für Single Sign-on).

    HINWEIS: Dieser Knoten steht Ihnen nur zur Verfügung, wenn Sie die manuellen Authentifizierungsmöglichkeiten selber festgelegt haben oder wenn Sie alle manuellen Authentifizierungsmöglichkeiten zulassen.

  7. Im Kontextmenü klicken Sie Authentifizierungsmodul.

    Der Knoten Authentifizierungsmodul wird dem Knoten untergeordnet.

  8. Klicken Sie den Knoten Authentifizierungsmodul.

  9. In der Menüleiste klicken Sie Ansicht > Knotenbearbeitung.

  10. Im Knotenbearbeitungsfenster wählen Sie in der Auswahlliste Name das gewünschte Authentifizierungsmodul aus. Weitere Informationen zu den Authentifizierungsmodulen erhalten Sie im One Identity Manager Konfigurationshandbuch.

  11. In der Menüleiste klicken Sie (Speichern).

Anmeldung mit hinterlegten Anmeldedaten

Um die Anmeldung mit hinterlegten Anmeldedaten zuzulassen, führen Sie zwei Schritte aus:

  1. Hinterlegen Sie in der Datei web.config jedes API Servers die Anmeldedaten der Benutzer, die Zugriff erhalten sollen.

  2. Konfigurieren Sie die Authentifizierung im API Designer am API-Projekt.

Um Anmeldedaten im API Server zu hinterlegen

  1. Verbinden Sie sich auf Ihren API Server.

  2. Öffnen Sie die Datei web.config in einem Texteditor.

  3. (Optional) Falls die Datei verschlüsselt ist, entschlüsseln Sie die Datei.

  4. Im Abschnitt <connectionStrings> fügen Sie folgenden Eintrag hinzu:

    <add name="sub:<NAME>" connectionString="Module=DialogUser;User=<BENUTZER>;(Password)Password=<KENNWORT>" />

    • <NAME> steht für den Namen/Bezeichner des API-Projekts

    • <BENUTZER> steht für den Anmeldenamen des Benutzers

    • <KENNWORT> steht für das Kennwort des Benutzers

  5. Speichern Sie Ihre Änderungen an der Datei.

  6. (Optional) Verschlüsseln Sie die Datei.

Um die Anmeldung mit hinterlegten Anmeldedaten am API-Projekt zu konfigurieren

  1. Starten Sie das Programm API Designer.

  2. In der Menüleiste klicken Sie Ansicht > Navigation.

  3. In der Navigation klicken Sie (API-Projekte).

  4. In der Baumstruktur doppelklicken Sie das API-Projekt, das Sie bearbeiten möchten.

  5. Im Definitionsbaumfenster klicken Sie den Knoten (Authentifizierung).

  6. In der Menüleiste klicken Sie Ansicht > Knotenbearbeitung.

  7. Im Knotenbearbeitungsfenster führen Sie die folgenden Aktionen aus:

    1. In der Auswahlliste Authentifizierungstyp wählen Sie Festgelegte Anmeldedaten.

    2. Im Eingabefeld Control-ID geben Sie eine eindeutige ID für den Knoten ein.

    3. (Optional) Im Eingabefeld Authentifizierungseigenschaftengeben Sie Eigenschaften der Authentifizierung ein.

    4. (Optional) Aktivieren Sie die Option Produkt und wählen Sie in der Auswahlliste das Produkt aus.

  8. In der Menüleiste klicken Sie (Speichern).

Verwandte Themen

Verschlüsselung ändern

Sie können die verwendete Verschlüsselung von Daten ändern, indem Sie ein anderes Verschlüsselungszertifikat verwenden.

Um das Verschlüsselungszertifikat zu ändern

  1. Verbinden Sie sich auf Ihren API Server.

  2. Öffnen Sie die Datei web.config in einem Texteditor.

  3. (Optional) Falls die Datei verschlüsselt ist, entschlüsseln Sie die Datei.

  4. Ändern Sie den Wert der Eigenschaft certificatethumbprint auf den Thumbprint des Zertfikats, das Sie verwenden möchten.

  5. Speichern Sie Ihre Änderungen an der Datei.

  6. (Optional) Verschlüsseln Sie die Datei.

관련 문서

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택