DokumentationWorkfrontAdobe Workfront Fusion

HTTP > OAuth 2.0-Anfrage stellen Modul

Last update: Fri Aug 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:
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 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, die entsprechenden Autorisierungskopfzeilen aufweisen und die zugehörigen Token bei Bedarf automatisch aktualisieren.

Workfront Fusion unterstützt die folgenden OAuth 2.0-Authentifizierungsabläufe:

  • 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-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.

Erstellen einer Verbindung für eine OAuth

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

  1. Erstellen Sie im target-Service einen OAuth-Client, mit dem Adobe Workfront Fusion kommunizieren soll. Diese Option befindet sich höchstwahrscheinlich im Abschnitt Entwickler 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. Hierbei handelt es sich um 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ültigen Umfangs angezeigt.

  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 Modul HTTP > OAuth 2-Anfrage erstellen 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 17-row-2 18-row-2 layout-auto html-authored no-header
    Verbindungsname Geben Sie den Namen der Verbindung ein.
    Umgebung Wählen Sie aus, ob Sie eine Produktions- oder Nicht-Produktionsumgebung verwenden.
    Typ Wählen Sie aus, ob Sie ein Service-Konto oder ein persönliches Konto verwenden.
    -Flusstyp

    Fluss zum Abrufen von Token auswählen.

    • Autorisierungs-Code: Geben Sie die Authorize URI und Token URI aus der API-Dokumentation des Services ein.
    • implicit: Geben Sie den Authorize URI aus der API-Dokumentation des Services ein.
    -Umfang Individuelle Bereiche hinzufügen. Diese Informationen finden Sie in der Entwicklerdokumentation (API) des jeweiligen Services.
    -Bereichstrennzeichen

    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 es wird ein Fehler wegen ungültigen Umfangs angezeigt.
    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-Geheimnis 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.
    Parameter autorisieren

    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
    Zugriffstokenparameter

    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 in den Anfragetext aufgenommen

    • 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.
    Token-Parameter aktualisieren

    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 letzte Aktualisierungstoken, das von dem Service erhalten wurde, mit dem Sie eine Verbindung herstellen

    • client_id: Die Client-ID, die Sie beim Erstellen des Kontos erhalten haben, wird automatisch in den Anfragetext aufgenommen

    • 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.
    Benutzerdefinierte Kopfzeilen

    Geben Sie alle zusätzlichen Schlüssel und Werte an, die in die Kopfzeile der Schritte Token und Aktualisierungstoken aufgenommen werden 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-Platzierung

    Wählen Sie aus, ob das Token beim Herstellen einer Verbindung zur angegebenen URL im -Header, -Abfragezeichenfolge 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.
    Abfragezeichenfolgen-Parametername Geben Sie den Namen des Autorisierungs-Tokens in der Abfragezeichenfolge ein. Standard: access_token.

  7. Klicken Sie Fortfahren, 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 unter HTTP > Erstellen einer OAuth 2.0-Anfrage

Im folgenden Beispiel wird gezeigt, wie das Anforderungsmodul HTTP > Erstellen einer OAuth 2.0 für die Verbindung mit Google verwendet wird.

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

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

  3. Klicken Sie in einem beliebigen Modul Hinzufügen 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
    Verbindungsname Geben Sie einen Namen für die Verbindung ein.
    Umgebung Wählen Sie aus, ob Sie eine Produktions- oder Nicht-Produktionsumgebung verwenden.
    Typ Wählen Sie aus, ob Sie ein Service-Konto oder ein persönliches Konto verwenden.
    -Flusstyp Autorisierungs-Code
    URI autorisieren https://accounts.google.com/o/oauth2/v2/auth
    Token-URI https://www.googleapis.com/oauth2/v4/token
    -Umfang Individuelle Bereiche hinzufügen. Weitere Informationen zu Bereichen finden Sie unter OAuth 2.O-Bereiche für Google APIs in der Google.
    -Bereichstrennzeichen LEERZEICHEN
    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-Geheimnis

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

    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 Fortfahren, 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 > OAuth 2.0-Anfrage ​) 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 von einem Modul zu einem anderen in Adobe Workfront Fusion.

Umschalter für Zuordnung

-Verbindung
Informationen zum Einrichten einer Verbindung finden Sie unter Erstellen einer Verbindung für eine OAuthAnfrage in diesem Artikel.
Alle Status als Fehler auswerten (außer 2xx und 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.
-Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
-Kopfzeilen
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.
Texttyp

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-Typ 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 Hauptteiltyp wird verwendet, um Daten mit application/x-www-form-urlencoded zu posten.

    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

    Multipart/form-data ist eine mehrteilige HTTP-Anfrage zum Senden von Dateien und Daten. 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.

    • -Datei

      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 > Datei abrufen), oder geben Sie den Dateinamen und die Dateidaten manuell ein.

Parse response

Aktivieren Sie diese Option, um Antworten automatisch zu parsen und JSON- und XML-Antworten zu konvertieren, sodass Sie keine JSON > Parse JSON- oder XML > Parse XML-Module 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.

Zeitüberschreitung
Geben Sie die Zeitüberschreitung der Anfrage in Sekunden (1-300) ein. Der Standardwert ist 40 Sekunden.
- Cookies für andere HTTP-Module freigeben
Aktivieren Sie diese Option, um Cookies vom Server für alle HTTP-Module in Ihrem Szenario freizugeben.
Selbstsigniertes Zertifikat
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.
lehnen Verbindungen ab, die nicht verifizierte (selbstsignierte) Zertifikate verwenden
Aktivieren Sie diese Option, um Verbindungen abzulehnen, die nicht verifizierte TLS-Zertifikate verwenden.
Weiterleitung folgen
Aktivieren Sie diese Option, um den URL-Umleitungen mit 3xx-Antworten zu folgen.
Alle Weiterleitungen verfolgen
Aktivieren Sie diese Option, um den URL-Umleitungen mit allen Antwort-Codes zu folgen.
Serialisierung mehrerer derselben Abfragezeichenfolgen-Schlüssel als Arrays deaktivieren
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.
Komprimierten Inhalt anfordern

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

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

Gegenseitige TLS verwenden

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

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

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