HTTP > Make an OAuth 2.0 request
Um eine Adobe Workfront Fusion HTTP(S)-Anfrage an Server zu senden, für die eine OAuth 2.0-Autorisierung erforderlich ist, müssen Sie zunächst eine OAuth-Verbindung erstellen. Adobe Workfront Fusion stellt sicher, dass alle Aufrufe, die mit dieser Verbindung getätigt werden, über die entsprechenden Autorisierungskopfzeilen verfügen und die zugehörigen Token bei Bedarf automatisch aktualisieren.
Workfront Fusion unterstützt die folgenden OAuth 2.0-Authentifizierungsflüsse:
- Autorisierungs-Code-Fluss
- impliziter Fluss
Andere Flüsse, z. B. Fluss der Anmeldeinformationen des Ressourcenbesitzers und Fluss der Client-Anmeldeinformationen, werden über dieses Modul nicht automatisch unterstützt.
Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0-Autorisierungs-Framework.
Zugriffsanforderungen
Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Adobe Workfront-Paket | Beliebig |
Adobe Workfront-Lizenz |
Neu: Standard Oder Aktuell: Arbeit oder höher |
Lizenz für Adobe Workfront Fusion** |
Aktuell: Keine Workfront Fusion-Lizenzanforderung. Oder Legacy: Workfront Fusion für Arbeitsautomatisierung und -integration |
Produkt |
Neu:
Oder Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben. |
Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Informationen zu Adobe Workfront Fusion finden Sie unter Adobe Workfront Fusion Lizenzen.
Erstellen einer Verbindung für eine OAuth
- Allgemeine Anweisungen zum Erstellen einer Verbindung im HTTP > Erstellen eines OAuth 2.0-Anfragemoduls
- Anweisungen zum Erstellen einer Verbindung zu Google im HTTP >Make eines OAuth 2.0-Anfragemoduls
- Anleitung zum Herstellen einer Verbindung zur Microsoft Graph API über HTTP > Erstellen einer OAuth 2.0-Anfrage
Allgemeine Anweisungen zum Erstellen einer Verbindung im Modul HTTP > Make an OAuth 2.0 request
-
Erstellen Sie im target einen OAuth-Client, mit dem Sie kommunizieren Adobe Workfront Fusion. Diese Option befindet sich höchstwahrscheinlich im Abschnitt Developer des angegebenen Service.
-
Geben Sie beim Erstellen eines Clients die entsprechende URL in das Feld
Redirect URL
oderCallback URL
ein:table 0-row-2 1-row-2 Nord- und Südamerika/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2
-
Nachdem Sie den Client erstellt haben, zeigt der angegebene Dienst zwei Schlüssel an:
Client ID
undClient Secret
. Einige Dienste nennen dieseApp Key
undApp Secret
. Speichern Sie den Schlüssel und die geheimen Daten an einem sicheren Speicherort, damit Sie sie beim Erstellen der Verbindung in Workfront Fusion bereitstellen können.
-
-
Die
Authorize URI
undToken URI
finden Sie in der API-Dokumentation des jeweiligen Service. Dies sind URL-Adressen, über die Workfront Fusion mit dem target-Service kommuniziert. Die Adressen dienen zur OAuth-Autorisierung.note note NOTE Wenn der Service den impliziten Fluss verwendet, benötigen Sie nur die Authorize URI
. -
(Bedingt) Wenn der Ziel-Service Bereiche (Zugriffsrechte) verwendet, überprüfen Sie, wie der Service einzelne Bereiche trennt, und stellen Sie sicher, dass Sie das Trennzeichen in den erweiterten Einstellungen entsprechend festlegen. Wenn das Trennzeichen nicht richtig festgelegt ist, kann Workfront Fusion die Verbindung nicht erstellen, und es wird ein Fehler wegen ungültigem Bereich angezeigt.
-
Nachdem Sie die oben genannten Schritte ausgeführt haben, können Sie in Workfront Fusion mit der Erstellung der OAuth-Verbindung beginnen. Fügen Sie Ihrem Szenario das Modul HTTP > OAuth 2-Anfrage erstellen hinzu.
-
Klicken Sie im Feld Verbindung des Moduls auf Add.
-
Füllen Sie die folgenden Felder aus, um eine Verbindung zu erstellen:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 layout-auto html-authored no-header Connection name Geben Sie den Namen der Verbindung ein. Environment Wählen Sie aus, ob Sie eine Produktions- oder Nicht-Produktionsumgebung verwenden. Type Wählen Sie aus, ob Sie ein Service-Konto oder ein persönliches Konto verwenden. Flow type Fluss zum Abrufen von Token auswählen.
- Authorization Code: Geben Sie den
Authorize URI
und dieToken URI
aus der API-Dokumentation des Service ein. - Implicit: Geben Sie die
Authorize URI
aus der API-Dokumentation des Service ein.
Scope Individuelle Bereiche hinzufügen. Diese Informationen finden Sie in der Entwicklerdokumentation (API) des jeweiligen Services. Scope separator Wählen Sie aus, durch welche Bereiche oben getrennt werden soll. Diese Informationen finden Sie in der Entwicklerdokumentation (API) des jeweiligen Services.
Warnung: Wenn das Trennzeichen nicht richtig festgelegt ist, kann Workfront Fusion die Verbindung nicht erstellen und Sie erhalten einen Fehler wegen ungültigem Bereich.
Client ID Geben Sie die Client-ID ein. Sie haben die Client-ID erhalten, als Sie einen OAuth-Client in dem Service erstellt haben, den Sie verbinden möchten. Client Secret Geben Sie den geheimen Client-Schlüssel ein. Sie haben das Client-Geheimnis erhalten, als Sie einen OAuth-Client in dem Service erstellt haben, zu dem Sie eine Verbindung herstellen möchten. Authorize parameters Fügen Sie alle Parameter hinzu, die Sie in den Autorisierungsaufruf aufnehmen möchten. Die folgenden Standardparameter werden immer automatisch eingefügt und müssen nicht hinzugefügt werden.
Standardparameter:
-
response_type
code
für Authorization Code flow undtoken
für Implicit flow -
redirect_uri
table 0-row-2 1-row-2 layout-auto html-authored no-header Nord- und Südamerika/APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id
Die Client-ID, die Sie beim Erstellen des Kontos erhalten haben
Access token parameters Fügen Sie alle Parameter hinzu, die Sie in den Token-Aufruf aufnehmen möchten. Die folgenden Standardparameter werden immer automatisch eingefügt und müssen nicht hinzugefügt werden.
Standardparameter:
-
grant_type:
authorization_code
-
redirect_uri:
table 0-row-2 1-row-2 layout-auto html-authored no-header Nord- und Südamerika/APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id: Die Client-ID, die Sie beim Erstellen des Kontos erhalten haben, wird automatisch im Anfrageinhalt enthalten
-
client_secret: Das Client-Geheimnis, das Sie beim Erstellen des Kontos erhalten haben, wird automatisch im Anfrageinhalt enthalten
-
code: Der von der Autorisierungsanfrage zurückgegebene Code
Hinweis:
Der OAuth 2.0-Standard unterstützt in diesem Schritt mindestens zwei Methoden der Client-Authentifizierung (
client_secret_basic
undclient_secret_post
). Workfront Fusion sendet die angegebene Client-ID und das angegebene Geheimnis automatisch über dieclient_secret_post
. Daher werden diese Parameter automatisch als Teil des Textkörpers der Token-Anfrage einbezogen.Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0-Autorisierungs-Framework.
Refresh token parameters Fügen Sie alle Parameter hinzu, die Sie in den Token-Aufruf aufnehmen möchten. Die folgenden Standardparameter werden immer automatisch eingefügt und müssen nicht hinzugefügt werden.
Standardparameter:
-
grant_type:
refresh_token
-
refresh_token: Das neueste Aktualisierungstoken, das von dem Service abgerufen wurde, mit dem Sie eine Verbindung herstellen
-
client_id: Die Client-ID, die Sie beim Erstellen des Kontos erhalten haben, wird automatisch im Anfrageinhalt enthalten
-
client_secret: Das Client-Geheimnis, das Sie beim Erstellen des Kontos erhalten haben, wird automatisch im Anfrageinhalt enthalten
Hinweis:
Der OAuth 2.0-Standard unterstützt in diesem Schritt mindestens zwei Methoden der Client-Authentifizierung (
client_secret_basic
undclient_secret_post
). Workfront Fusion sendet die angegebene Client-ID und das angegebene Geheimnis automatisch über dieclient_secret_post
. Daher werden diese Parameter automatisch als Teil des Textkörpers der Token-Anfrage einbezogen.Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0-Autorisierungs-Framework.
Custom Headers Geben Sie alle zusätzlichen Schlüssel und Werte an, die in die Kopfzeile der Schritte Token und R3 aufgenommen efresh Token sollen.
Hinweis:
Der OAuth 2.0-Standard unterstützt in diesem Schritt mindestens zwei Methoden der Client-Authentifizierung (
client_secret_basic
undclient_secret_post
). Workfront Fusion unterstützt dieclient_secret_basic
nicht automatisch. Wenn der Service, mit dem Sie eine Verbindung herstellen, erwartet, dass die Client-ID und das Client-Geheimnis in einer einzigen Zeichenfolge kombiniert und dann base64 in der Autorisierungs-Kopfzeile codiert werden, sollten Sie diese Kopfzeile und diesen Schlüsselwert hier hinzufügen.Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0-Autorisierungs-Framework.
Token placement Wählen Sie aus, ob das Token beim Herstellen einer Verbindung zur angegebenen URL im header, query string oder in beiden gesendet werden soll.
Token werden am häufigsten im Anfrage-Header gesendet.
Header token name Geben Sie den Namen des Autorisierungs-Tokens in die Kopfzeile ein. Standard: Bearer
.Query string parameter name Geben Sie den Namen des Autorisierungs-Tokens in der Abfragezeichenfolge ein. Standard: access_token
. - Authorization Code: Geben Sie den
-
Klicken Sie auf Continue , um die Verbindung zu speichern und zum Modul zurückzukehren.
-
Fahren Sie fort mit Konfigurieren des OAuth 2.0-Anforderungsmoduls.
Anweisungen zum Erstellen einer Verbindung zu Google finden Sie in der HTTP >Make an OAuth 2.0 request module
Im folgenden Beispiel wird gezeigt, wie Sie das Modul HTTP > Make an OAuth 2.0-Anfrage verwenden, um eine Verbindung zu Google herzustellen.
-
Stellen Sie sicher, dass Sie ein Projekt erstellt, OAuth-Einstellungen konfiguriert und Ihre Anmeldeinformationen generiert haben, wie in Artikel Verbinden Adobe Workfront Fusion mit Google Services unter Verwendung eines benutzerdefinierten OAuth-Clients.
-
Öffnen Sie das Modul HTTP > Make an OAuth 2.0 request .
-
Klicken Sie Add neben dem Feld Verbindung .
-
Geben Sie die folgenden Werte ein:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header Connection name Geben Sie einen Namen für die Verbindung ein. Environment Wählen Sie aus, ob Sie eine Produktions- oder Nicht-Produktionsumgebung verwenden. Type Wählen Sie aus, ob Sie ein Service-Konto oder ein persönliches Konto verwenden. Flow type Authorization Code Authorize URI https://accounts.google.com/o/oauth2/v2/auth
Token URI https://www.googleapis.com/oauth2/v4/token
Scope Individuelle Bereiche hinzufügen. Weitere Informationen zu Bereichen finden Sie unter OAuth 2.O-Bereiche für Google APIs in der Google. Scope separator SPACE Client ID Geben Sie Ihre Google-Client-ID ein.
Informationen zum Erstellen einer Client-ID finden Sie unter Erstellen von OAuth im Artikel Connect Adobe Workfront Fusion zum Google Services mit einem benutzerdefinierten OAuth-Client.
Client Secret Geben Sie Ihr Google-Client-Geheimnis ein.
Informationen zum Erstellen geheimer Client-Daten finden Sie unter Erstellen von OAuth im Artikel Connect Adobe Workfront Fusion zu Google Services mithilfe eines benutzerdefinierten OAuth-Clients.
Authorize parameters Fügen Sie
access_type
-offline
Schlüssel-Wert-Paar hinzu.Hinweis: Wenn Authentifizierungsprobleme auftreten, z. B. bei der Token-Aktualisierung, versuchen Sie, das
prompt
-/consent
-Wertpaar hinzuzufügen. -
Klicken Sie auf Continue , um die Verbindungseinstellungen zu speichern.
-
Fahren Sie fort mit Konfigurieren des OAuth 2.0-Anforderungsmoduls.
Konfigurieren des OAuth 2.0-Anforderungsmoduls
Nachdem Sie eine OAuth 2.0-Verbindung hergestellt haben, fahren Sie mit dem Einrichten des Moduls wie gewünscht fort. Alle Autorisierungs-Token sind automatisch in dieser Anfrage und in jeder anderen Anfrage enthalten, die dieselbe Verbindung verwendet.
Beim Konfigurieren des Moduls HTTP > Make an OAuth 2.0 request zeigt Workfront Fusion die unten aufgeführten Felder an. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.
Wenn die Zuordnungsschaltfläche über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen zu einem anderen Modul in Adobe Workfront Fusion.