HTTP > Make an OAuth 2.0 request-modulen

NOTE
Adobe Workfront Fusion kräver en Adobe Workfront Fusion-licens förutom en Adobe Workfront-licens.

För att kunna göra en Adobe Workfront Fusion HTTP(S)-begäran till servrar som kräver OAuth 2.0-behörighet måste du först skapa en OAuth-anslutning. Adobe Workfront Fusion säkerställer att alla anrop som görs med den här anslutningen har rätt autentiseringsrubriker och att associerade tokens uppdateras automatiskt när det behövs.

Workfront Fusion stöder följande OAuth 2.0-autentiseringsflöden:

  • Auktoriseringskodflöde
  • Implicit flöde

Andra flöden, som t.ex. Resursägarens lösenordsflöde och Klientinloggningsflöde, stöds inte automatiskt i den här modulen.

Mer information om OAuth 2.0-autentisering finns i OAuth 2.0 Authorization Framework.

NOTE
Om du ansluter till en Adobe-produkt som inte har någon dedikerad anslutning rekommenderar vi att du använder Adobe Authenticator-modulen.
Mer information finns i Adobe Authenticator-modulen.

Åtkomstkrav

Expandera om du vill visa åtkomstkrav för funktionerna i den här artikeln.

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront package Alla
Adobe Workfront-licens

Nytt: Standard

eller

Aktuell: Arbete eller högre

Adobe Workfront Fusion-licens**

Aktuell: Inga Workfront Fusion-licenser krävs

eller

Äldre: Workfront Fusion for Work Automation and Integration

Produkt

Nytt:

  • Select or Prime Workfront package: Your organization must purchase Adobe Workfront Fusion.
  • Ultimate Workfront-paket: Workfront Fusion ingår.

eller

Aktuell: Din organisation måste köpa Adobe Workfront Fusion.

Mer information om informationen i den här tabellen finns i Åtkomstkrav i dokumentationen.

Mer information om Adobe Workfront Fusion-licenser finns i Adobe Workfront Fusion-licenser.

Skapa en anslutning för en OAuth-begäran

Allmänna instruktioner för att skapa en anslutning i modulen HTTP > Make an OAuth 2.0 request

  1. Skapa en OAuth-klient i tjänsten target som du vill att Adobe Workfront Fusion ska kommunicera med. Det här alternativet finns troligen i avsnittet Developer i den angivna tjänsten.

    1. När du skapar en klient anger du rätt URL i fältet Redirect URL eller Callback URL:

      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. När du har skapat klienten visar den angivna tjänsten två nycklar: Client ID och Client Secret. Vissa tjänster anropar dessa App Key och App Secret. Spara nyckeln och hemligheten på en säker plats så att du kan ange dem när du skapar anslutningen i Workfront Fusion.

  2. Sök efter Authorize URI och Token URI i API-dokumentationen för den angivna tjänsten. Detta är URL-adresser som Workfront Fusion kommunicerar med tjänsten target via. Adresserna används för OAuth-auktorisering.

    note note
    NOTE
    Om tjänsten använder implicit flöde behöver du bara Authorize URI.
  3. (Villkorligt) Om måltjänsten använder omfattningar (åtkomsträttigheter) kontrollerar du hur tjänsten skiljer enskilda omfattningar åt och ser till att du anger avgränsaren i de avancerade inställningarna i enlighet med detta. Om avgränsaren inte är rätt inställd kan Workfront Fusion inte skapa anslutningen och du får ett ogiltigt omfångsfel.

  4. När du har utfört stegen ovan kan du börja skapa OAuth-anslutningen i Workfront Fusion. Lägg till HTTP > Gör en OAuth 2-begärandemodul i ditt scenario.

  5. Klicka på Add i anslutningsfältet i modulen.

  6. Fyll i följande fält för att skapa en anslutning:

    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 Ange namnet på anslutningen.
    Environment Ange om du använder en produktionsmiljö eller icke-produktionsmiljö.
    Type Ange om du använder ett tjänstkonto eller ett personligt konto.
    Flow type

    Välj flödet för att hämta tokens.

    • Authorization Code: Ange Authorize URI och Token URI från tjänstens API-dokumentation.
    • Implicit: Ange Authorize URI från tjänstens API-dokumentation.
    Scope Lägg till enskilda omfattningar. Den här informationen finns i den angivna tjänstens API-dokumentation (developer).
    Scope separator

    Välj vilka scope som ska avgränsas av ovan. Den här informationen finns i den angivna tjänstens API-dokumentation (developer).

    Varning! Om avgränsaren inte är rätt inställd kan Workfront Fusion inte skapa anslutningen och du får ett ogiltigt omfångsfel.

    Client ID Ange klient-ID. Du fick klient-ID när du skapade en OAuth-klient i den tjänst som du vill ansluta.
    Client Secret Ange klienthemlighet. Du fick klienthemligheten när du skapade en OAuth-klient i tjänsten som du vill ansluta.
    Authorize parameters

    Lägg till de parametrar som du vill inkludera i auktoriseringsanropet. Följande standardparametrar inkluderas alltid automatiskt och behöver inte läggas till.

    Standardparametrar:

    • response_type

      code för Authorization Code flow och token för Implicit flow

    • 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

      Klient-ID som du fick när du skapade kontot

    Access token parameters

    Lägg till de parametrar som du vill ta med i tokenanropet. Följande standardparametrar inkluderas alltid automatiskt och behöver inte läggas till.

    Standardparametrar:

    • 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: Det klient-ID som du fick när du skapade kontot inkluderas automatiskt i begärandetexten

    • client_secrets: Klienthemligheten som du fick när du skapade kontot inkluderas automatiskt i begärandetexten

    • kod: Koden som returnerades av auktoriseringsbegäran

    Obs!

    OAuth 2.0-standarden stöder minst två metoder för klientautentisering under det här steget (client_secret_basic och client_secret_post). Workfront Fusion skickar automatiskt angivet klient-ID och hemlighet via metoden client_secret_post. Därför inkluderas dessa parametrar automatiskt som en del av tokenbegärandetexten.

    Mer information om OAuth 2.0-autentisering finns i OAuth 2.0 Authorization Framework.

    Refresh token parameters

    Lägg till de parametrar som du vill ta med i tokenanropet. Följande standardparametrar inkluderas alltid automatiskt och behöver inte läggas till.

    Standardparametrar:

    • grant_type: refresh_token

    • refresh_token: Den senaste uppdateringstoken som erhölls av tjänsten som du ansluter till

    • client_id: Det klient-ID som du fick när du skapade kontot inkluderas automatiskt i begärandetexten

    • client_secret: Den klienthemlighet du fick när du skapade kontot inkluderas automatiskt i begärandetexten

    Obs!

    OAuth 2.0-standarden stöder minst två metoder för klientautentisering under det här steget (client_secret_basic och client_secret_post). Workfront Fusion skickar automatiskt angivet klient-ID och hemlighet via metoden client_secret_post. Därför inkluderas dessa parametrar automatiskt som en del av tokenbegärandetexten.

    Mer information om OAuth 2.0-autentisering finns i OAuth 2.0 Authorization Framework.

    Custom Headers

    Ange eventuella ytterligare nycklar och värden som ska inkluderas i huvudet i Token- och Refresh Token-stegen.

    Obs!

    OAuth 2.0-standarden stöder minst två metoder för klientautentisering under det här steget (client_secret_basic och client_secret_post). Workfront Fusion stöder inte automatiskt metoden client_secret_basic. Om tjänsten som du ansluter till förväntar sig att klient-ID och klienthemlighet ska kombineras till en enda sträng och sedan base64 kodas i auktoriseringshuvudet, ska du lägga till det huvud- och nyckelvärdet här.

    Mer information om OAuth 2.0-autentisering finns i OAuth 2.0 Authorization Framework.

    Token placement

    Välj om du vill skicka token i header, query string eller i båda vid anslutning till angiven URL.

    Token skickas oftast i begärandehuvudet.

    Header token name Ange namnet på auktoriseringstoken i huvudet. Standard: Bearer.
    Query string parameter name Ange namnet på auktoriseringstoken i frågesträngen. Standard: access_token.
  7. Klicka på Continue för att spara anslutningen och återgå till modulen.

  8. Fortsätt till Konfigurera en OAuth 2.0-begärandemodul.

Instruktioner för att skapa en anslutning till Google i HTTP > Make an OAuth 2.0 request module

I följande exempel visas hur du använder HTTP > Make an OAuth 2.0-begärandemodulen för att ansluta till Google.

  1. Kontrollera att du har skapat ett projekt, konfigurerat OAuth-inställningar och genererat dina autentiseringsuppgifter enligt beskrivningen i artikelnAnsluta Adobe Workfront Fusion till Google Services med en anpassad OAuth-klient.

  2. Öppna modulen HTTP > Make an OAuth 2.0 request.

  3. Klicka på Add bredvid rutan Anslutning i någon av modulerna.

  4. Ange följande värden:

    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 Ange ett namn för anslutningen.
    Environment Ange om du använder en produktionsmiljö eller icke-produktionsmiljö.
    Type Ange om du använder ett tjänstkonto eller ett personligt konto.
    Flow type Authorization Code
    Authorize URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Scope Lägg till enskilda omfattningar. Mer information om omfång finns i OAuth 2.O-omfång för Google API:eri Google-dokumentationen.
    Scope separator SPACE
    Client ID

    Ange ditt klient-ID för Google.

    Information om hur du skapar ett klient-ID finns i Skapa OAuth-autentiseringsuppgifter i artikeln Connect Adobe Workfront Fusion till Google Services med en anpassad OAuth-klient.

    Client Secret

    Ange din Google-klienthemlighet.

    Information om hur du skapar en klienthemlighet finns i Skapa OAuth-autentiseringsuppgifter i artikeln Connect Adobe Workfront Fusion till Google Services med en anpassad OAuth-klient.

    Authorize parameters

    Lägg till access_type - offline nyckelvärdepar.

    Obs! Om du får autentiseringsproblem, till exempel när du uppdaterar token, kan du försöka med att lägga till nyckelvärdepar för prompt - consent .

  5. Klicka på Continue om du vill spara anslutningsinställningarna.

  6. Fortsätt till Konfigurera en OAuth 2.0-begärandemodul.

Konfigurera modulen Gör en OAuth 2.0-begäran

När du har upprättat en OAuth 2.0-anslutning fortsätter du att konfigurera modulen efter behov. Alla auktoriseringstoken inkluderas automatiskt i denna begäran och i alla andra begäranden som använder samma anslutning.

När du konfigurerar modulen HTTP > Make an OAuth 2.0 request visas fälten som listas nedan i Workfront Fusion. En rubrik med fet stil i en modul visar ett obligatoriskt fält.

Om du ser kartknappen ovanför ett fält eller en funktion kan du använda den för att ange variabler och funktioner för det fältet. Mer information finns i Mappa information från en modul till en annan i Adobe Workfront Fusion.

Växla karta

Connection
Mer information om hur du konfigurerar en anslutning finns i Skapa en anslutning för en OAuth-begäran i den här artikeln.
Evaluate all states as errors (except for 2xx and 3xx)

Använd det här alternativet om du vill konfigurera felhantering.

Mer information finns i Felhantering.

URL
Ange den URL som du vill skicka en begäran till, t.ex. en API-slutpunkt, webbplats osv.
Method
Välj den HTTP-förfrågningsmetod som du behöver för att konfigurera API-anropet. Mer information finns i Metoder för HTTP-begäran.
Headers
Lägg till rubrikerna för begäran i form av ett standard-JSON-objekt. Exempel: {"Content-type":"application/json"}
Query String
Ange önskade nyckelvärdepar för frågan.
Body type

HTTP-brödtexten är de databyte som skickas i ett HTTP-transaktionsmeddelande omedelbart efter rubrikerna om något ska användas.

  • Raw

    Raw-brödtexttypen är vanligtvis lämplig för de flesta HTTP-innehållsbegäranden, även i situationer där utvecklardokumentationen inte anger vilka data som ska skickas.

    Ange en form av tolkning av data i fältet Content type.

    Trots att innehållstypen är vald, anges data i vilket format som helst som anges eller krävs av utvecklardokumentationen.

  • Application/x-www-form-urlencoded

    Den här brödtypen är till POST-data med application/x-www-form-urlencoded.

    För application/x-www-form-urlencoded är brödtexten i HTTP-meddelandet som skickas till servern i princip en frågesträng. Nycklarna och värdena kodas i nyckelvärdepar avgränsade med & och med en = mellan nyckeln och värdet.

    För binära data use multipart/form-data i stället.

    Exempel:

    Exempel på det resulterande formatet för HTTP-begäran:

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data är en HTTP-multipart-begäran som används för att skicka filer och data. Det används ofta för att överföra filer till servern.

    Lägg till fält som ska skickas i begäran. Varje fält måste innehålla ett nyckelvärdepar.

    • Text

      Ange nyckeln och värdet som ska skickas i begärandetexten.

    • File

      Ange nyckeln och ange den källfil som du vill skicka i begärandetexten.

      Mappa filen som du vill överföra från föregående modul (till exempel HTTP > Get a File) eller ange filnamnet och fildata manuellt.

Parse response

Aktivera det här alternativet om du vill analysera svar automatiskt och konvertera JSON- och XML-svar så att du inte behöver använda JSON > Parse JSON eller XML > Parse XML-moduler.

Innan du kan använda tolkat JSON- eller XML-innehåll kör du modulen en gång manuellt, så att modulen kan identifiera svarsinnehållet och mappa det i efterföljande moduler.

Timeout
Ange timeout för begäran i sekunder (1-300). Standardvärdet är 40 sekunder.
Share cookies with other HTTP modules
Aktivera det här alternativet om du vill dela cookies från servern med alla HTTP-moduler i ditt scenario.
Self-signed certificate
Om du vill använda ett självsignerat certifikat eller en privat nyckel för TLS klickar du på Extrahera och anger filen och lösenordet för certifikatet eller den privata nyckeln.
Reject connections that are using unverified (self-signed) certificates
Aktivera det här alternativet om du vill avvisa anslutningar som använder overifierade TLS-certifikat.
Follow redirect
Aktivera det här alternativet om du vill följa URL-omdirigeringarna med 3xx-svar.
Follow all redirects
Aktivera det här alternativet om du vill följa URL-omdirigeringarna med alla svarskoder.
Disable serialization of multiple same query string keys as arrays
Som standard hanterar Workfront Fusion flera värden för samma URL-frågesträngsparameternyckel som arrayer. www.test.com?foo=bar&foo=baz konverteras till exempel till www.test.com?foo[0]=bar&foo[1]=baz. Aktivera det här alternativet om du vill inaktivera funktionen.
Request compressed content

Aktivera det här alternativet om du vill begära en komprimerad version av webbplatsen.

Detta lägger till en Accept-Encoding-rubrik för att begära komprimerat innehåll.

Use Mutual TLS

Aktivera det här alternativet om du vill använda ömsesidig TLS i HTTP-begäran.

Mer information om ömsesidigt TLS finns i Använd ömsesidigt TLS i HTTP-moduler i Adobe Workfront Fusion.

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