Chat now with support
Chat mit Support

Identity Manager 9.2.1 - API-Entwicklungshandbuch

Über dieses Handbuch Grundlagen der API-Entwicklung Beispiele und Hilfe – Software Development Kit Eigene APIs implementieren ImxClient-Kommandozeilenprogramm

install-apiserver

Installiert einen API Server auf dem lokalen Internet Information Services (IIS).

Parameter

Anmeldeparameter:

  • /conn <Name der Datenbankverbindung>: Legt die Datenbank fest, mit der Sie sich verbinden möchten.

  • /dialog <Name der Dialog-Authentifikation>: Legt die Dialog-Authentifikation fest.

Pflichtparameter:

  • /app <Anwendungsname>: Legt fest, welcher Name für die Anwendung verwendet werden soll (zum Beispiel in der Titelzeile des Browsers).

  • /sessioncert <Zertifikatsfingerabdruck>: Legt fest, welches (installierte) Zertifikat für die Erzeugung und Überprüfung von Session-Token verwendet werden soll.

    TIPP: Um den Fingerabdruck eines Zertifikats zu erhalten, können Sie beispielsweise die Windows-Funktion Computerzertifikate verwalten verwenden und den Fingerabdruck über die Detailinformationen des Zertifikats ermitteln.

Optionale Parameter:

  • /conndialog <Option>: Legt fest, ob ein Anmeldedialog für die Datenbankverbindung angezeigt werden soll. Die folgenden Optionen sind möglich:

    • off: Es wird kein Anmeldedialog angezeigt. Wenn keine Verbindung zur Datenbank besteht, wird versucht eine Verbindung herzustellen.

    • show: Ein Anmeldedialog wird angezeigt (auch wenn bereits eine Verbindung zur Datenbank besteht) und die Verbindung wird durch die neue ersetzt.

    • fallback: (Standardwert) Wenn eine Verbindung zur Datenbank besteht, wird diese verwendet. Wenn keine Verbindung zur Datenbank besteht, wird versucht eine Verbindung herzustellen.

  • -u: Erlaubt unsichere HTTP-Verbindungen zur API Server-Webseite. Standardmäßig kann die API Server-Webseite nur über eine verschlüsselte Verbindung aufgerufen werden.

  • /site <Seitenname>: Legt die Website auf dem IIS fest, unter der die Webanwendung installiert werden soll. Wenn Sie hier nichts angeben, wird die Website automatisch ermittelt (normalerweise Default Web Site).

  • /searchservice <URL>: Legt die URL des Anwendungsservers fest, auf dem der Suchdienst gehostet wird, der verwendet werden soll.

    HINWEIS: Wenn Sie die Volltextsuche verwenden möchten, müssen Sie einen Anwendungsserver angeben. Sie können den Anwendungsserver auch zu einem späteren Zeitpunkt in die Konfigurationsdatei eintragen.

Verwandte Themen

push-files

Speichert Dateien, die Sie lokal geändert haben, wieder in der Datenbank.

Parameter

Anmeldeparameter:

  • /conn <Name der Datenbankverbindung>: Legt die Datenbank fest, mit der Sie sich verbinden möchten.

  • /dialog <Name der Dialog-Authentifikation>: Legt die Dialog-Authentifikation fest.

Pflichtparameter:

  • /targets <Ziel1;Ziel2;...>: Legt fest, welche Maschinenrollen verwendet werden sollen.

Optionale Parameter:

  • /conndialog <Option>: Legt fest, ob ein Anmeldedialog für die Datenbankverbindung angezeigt werden soll. Die folgenden Optionen sind möglich:

    • off: Es wird kein Anmeldedialog angezeigt. Wenn keine Verbindung zur Datenbank besteht, wird versucht eine Verbindung herzustellen.

    • show: Ein Anmeldedialog wird angezeigt (auch wenn bereits eine Verbindung zur Datenbank besteht) und die Verbindung wird durch die neue ersetzt.

    • fallback: (Standardwert) Wenn eine Verbindung zur Datenbank besteht, wird diese verwendet. Wenn keine Verbindung zur Datenbank besteht, wird versucht eine Verbindung herzustellen.

  • /factory <Name des Zielsystems>: Legt das Zielsystem für die Verbindung fest. Geben Sie diesen Parameter an, wenn Sie eine Verbindung zum Anwendungsserver aufbauen möchten. Beispiel: QBM.AppServer.Client.ServiceClientFactory, QBM.AppServer.Client

  • /workspace <Pfad zum Ordner>: Legt das Arbeitsverzeichnis fest, in dem die Dateien liegen, die geändert wurden und jetzt in der Datenbank gespeichert werden sollen. Wenn Sie hier nichts angeben, wird das aktuelle Verzeichnis verwendet.

  • /tag <uid>: Legt fest, auf welches Änderungskennzeichen die Änderungen gebucht werden. Weitere Informationen zu Änderungskennzeichen finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.

  • /add <Datei1;Datei2;...>: Legt fest, welche neuen Dateien der Datenbank hinzugefügt werden sollen. Verwenden Sie relative Pfade.

  • /del <Datei1;Datei2;...>: Legt fest, welche Dateien aus der Datenbank gelöscht werden sollen. Verwenden Sie relative Pfade.

  • -C: Verhindert das Speichern von geänderten Dateien und speichert nur neue Dateien und löscht Dateien in der Datenbank.

Verwandte Themen

repl

Startet das ImxClient-Kommandozeilen-Programm im sogenannten REPL-Modus.

In diesem Modus werden in einer Endlosschleife folgende Aktionen ausgeführt:

  • Lesen von Kommandos von stdin

  • Weiterleiten der Befehle an das passende Plugin

  • Ausgeben der Ergebnisse der Verarbeitung nach stdout

Verwandte Themen

run-apiserver

Startet oder stoppt einen lokal gehosteten API Server.

Diese Kommando benötigt eine Datenbankverbindung.

Parameter

Anmeldeparameter:

  • /conn <Name der Datenbankverbindung>: Legt die Datenbank fest, mit der Sie sich verbinden möchten.

  • /dialog <Name der Dialog-Authentifikation>: Legt die Dialog-Authentifikation fest.

Optionale Parameter:

  • /conndialog <Option>: Legt fest, ob ein Anmeldedialog für die Datenbankverbindung angezeigt werden soll. Die folgenden Optionen sind möglich:

    • off: Es wird kein Anmeldedialog angezeigt. Wenn keine Verbindung zur Datenbank besteht, wird versucht eine Verbindung herzustellen.

    • show: Ein Anmeldedialog wird angezeigt (auch wenn bereits eine Verbindung zur Datenbank besteht) und die Verbindung wird durch die neue ersetzt.

    • fallback: (Standardwert) Wenn eine Verbindung zur Datenbank besteht, wird diese verwendet. Wenn keine Verbindung zur Datenbank besteht, wird versucht eine Verbindung herzustellen.

  • /factory <Name des Zielsystems>: Legt das Zielsystem für die Verbindung fest. Geben Sie diesen Parameter an, wenn Sie eine Verbindung zum Anwendungsserver aufbauen möchten. Beispiel: QBM.AppServer.Client.ServiceClientFactory, QBM.AppServer.Client

  • -S: Stoppt den API Server.

  • /baseaddress <Basis-URL mit Port-Angabe>: Legt die Basis-URL und den Port der Webanwendung fest, unter der der API Server Verbindungen entgegennimmt.

    Beispiel 

    /baseaddress http://localhost:8184

  • /baseurl <Basis-URL>: Legt die Basis-URL der Webanwendung fest.

    Beispiel 

    /baseaddress http://localhost

  • /plugin <Dateiname1,Dateiname2>: Lädt zusätzliche Plugins aus den angegebenen Dateien.

  • /htmldir <Verzeichnis>: Legt fest, aus welchem Verzeichnis zusätzliche HTML-Anwendungsdateien und Plugins geladen werden sollen. Diese Einstellung ist für Entwicklungsszenarien gedacht.

    Beispiel 

    /htmldir C:example\imxweb\cpl

    Das Plugin cpl wird aus dem Ordner C:example\imxweb\cpl geladen statt aus den Standardquellen.

  • -T: Fragt den Status des laufenden API Servers ab.

  • -B: Sperrt die Konsole.

Verwandte Themen
Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen