Mit OAuth authentifizieren

Voraussetzungen

Noch nicht vertraut mit CCDS? Siehe Konzept: CCDS und Benutzerdefinierte Cloud-Datenquelle (CCDS) einrichten.
Erforderliche Berechtigungen zum Einrichten und Authentifizieren einer CCDS mit OAuth:
Integrationsentwickler
unter
Verwaltung > Berechtigungssätze
Erforderliche Berechtigungen zum Anfordern der Autorisierung für eine CCDS:
Datendesigner
unter
Verwaltung > Berechtigungssätze
Erstellen Sie eine CCDS oder wählen Sie eine vorhandene CCDS aus.

Navigation

Wechseln Sie im Navigationsmenü zu

Integration

>

Integrationsdesign

.

OAuth einrichten und konfigurieren

Klicken Sie im Bereich
Zugangsdaten
auf
Neue Zugangsdaten erstellen
.
Wählen Sie
OAuth 1.0a
oder
OAuth 2.0
aus, geben Sie einen Namen für die Zugangsdaten ein und klicken Sie auf
Erstellen
. OAuth 1.0a- und OAuth 2.0-Zugangsdaten verwenden zur Identifikation unterschiedliche Symbole.
Geben Sie folgende
Einstellungen
an:
Die Einstellungen
für OAuth 1.0a
umfassen folgende Felder:
Consumer-Schlüssel:
Client-ID bzw. Client-Kennung, die während des Registrierungsprozesses an den Client ausgegeben wird. Der
Consumer-Schlüssel
und der
Consumer-Geheimschlüssel
bilden das Zugangsdatenpaar zur Identifizierung und Authentifizierung des anfragenden Clients.
Consumer-Geheimschlüssel:
Der geheime Schlüssel des Clients.
Unterstützte Signaturmethode:
Die vordefinierte Signaturmethode ist „HMAC-SHA1“, sie kann nicht geändert werden.
Anforderungs-Token-Service - HTTP-Methode:
Wählen Sie „GET“ oder „POST“ aus der Dropdown-Liste aus.
Serviceendpunkt von Anforderungs-Token:
Wird vom Client verwendet, um einen Satz von Token-Zugangsdaten anzufordern.
Autorisierung Umleitungs-URL:
URL, um die temporären Zugangsdaten für die Identifizierung von Delegationsanforderungen abzurufen.
Zugriffs-Token-Service - HTTP-Methode:
Wählen Sie je nach Anforderungen des externen Zugriffs-Token-Service entweder „GET“ oder „POST“ aus.
Serviceendpunkt von Zugriffs-Token:
URL, um das Token für den Zugriff auf geschützte Ressourcen abzurufen.
OAuth-Parameter zu Anforderungs-URLs hinzufügen:
URL zum Identifizieren einer Ressource im Bereich des URI-Schemas und der Namensvergabestelle.
Die Einstellungen
für OAuth 2.0
enthält zusätzlich folgende zusätzliche Felder:
Consumer-Schlüssel:
Client-ID bzw. Client-Kennung, die während des Registrierungsprozesses an den Client ausgegeben wird. Der
Consumer-Schlüssel
und der
Consumer-Geheimschlüssel
bilden das Zugangsdatenpaar zur Identifizierung und Authentifizierung des anfragenden Clients.
Consumer-Geheimschlüssel:
Der geheime Schlüssel des Clients.
Umleitungs-URI:
Leitet den Benutzer nach der Autorisierung um. Der Integrationsentwickler verwendet diese URI beim Setup der OAuth 2.0-Anwendung auf dem Drittanbieterserver. Dieses Feld kann nicht geändert werden.
Bereich:
Der Bereich der Services oder Objekte für Zugriffsanforderungen.
Autorisierungs-Header erforderlich:
Aktivieren Sie dieses Kontrollkästchen, wenn der Drittanbieter bei der Anforderung oder Aktualisierung des Zugriffs-Token nach der Autorisierung den Autorisierungs-Header in der Anforderung benötigt.
Erneuerbares Zugriffs-Token:
Aktivieren Sie dieses Kontrollkästchen, wenn bei der Erstautorisierung die ursprünglichen Zugriffs- und Aktualisierungs-Token zur Erneuerung abgerufen werden und wenn das Zugriffs-Token auf dem Drittanbieterserver automatisch erneuert wird.
Autorisierung Umleitungs-URL:
Die URL, um die temporären Zugangsdaten für die Identifizierung von Delegationsanforderungen abzurufen.
Zugriffs-Token-Service - HTTP-Methode:
Wählen Sie je nach Anforderungen des externen Zugriffs-Token-Service entweder „GET“ oder „POST“ aus.
Serviceendpunkt von Zugriffs-Token:
URL, um das Token für den Zugriff auf geschützte Ressourcen abzurufen.
Standard für Token-Ablauf (Sek.)
: Standardablauf in Sekunden für Zugriffs-Token ohne Ablaufzeit.
Klicken Sie im Bereich
Aktionen
auf
Speichern
.

CCDS mit OAuth authentifizieren

Wählen Sie Ihre CCDS im Bereich
Datenquellen
aus.
Aktivieren Sie auf dem Register
Dateneinstellungen
die Option
Erfordert Zugangsdaten
.
Wählen Sie Ihre OAuth-Zugangsdaten aus der Dropdown-Liste
Zugangsdaten
aus.
Aktualisieren Sie Ihr Skript auf dem Register
Skripte
so, dass es Ihre OAuth-Zugangsdaten enthält. Beispiel:
response=ai.authorizedRequest(url,method,body,headers)
.
Klicken Sie im Bereich
Aktionen
auf
Speichern
.

Autorisierung anfordern

Wählen Sie Ihre CCDS im Bereich
Datenquellen
aus.
Klicken Sie im Bereich
Aktionen
auf
Autorisierung anfordern
, um die CCDS-Autorisierungsanforderung zu generieren.
Ein neues Browserfenster zur Autorisierung der Drittanbieter-Website wird geöffnet. Nach Abschluss der Autorisierung stellt die OAuth 1.0a-Anwendung eine Verbindung zu Ihrem Konto her, um auf Daten zuzugreifen. Für OAuth 2.0 wird, sofern die Drittanbieter-Website dies zulässt, möglicherweise der gesamte Servicebereich angezeigt, den Sie in den
Einstellungen
für OAuth 2.0 im Feld
Bereich
angegeben haben.
Aktualisieren Sie
Adaptive Planning
Seite „CCDS-Datenquellen“. Beachten Sie, dass alle Menüelemente im Bereich
Aktionen
aktiviert werden.