DokumentationWorkfrontAnvändarhandbok om Workfront

HTTP > Make an OAuth 2.0 request-modulen

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare
NOTE
Adobe Workfront Fusion kräver en Adobe Workfront Fusion-licens utöver en Adobe Workfront-licens.

För att kunna göra en Adobe Workfront Fusion HTTP(S)-begäran till servrar som kräver en OAuth 2.0-auktorisering måste du först skapa en OAuth-anslutning. Adobe Workfront Fusion ser till att alla anrop som görs med den här anslutningen har lämpliga auktoriseringshuvuden 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 för närvarande inte har någon dedikerad anslutning rekommenderar vi att du använder Adobe Authenticator-modulen.
Mer information finns i Adobe Authenticator-modulen.

Åtkomstkrav

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

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

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

Skapar 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. Det här är URL-adresser som Workfront Fusion kommunicerar med tjänsten target genom. Adresserna används för OAuth-auktorisering.

    note note
    NOTE
    Om tjänsten använder implicit flöde behöver du bara Authorize URI.
    note info
    INFO
    Exempel: Yahoo-adresser:
    • Auktorisera URI:
    https://api.login.yahoo.com/oauth2/request_auth
    • Token-URI:
    https://api.login.yahoo.com/oauth2/get_token

  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 slutfört stegen ovan kan du börja skapa OAuth-anslutningen i Workfront Fusion. Lägg till OAuth 2.0 HTTP(S)-begäran och svarsbearbetningsmodulen 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 layout-auto html-authored no-header
    Connection name Ange namnet på anslutningen.
    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 om du vill spara anslutningsinställningarna.

  8. Fortsätt till konfigurationen av OAuth 2.0-begärandemodulen.

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

  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 layout-auto html-authored no-header
    Connection name Ange namnet på anslutningen.
    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 Connect Adobe Workfront Fusion till Google Services med en anpassad OAuth-klient.
    Client Secret

    Ange din Google-klienthemlighet.

    Mer information om hur du skapar en klienthemlighet finns i Skapa OAuth-autentiseringsuppgifter i 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 konfigurationen av OAuth 2.0-begärandemodulen.

Instruktioner för att ansluta till Microsoft Graph API via modulen HTTP > Make an OAuth 2.0 request

Anvisningar om Microsoft Graph API finns i Anropa MS Graph REST API via Adobe Workfront Fusion HTTP > Make an OAuth 2.0 request-modulen.

OAuth 2.0-modulkonfiguration för begäran

När du har upprättat en Oauth 2.0-anslutning enligt beskrivningen i Skapa en anslutning för en OAuth begäran 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 visar Workfront Fusion fälten som listas nedan. 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.

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 i Adobe Workfront Fusion.

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 i Adobe Workfront Fusion.
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 att 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 Google Drive >Download 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
Överför ditt certifikat om du vill använda TLS med ditt självsignerade certifikat.
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 matriser. 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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43