DokumentationWorkfrontWorkfront-Handbuch

HTTP > OAuth 2.0-Anfrage stellen Modul

Last update: Fri Feb 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
NOTE
Adobe Workfront Fusion erfordert Adobe Workfront Fusion zusätzlich zu einer Adobe Workfront -Lizenz.

Um eine Adobe Workfront Fusion HTTP(S)-Anfrage an Server, die eine OAuth 2.0-Autorisierung erfordern, müssen Sie zunächst eine OAuth-Verbindung erstellen. Adobe Workfront Fusion stellt sicher, dass alle mit dieser Verbindung getätigten Aufrufe ü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:

  • Autorisierungscode-Fluss
  • Impliziter Fluss

Andere Flüsse, wie "Resource Owner Password Credentials Flow"und "Client Credentials Flow", werden von diesem Modul nicht automatisch unterstützt.

Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0 Authorization Framework.

NOTE
Wenn Sie eine Verbindung zu einem Adobe-Produkt herstellen, das derzeit über keinen dedizierten Connector verfügt, empfehlen wir die Verwendung des Adobe Authenticator-Moduls.
Weitere Informationen finden Sie unter Adobe Authenticator-Modul.

Zugriffsanforderungen

Sie müssen über den folgenden Zugriff verfügen, um die Funktionalität in diesem Artikel verwenden zu können:

Adobe Workfront plan*
Pro oder höher
Adobe Workfront license*
Plan, Arbeit
Adobe Workfront Fusion license**

Aktuelle Lizenzanforderungen: nein Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für Arbeitsautomatisierung und Integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über Select oder Prime verfügen Adobe Workfront Planung, Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront , um die in diesem Artikel beschriebenen Funktionen zu verwenden. Workfront Fusion ist in Ultimate enthalten. Workfront Plan.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront , um die in diesem Artikel beschriebenen Funktionen zu verwenden.

Wenden Sie sich an Ihren Workfront Administrator.

Informationen über Adobe Workfront Fusion Lizenzen, siehe Adobe Workfront Fusion Lizenzen

Erstellen einer Verbindung für eine OAuth Anfrage

Allgemeine Anweisungen zum Erstellen einer Verbindung in der HTTP > OAuth 2.0-Anfrage stellen Modul

  1. Erstellen Sie einen OAuth-Client im target Dienst, mit dem Sie Adobe Workfront Fusion zur Kommunikation. Diese Option befindet sich höchstwahrscheinlich im Entwickler Abschnitt des angegebenen Dienstes.

    1. Geben Sie bei der Erstellung eines Clients die entsprechende URL in die Redirect URL oder Callback URL -Feld:

      table 0-row-2 1-row-2
      Amerika/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    2. Nachdem Sie den Client erstellt haben, zeigt der angegebene Dienst zwei Schlüssel an: Client ID und Client Secret. Einige Dienste nennen diese App Key und App Secret . Speichern Sie den Schlüssel und das Geheimnis an einem sicheren Speicherort, damit Sie sie beim Erstellen der Verbindung in Workfront Fusion bereitstellen können.

  2. Suchen Sie die Authorize URI und Token URI in der API-Dokumentation des angegebenen Dienstes. Dies sind URL-Adressen, über die Workfront Fusion kommuniziert mit der target -Dienst. Die Adressen dienen der OAuth-Autorisierung.

    note note
    NOTE
    Wenn der Dienst den impliziten Fluss verwendet, benötigen Sie nur den Authorize URI.
    note info
    INFO
    Beispiel: Yahoo-Adressen:
    • URI autorisieren:
    https://api.login.yahoo.com/oauth2/request_auth
    • Token-URI:
    https://api.login.yahoo.com/oauth2/get_token

  3. (Bedingt) Wenn der Zieldienst Bereiche verwendet (Zugriffsberechtigungen), überprüfen Sie, wie der Dienst einzelne Bereiche trennt, und stellen Sie sicher, dass Sie das Trennzeichen in den erweiterten Einstellungen entsprechend festlegen. Wenn das Trennzeichen nicht richtig festgelegt ist, Workfront Fusion kann die Verbindung nicht erstellen, und Sie erhalten einen Fehler wegen ungültigen Perimeter.

  4. Nachdem Sie die oben genannten Schritte ausgeführt haben, können Sie mit der Erstellung der OAuth-Verbindung in Workfront Fusion. Fügen Sie Ihrem Szenario das OAuth 2.0-HTTP(S)-Anfrage- und Antwortverarbeitungsmodul hinzu.

  5. Klicken Sie im Feld Verbindung des Moduls auf Hinzufügen.

  6. 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 layout-auto html-authored no-header
    Verbindungsname Geben Sie den Namen der Verbindung ein.
    Flusstyp

    Wählen Sie den Fluss zum Abrufen von Token aus.

    • Autorisierungscode: Geben Sie die Authorize URI und Token URI aus der API-Dokumentation des Dienstes.
    • Implicit: Geben Sie die Authorize URI aus der API-Dokumentation des Dienstes.
    Umfang Einzelne Bereiche hinzufügen. Diese Informationen finden Sie in der Entwicklerdokumentation (API) des jeweiligen Dienstes.
    Scope separator

    Wählen Sie aus, durch welche Bereiche die zuvor eingegebenen Bereiche getrennt werden sollen. Diese Informationen finden Sie in der Entwicklerdokumentation (API) des jeweiligen Dienstes.

    Warnung: Wenn das Trennzeichen nicht korrekt festgelegt ist, Workfront Fusion kann die Verbindung nicht erstellen, und Sie erhalten einen Fehler wegen ungültigen Perimeter.
    Client-ID Geben Sie die Client-ID ein. Sie haben die Client-ID erhalten, als Sie im Dienst, den Sie verbinden möchten, einen OAuth-Client erstellt haben.
    Client Secret Geben Sie den Client-Geheimnis ein. Sie haben das Client-Geheimnis erhalten, als Sie einen OAuth-Client in dem Dienst erstellt haben, den Sie verbinden möchten.
    Autorisierungsparameter

    Fügen Sie alle Parameter hinzu, die Sie in den Autorisierungsaufruf einbeziehen möchten. Die folgenden Standardparameter werden immer automatisch eingeschlossen und müssen nicht hinzugefügt werden.

    Standardparameter:

    • response_type

      code für den Fluss des Autorisierungscodes und token für Impliziter Fluss

    • redirect_uri

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      Amerika/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
    Zugriffstoken-Parameter

    Fügen Sie alle Parameter hinzu, die Sie in den Token-Aufruf aufnehmen möchten. Die folgenden Standardparameter werden immer automatisch eingeschlossen 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
      Amerika/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: Der Client-Geheimnis, den Sie beim Erstellen des Kontos erhalten haben, wird automatisch in den Anfrageinhalt eingefügt.

    • code: Der von der Autorisierungsanfrage zurückgegebene Code

    Hinweis:

    Der OAuth 2.0-Standard unterstützt mindestens 2 Methoden der Client-Authentifizierung während dieses Schritts (client_secret_basic und client_secret_post). Workfront Fusion sendet automatisch die angegebene Client-ID und das Geheimnis über die client_secret_post -Methode. Daher werden diese Parameter automatisch als Teil des Token-Anforderungstextes einbezogen.

    Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0 Authorization Framework.
    Parameter des Aktualisierungstokens

    Fügen Sie alle Parameter hinzu, die Sie in den Token-Aufruf aufnehmen möchten. Die folgenden Standardparameter werden immer automatisch eingeschlossen und müssen nicht hinzugefügt werden.

    Standardparameter:

    • Grant_Type: refresh_token

    • refresh_token: Das aktuellste Aktualisierungstoken, das vom Dienst 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: Der Client-Geheimnis, den Sie beim Erstellen des Kontos erhalten haben, wird automatisch in den Anfrageinhalt eingefügt.

    Hinweis:

    Der OAuth 2.0-Standard unterstützt mindestens 2 Methoden der Client-Authentifizierung während dieses Schritts (client_secret_basic und client_secret_post). Workfront Fusion sendet automatisch die angegebene Client-ID und das Geheimnis über die client_secret_post -Methode. Daher werden diese Parameter automatisch als Teil des Token-Anforderungstextes einbezogen.

    Weitere Informationen zur OAuth 2.0-Authentifizierung finden Sie unter OAuth 2.0 Authorization Framework.
    Benutzerdefinierte Kopfzeilen

    Geben Sie zusätzliche Schlüssel und Werte an, die in die Kopfzeile der Schritte Token und RAktualisierungstoken aufgenommen werden sollen.

    Hinweis:

    Der OAuth 2.0-Standard unterstützt mindestens 2 Methoden der Client-Authentifizierung während dieses Schritts (client_secret_basic und client_secret_post). Workfront Fusion unterstützt nicht automatisch die client_secret_basic -Methode. Wenn der Dienst, mit dem Sie eine Verbindung herstellen möchten, erwartet, dass die Client-ID und das Client-Geheimnis zu einer einzelnen Zeichenfolge kombiniert und dann base64-kodiert in der Autorisierungskopfzeile 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 Authorization Framework.
    Token placement

    Wählen Sie aus, ob das Token im Header, in der Abfragezeichenfolge oder in beiden beim Herstellen einer Verbindung zur angegebenen URL gesendet werden soll.

    Token werden meist im Anfrageheader gesendet.
    Header-Token-Name Geben Sie den Namen des Autorisierungstokens in die Kopfzeile ein. Standard: Bearer.
    Parametername der Abfragezeichenfolge Geben Sie den Namen des Autorisierungstokens in die Abfragezeichenfolge ein. Standard: access_token.

  7. Klicks Weiter , um Verbindungseinstellungen zu speichern.

  8. Weiter zu Einrichten des OAuth 2.0-Anforderungsmoduls.

Anleitung zum Erstellen einer Verbindung zu Google im HTTP >Erstellen eines OAuth 2.0-Anforderungsmoduls

Im folgenden Beispiel wird gezeigt, wie die HTTP > Erstellen einer OAuth 2.0 Anfragemodul für Verbindung anfordern Google.

  1. Stellen Sie sicher, dass Sie ein Projekt erstellt, OAuth-Einstellungen konfiguriert und Ihre Anmeldeinformationen generiert haben, wie unter Verbinden Adobe Workfront Fusion nach Google Services Verwenden eines benutzerdefinierten OAuth-Clients.

  2. Öffnen Sie die HTTP >OAuth 2.0-Anfrage stellen -Modul.

  3. Klicks Hinzufügen neben dem Verbindungsfeld.

  4. 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 layout-auto html-authored no-header
    Verbindungsname Geben Sie den Namen der Verbindung ein.
    Flusstyp Autorisierungscode
    Autorisierungs-URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Umfang Einzelne Bereiche hinzufügen. Weitere Informationen zu Bereichen finden Sie unter OAuth 2.O-Bereiche für Google APIs im Google Dokumentation.
    Scope separator SPACE
    Client-ID

    Geben Sie Ihre Google Client-ID.

    Informationen zum Erstellen einer Client-ID finden Sie unter OAuth-Anmeldedaten erstellen in Connect Adobe Workfront Fusion nach Google Services Verwenden eines benutzerdefinierten OAuth-Clients.
    Client Secret

    Geben Sie Ihre Google Client Secret.

    Informationen zum Erstellen eines Client-Geheimnisses finden Sie unter OAuth-Anmeldedaten erstellen in Connect Adobe Workfront Fusion nach Google Dienste mit einem benutzerdefinierten OAuth-Client.
    Autorisierungsparameter

    Hinzufügen access_type - offline Schlüssel-Wert-Paar.

    Hinweis: Wenn Authentifizierungsprobleme auftreten, z. B. beim Aktualisieren von Token, versuchen Sie, die prompt - consent Schlüssel-Wert-Paar.

  5. Klicks Weiter , um Verbindungseinstellungen zu speichern.

  6. Weiter zu Einrichten des OAuth 2.0-Anforderungsmoduls.

Anleitung für die Verbindung zu Microsoft Graph API über die HTTP > OAuth 2.0-Anfrage stellen Modul

Hinweise zu Microsoft Graph API, siehe Rufen Sie die MS Graph REST API über die Adobe Workfront Fusion HTTP > OAuth 2.0-Anfrage stellen Modul.

Einrichten des OAuth 2.0-Anforderungsmoduls

Wenn Sie eine Oauth 2.0-Verbindung wie unter Erstellen einer Verbindung für eine OAuth Anfrage, setzen Sie die Einrichtung des Moduls wie gewünscht fort. Alle Autorisierungstoken werden automatisch in diese Anfrage und in jede andere Anfrage einbezogen, die dieselbe Verbindung verwendet.

Wenn Sie die HTTP >OAuth 2.0-Anfrage stellen -Modul, Workfront Fusion zeigt die unten aufgeführten Felder an. Ein fett hervorgehobener Titel in einem Modul zeigt ein erforderliches Feld an.

Wenn Sie die Zuordnungsschaltfläche über einem Feld oder einer Funktion sehen, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Ordnen Sie Informationen zwischen Modulen in Adobe Workfront Fusion.

Verbindung
Informationen zum Einrichten einer Verbindung finden Sie unter Erstellen einer Verbindung für eine OAuth-Anfrage in diesem Artikel.
Alle Status als Fehler auswerten (mit Ausnahme von 2xx und 3xx)

Verwenden Sie diese Option, um die Fehlerbehandlung einzurichten.

Weitere Informationen finden Sie unter Fehlerbehandlung in Adobe Workfront Fusion.

URL
Geben Sie die URL ein, an die Sie eine Anfrage senden möchten, z. B. einen API-Endpunkt, eine Website usw.
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anforderungsmethoden in Adobe Workfront Fusion.
Header
Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu. Beispiel: {"Content-type":"application/json"}
Abfragezeichenfolge
Geben Sie die gewünschten Schlüssel-Wert-Paare für die Abfrage ein.
Textkörper

Der HTTP-Hauptteil sind die Daten-Bytes, die in einer HTTP-Transaktionsnachricht unmittelbar auf die Header übertragen werden, sofern welche verwendet werden sollen.

  • Raw

    Der Rohkörpertyp eignet sich im Allgemeinen für die meisten HTTP-Textkörperanforderungen, selbst wenn in der Entwicklerdokumentation keine zu sendenden Daten angegeben sind.

    Geben Sie im Feld Inhaltstyp eine Form zum Analysieren der Daten an.

    Trotz des ausgewählten Inhaltstyps werden die Daten in einem beliebigen Format eingegeben, das in der Entwicklerdokumentation festgelegt oder benötigt wird.

  • Application/x-www-form-urlencoded

    Dieser Nachrichtentyp besteht in der POST von Daten mithilfe von application/x-www-form-urlencoded.

    Für application/x-www-form-urlencoded, ist der Hauptteil der an den Server gesendeten HTTP-Nachricht im Wesentlichen eine Abfragezeichenfolge. Die Schlüssel und Werte sind in Schlüssel/Wert-Paaren kodiert, getrennt durch & und mit = zwischen Schlüssel und Wert.

    Für Binärdaten: use multipart/form-data anstatt.

    Beispiel:

    Beispiel für das resultierende HTTP-Anforderungsformat:

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data ist eine HTTP-Multipart-Anfrage zum Senden von Dateien und Daten. Sie wird häufig zum Hochladen von Dateien auf den Server verwendet.

    Fügen Sie Felder hinzu, die in der Anfrage gesendet werden sollen. Jedes Feld muss ein Schlüssel-Wert-Paar enthalten.

    • Text

      Geben Sie den Schlüssel und den Wert ein, die im Anfrageinhalt gesendet werden sollen.

    • Datei

      Geben Sie den Schlüssel ein und geben Sie im Anfragetext die Quelldatei an, die Sie senden möchten.

      Ordnen Sie die Datei zu, die Sie vom vorherigen Modul hochladen möchten (z. B. HTTP >Datei abrufen oder Google Drive >Datei herunterladen), oder geben Sie den Dateinamen und die Dateidaten manuell ein.

Parse response

Aktivieren Sie diese Option, um Antworten automatisch zu analysieren und JSON- und XML-Antworten zu konvertieren, sodass Sie nicht JSON > Parse JSON oder XML > Parse XML Module verwenden müssen.

Bevor Sie geparsten JSON- oder XML-Inhalt verwenden können, führen Sie das Modul einmal manuell aus, damit das Modul den Antwortinhalt erkennen und ihn in nachfolgenden Modulen zuordnen kann.

Timeout
Geben Sie den Anforderungstimeout in Sekunden (1-300) ein. Der Standardwert beträgt 40 Sekunden.
Cookies mit anderen HTTP-Modulen teilen
Aktivieren Sie diese Option, um Cookies vom Server für alle HTTP-Module in Ihrem Szenario freizugeben.
Selbstsigniertes Zertifikat
Laden Sie das Zertifikat hoch, wenn Sie TLS mit Ihrem selbst signierten Zertifikat verwenden möchten.
Ablehnen von Verbindungen, die nicht überprüfte (selbstsignierte) Zertifikate verwenden
Aktivieren Sie diese Option, um Verbindungen abzulehnen, die nicht überprüfte TLS-Zertifikate verwenden.
Weiterleitung
Aktivieren Sie diese Option, um URL-Umleitungen mit 3xx-Antworten zu folgen.
Alle Umleitungen folgen
Aktivieren Sie diese Option, um den URL-Umleitungen mit allen Antwort-Codes zu folgen.
Deaktivieren der Serialisierung mehrerer Abfragezeichenfolgenschlüssel als Arrays
Standardmäßig ist Workfront Fusion verarbeitet mehrere Werte für denselben URL-Abfragezeichenfolgenparameterschlüssel wie Arrays. Beispiel: www.test.com?foo=bar&foo=baz wird in www.test.com?foo[0]=bar&foo[1]=baz. Aktivieren Sie diese Option, um diese Funktion zu deaktivieren.
Komprimierten Inhalt anfordern

Aktivieren Sie diese Option, um eine komprimierte Version der Website anzufordern.

Dadurch wird ein Accept-Encoding -Kopfzeile, um komprimierten Inhalt anzufordern.

Gegenseitige TLS verwenden

Aktivieren Sie diese Option, um in der HTTP-Anforderung die Verwendung von TLS mit Gegenseitigkeit vorzunehmen.

Weitere Informationen zu TLS auf Gegenseitigkeit finden Sie unter Verwenden von TLS auf Gegenseitigkeit in HTTP-Modulen in Adobe Workfront Fusion.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43