HTTP > Make an OAuth 2.0 request

NOTE
Adobe Workfront Fusion benötigt zusätzlich zu einer Adobe Workfront eine Adobe Workfront Fusion.

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.

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

Erweitern Sie , um die Zugriffsanforderungen für die -Funktion in diesem Artikel anzuzeigen.

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:

  • Prime oder Workfront auswählen: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.
  • Ultimate Workfront-Paket: Workfront Fusion ist enthalten.

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 Modul HTTP > Make an OAuth 2.0 request

  1. 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.

    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
      Nord- und Südamerika/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 die geheimen Daten an einem sicheren Speicherort, damit Sie sie beim Erstellen der Verbindung in Workfront Fusion bereitstellen können.

  2. Die Authorize URI und Token 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 .
  3. (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.

  4. 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.

  5. Klicken Sie im Feld Verbindung des Moduls auf Add.

  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 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 die Token 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 und token 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 und client_secret_post). Workfront Fusion sendet die angegebene Client-ID und das angegebene Geheimnis automatisch über die client_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 und client_secret_post). Workfront Fusion sendet die angegebene Client-ID und das angegebene Geheimnis automatisch über die client_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 und client_secret_post). Workfront Fusion unterstützt die client_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.
  7. Klicken Sie auf Continue , um die Verbindung zu speichern und zum Modul zurückzukehren.

  8. 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.

  1. 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.

  2. Öffnen Sie das Modul HTTP > Make an OAuth 2.0 request .

  3. Klicken Sie Add neben dem Feld Verbindung .

  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 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.

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

  6. 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.

Umschalter für Zuordnung

Connection
Informationen zum Einrichten einer Verbindung finden Sie unter Erstellen einer Verbindung für eine OAuthAnfrage in diesem Artikel.
Evaluate all states as errors (except for 2xx and 3xx)

Mit dieser Option können Sie die Fehlerbehandlung einrichten.

Weitere Informationen finden Sie unter Fehlerbehandlung.

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

Der HTTP-Hauptteil sind die Datenbytes, die in einer HTTP-Transaktionsnachricht unmittelbar nach den -Headern übertragen werden, falls welche verwendet werden sollen.

  • Raw

    Der Rohtexttyp ist im Allgemeinen für die meisten HTTP-Textkörperanforderungen geeignet, selbst in Situationen, in denen in der Entwicklerdokumentation keine zu sendenden Daten angegeben sind.

    Geben Sie ein Formular zum Analysieren der Daten im Feld Content type an.

    Trotz des ausgewählten Inhaltstyps werden Daten in jedem Format eingegeben, das in der Entwicklerdokumentation festgelegt oder erforderlich ist.

  • Application/x-www-form-urlencoded

    Dieser Texttyp dient zur POST von Daten mit application/x-www-form-urlencoded.

    application/x-www-form-urlencoded besteht der Text der an den Server gesendeten HTTP-Nachricht im Wesentlichen aus einer Abfragezeichenfolge. Schlüssel und Werte werden in Schlüssel-Wert-Paaren codiert, die durch & getrennt sind, wobei zwischen Schlüssel und Wert ein = besteht.

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

    Beispiel:

    Beispiel für das daraus resultierende HTTP-Anfrageformat:

    field1=value1&field2=value2

  • Multipart/form-data

    Die Multipart/form-data ist eine mehrteilige HTTP-Anfrage, die zum Senden von Dateien und Daten verwendet wird. Es wird häufig verwendet, um Dateien auf den Server hochzuladen.

    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 innerhalb des Anfragetexts gesendet werden sollen.

    • File

      Geben Sie den Schlüssel und anschließend die Quelldatei ein, die Sie im Anfrageinhalt senden möchten.

      Ordnen Sie die Datei zu, die Sie aus dem vorherigen Modul hochladen möchten (z. B. HTTP >Get a File), 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 keine JSON > Parse JSON oder XML > Parse XML verwenden müssen.

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

Timeout
Geben Sie die Zeitüberschreitung der Anfrage in Sekunden (1-300) ein. Der Standardwert ist 40 Sekunden.
Share cookies with other HTTP modules
Aktivieren Sie diese Option, um Cookies vom Server für alle HTTP-Module in Ihrem Szenario freizugeben.
Self-signed certificate
Um ein selbstsigniertes Zertifikat oder einen privaten Schlüssel für TLS zu verwenden, klicken Sie auf Extrahieren und geben Sie die Datei und das Kennwort des Zertifikats oder des privaten Schlüssels an.
Reject connections that are using unverified (self-signed) certificates
Aktivieren Sie diese Option, um Verbindungen abzulehnen, die nicht verifizierte TLS-Zertifikate verwenden.
Follow redirect
Aktivieren Sie diese Option, um den URL-Umleitungen mit 3xx-Antworten zu folgen.
Follow all redirects
Aktivieren Sie diese Option, um den URL-Umleitungen mit allen Antwort-Codes zu folgen.
Disable serialization of multiple same query string keys as 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 konvertiert. Aktivieren Sie diese Option, um diese Funktion zu deaktivieren.
Request compressed content

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

Dadurch wird eine Accept-Encoding-Kopfzeile hinzugefügt, um komprimierten Inhalt anzufordern.

Use Mutual TLS

Aktivieren Sie diese Option, um gegenseitiges TLS in der HTTP-Anfrage zu verwenden.

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3