DokumentationWorkfrontWorkfront-Handbuch

HTTP > Erstellen eines OAuth 2.0-Anfrage-Moduls

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

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

Um eine Adobe Workfront Fusion HTTP(S)-Anfrage an Server zu richten, 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 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: Keine Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für die Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select- oder Prime Adobe Workfront-Plan verfügen, muss Ihr Unternehmen Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können. Workfront Fusion ist im Ultimate Workfront-Plan enthalten.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können.

Wenden Sie sich an Ihren Workfront -Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.

Informationen zu Adobe Workfront Fusion -Lizenzen finden Sie unter Adobe Workfront Fusion Lizenzen

Herstellen einer Verbindung für eine OAuth -Anfrage

Allgemeine Anweisungen zum Erstellen einer Verbindung im Modul HTTP > Erstellen einer OAuth 2.0-Anfrage

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

    1. Geben Sie beim Erstellen eines Clients die entsprechende URL in das Feld Redirect URL oder Callback URL ein:

      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 rufen diese App Key und App Secret auf. 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 mit dem target-Dienst kommuniziert. 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 korrekt festgelegt ist, kann Workfront Fusion die Verbindung nicht erstellen und Sie erhalten einen Fehler wegen ungültigen Umfangs.

  4. Nachdem Sie die oben genannten Schritte ausgeführt haben, können Sie mit der Erstellung der OAuth-Verbindung in Workfront Fusion beginnen. 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 die Token URI aus der API-Dokumentation des Dienstes ein.
    • Implicit: Geben Sie die Authorize URI in der API-Dokumentation des Dienstes ein.
    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, kann Workfront Fusion die Verbindung nicht erstellen und Sie erhalten einen Fehler wegen ungültigen Umfangs.
    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 Autorisierungscode-Fluss 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 Anfragetext enthalten

    • client_secret: Das Client-Geheimnis, das Sie beim Erstellen des Kontos erhalten haben, wird automatisch im Anfragetext enthalten

    • 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 Methode client_secret_post. 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 neueste 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 Anfragetext enthalten

    • client_secret: Das Client-Geheimnis, das Sie beim Erstellen des Kontos erhalten haben, wird automatisch im Anfragetext enthalten

    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 Methode client_secret_post. 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. Klicken Sie auf Weiter , um die Verbindungseinstellungen zu speichern.

  8. Fahren Sie mit OAuth 2.0 request module setup fort.

Anweisungen zum Erstellen einer Verbindung zu Google im HTTP >Erstellen eines OAuth 2.0-Anfragemoduls

Das folgende Beispiel zeigt, wie Sie das Anfragemodul HTTP > Erstellen eines OAuth 2.0 verwenden, um eine Verbindung zu Google herzustellen.

  1. Stellen Sie sicher, dass Sie ein Projekt erstellt, OAuth-Einstellungen konfiguriert und Ihre Anmeldedaten generiert haben, wie in Verbinden Adobe Workfront Fusion mit Google Services unter Verwendung eines benutzerdefinierten OAuth-Clients beschrieben.

  2. Öffnen Sie das Modul HTTP >Erstellen einer OAuth 2.0-Anfrage .

  3. Klicken Sie neben dem Verbindungsfeld auf Hinzufügen .

  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 in der Dokumentation zu Google.
    Scope separator SPACE
    Client-ID

    Geben Sie Ihre Google Client-ID ein.

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

    Geben Sie Ihr Google Client-Geheimnis ein.

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

    Fügen Sie das Schlüssel-Wert-Paar access_type - offline hinzu.

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

  5. Klicken Sie auf Weiter , um die Verbindungseinstellungen zu speichern.

  6. Fahren Sie mit OAuth 2.0 request module setup fort.

Anweisungen zum Herstellen einer Verbindung zu Microsoft Graph API über das Modul HTTP > Erstellen einer OAuth 2.0-Anforderung

Anweisungen zu Microsoft Graph API finden Sie unter Aufrufen der MS Graph REST API über das Modul Adobe Workfront Fusion HTTP > Erstellen einer OAuth 2.0-Anforderung.

Einrichten des OAuth 2.0-Anforderungsmoduls

Wenn Sie eine Oauth 2.0-Verbindung hergestellt haben, wie in Erstellen einer Verbindung für eine OAuth Anfrage beschrieben, fahren Sie mit der 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 das Modul HTTP >Erstellen einer OAuth 2.0-Anfrage konfigurieren, zeigt Workfront Fusion 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 Informationen von einem Modul einem anderen zuordnen in Adobe Workfront Fusion.

Verbindung
Informationen zum Einrichten einer Verbindung finden Sie unter Erstellen einer Verbindung für eine OAuth-Anforderung 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 Umgang mit Fehlern 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 dient der POST von Daten mit application/x-www-form-urlencoded.

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

    Für Binärdaten ist stattdessen use multipart/form-data erforderlich.

    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 verarbeitet Workfront Fusion mehrere Werte für denselben URL-Abfragezeichenfolgen-Parameterschlüssel wie Arrays. Beispielsweise wird www.test.com?foo=bar&foo=baz in www.test.com?foo[0]=bar&foo[1]=baz umgewandelt. 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 -Header hinzugefügt, 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 Gegenseitige Basis finden Sie unter Verwenden von TLS auf Gegenseitiger Basis in HTTP-Modulen in Adobe Workfront Fusion.

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