Oracle Cloud Infrastructure - Dokumentation

Schnellstart

Beginnen Sie schnell mit der REST-API für Identitätsdomains, indem Sie die Voraussetzungen erfüllen, curl installieren und die Autorisierung einrichten, um Ihre Identitätsdomainressourcen wie Benutzer, Gruppen und Anwendungen zu verwalten.

Voraussetzungen

  1. Oracle Cloud-Abonnement erwerben: Siehe Oracle Cloud-Abonnement erwerben.
  2. Bestellung aktivieren: Richten Sie Ihr Konto ein oder aktivieren Sie Ihre Bestellung. Informationen hierzu finden Sie unter Bestellung über die Willkommens-Mail aktivieren in Oracle Cloud-Abonnement kaufen.
  3. Rufen Sie die entsprechenden Accountzugangsdaten und die Autorisierung für den Zugriff auf Identitätsdomain-APIs von Ihrem Identitätsdomainadministrator ab:

    • So melden Sie sich bei Ihrer Identitätsdomain an Wenden Sie sich an den Identitätsdomainadministrator, um Ihren Benutzernamen, Ihr Kennwort und Ihren Identitätsdomainnamen abzurufen.

    • So verwenden Sie die API ohne einen Benutzeraccount. Administratoren können die Identitätsdomain-API ohne einen Benutzeraccount in der Identitätsdomain verwenden. Um die Identitätsdomain-API ohne einen Benutzeraccount zu verwenden, fordern Sie eine Client-ID und ein Client Secret vom Identitätsdomainadministrator an.

Schritt 1: Bei Ihrer Identitätsdomain anmelden

Nachdem Sie Ihren Account aktiviert haben, erhalten Sie Anmeldedaten und einen Link zur Homepage Ihrer Identitätsdomain. Klicken Sie auf den Link in der E-Mail, und geben Sie die angegebenen Anmeldedaten ein. Die Homepage der Identitätsdomain wird angezeigt. Siehe Konsolenanmeldung.

Schritt 2: cURL installieren

Die Beispiele in diesem Dokument verwenden das Befehlszeilentool cURL, um zu demonstrieren, wie Sie auf die REST-API für Identitätsdomains zugreifen.

Um eine sichere Verbindung zum Server herzustellen, müssen Sie eine cURL-Version installieren, die SSL unterstützt, und eine Zertifikatsdatei oder ein SSL-Zertifikats-Bundle (CA) für die Authentifizierung gegen das Verisign-CA-Zertifikat bereitstellen. Weitere Informationen:

Das folgende Verfahren zeigt, wie Sie cURL auf einem Windows 64-Bit-System installieren.

  1. Navigieren Sie in einem Browser zur cURL-Homepage unter http://curl.haxx.se/download.html.

  2. Suchen Sie auf der Seite "cURL-Versionen und -Downloads" die SSL-fähige Version, die Ihrem Betriebssystem entspricht, und klicken Sie dann auf den Link, um die ZIP-Datei herunterzuladen.

  3. Installieren Sie die Software.

  4. Navigieren Sie zur Seite "cURL-CA-Zertifikate" unter http://curl.haxx.se/docs/caextract.html, und laden Sie das Zertifikats-Bundle CA-bundle.crt für die SSL-Zertifizierungsstelle (CA) in den Ordner herunter, in dem Sie cURL installiert haben.

  5. Legen Sie die cURL-Umgebung fest:

    1. Öffnen Sie ein Befehlsfenster.

    2. Navigieren Sie zu dem Verzeichnis, in dem Sie cURL installiert haben.

    3. Setzen Sie die cURL-Umgebungsvariable (CURL_CA_BUNDLE) auf den Speicherort des SSLCA-Zertifikats-Bundles. Beispiel: C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt.

Schritt 3: Ressourcen-URL-Format verstehen

Sie greifen über eine URL, die den REST-Endpunkt, die Ressource, auf die Sie zugreifen möchten, und alle Abfrageparameter, die Sie in eine Anforderung aufnehmen möchten, auf die Identitätsdomains-REST-API zu.

Der grundlegende Endpunkt für die REST-API für Identitätsdomains ist:

https://<domainURL>/admin/v1/

Einzelheiten zum Erstellen dieser URLs finden Sie unter Anforderungen senden.

Schritt 4: Autorisierung einrichten

Sie müssen das Zugriffstoken generieren, mit dem Sie Anforderungen autorisieren können, die Sie an die REST-API für Identitätsdomains senden. Siehe Autorisierung mit der API verwalten.

Jetzt können Sie Anforderungen mit cURL an eine Identitätsdomain senden.

Schritt 5: Identitätsdomainressourcen verwalten

Mit der REST-API können Sie allgemeine Identitätsdomainkonfigurationen und -identitäten und -ressourcen verwalten.