DocumentatieWorkfrontHandleiding voor Workfront

HTTP > Make an OAuth 2.0 request module

Last update: Fri Feb 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
NOTE
Adobe Workfront Fusion vereist een Adobe Workfront Fusion naast een Adobe Workfront licentie.

Om een Adobe Workfront Fusion HTTP(S) verzoek aan servers die een vergunning OAuth 2.0 vereisen, moet u eerst een verbinding OAuth tot stand brengen. Adobe Workfront Fusion zorgt ervoor dat alle vraag die met deze verbinding wordt gemaakt de aangewezen vergunningskopballen heeft en automatisch bijbehorende tokens verfrist wanneer vereist.

Workfront Fusion steunt de volgende OAuth 2.0 authentificatiestromen:

  • Vergunningscode-stroom
  • Impliciete stroom

Andere stromen, zoals de Stroom van de Referenties van het Wachtwoord van de Eigenaar van het Middel en de Stroom van de Referenties van de Cliënt, worden niet automatisch gesteund door deze module.

Voor meer informatie over OAuth 2.0 authentificatie, zie OAuth 2.0 Authorization Framework.

NOTE
Als u verbinding maakt met een product van de Adobe dat momenteel geen speciale aansluiting heeft, raden we u aan de Adobe Authenticator-module te gebruiken.
Zie voor meer informatie Adobe Authenticator-module.

Toegangsvereisten

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

Adobe Workfront plan*
Pro of hoger
Adobe Workfront licentie*
Plan, Work
Adobe Workfront Fusion licentie**

Huidige vergunningsvereiste: Neen Workfront Fusion vergunningsvereiste.

of

Vereisten voor oudere licenties: Workfront Fusion voor werkautomatisering en -integratie

Product

Huidige productvereiste: als u beschikt over Select of Prime Adobe Workfront Abonnement, uw organisatie moet Adobe Workfront Fusion alsmede Adobe Workfront om de in dit artikel beschreven functionaliteit te gebruiken. Workfront Fusion is opgenomen in de Ultimate Workfront plannen.

of

Vereisten voor verouderd product: uw organisatie moet het product kopen Adobe Workfront Fusion alsmede Adobe Workfront om de in dit artikel beschreven functionaliteit te gebruiken.

Neem contact op met uw Workfront beheerder.

Voor informatie over Adobe Workfront Fusion licenties, zie Adobe Workfront Fusion licenties

Verbinding maken voor een OAuth verzoek

Algemene instructies voor het maken van een verbinding in het dialoogvenster HTTP > Make an OAuth 2.0 request module

  1. Een OAuth-client maken in het dialoogvenster target de dienst waarmee u wilt Adobe Workfront Fusion om te communiceren. Deze optie is meestal te vinden in het dialoogvenster Developer van de dienst.

    1. Wanneer u een client maakt, voert u de juiste URL in het dialoogvenster Redirect URL of Callback URL veld:

      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. Nadat u de cliënt creeert, toont de bepaalde dienst 2 sleutels: Client ID en Client Secret. Sommige services noemen dit App Key en App Secret . Sla de sleutel en het geheim op een veilige locatie op, zodat u deze kunt opgeven wanneer u de verbinding maakt in Workfront Fusion.

  2. Zoek de Authorize URI en Token URI in de API-documentatie van de desbetreffende service. Dit zijn URL-adressen waardoor Workfront Fusion communiceert met de target service. De adressen dienen voor vergunning OAuth.

    note note
    NOTE
    Als de dienst Impliciete stroom gebruikt, zult u slechts nodig hebben Authorize URI.
    note info
    INFO
    Voorbeeld: Yahoo-adressen:
    • URI toestaan:
    https://api.login.yahoo.com/oauth2/request_auth
    • Token-URI:
    https://api.login.yahoo.com/oauth2/get_token

  3. (Voorwaardelijk) als de doeldienst werkingsgebied (toegangsrechten) gebruikt, controleer hoe de dienst individueel werkingsgebied scheidt en zorg ervoor u de separator in de geavanceerde montages dienovereenkomstig plaatst. Als het scheidingsteken niet correct is ingesteld, Workfront Fusion kan geen verbinding maken en er is een ongeldige bereikfout opgetreden.

  4. Nadat u de bovenstaande stappen hebt uitgevoerd, kunt u de OAuth-verbinding maken in Workfront Fusion. Voeg de OAuth 2.0 HTTP(S) verzoek en reactieverwerkingsmodule aan uw scenario toe.

  5. Klik in het veld Verbinding van de module op Add.

  6. Vul de volgende velden in om een verbinding te maken:

    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 Voer de naam van de verbinding in.
    Flow type

    Selecteer de stroom voor het verkrijgen van tokens.

    • Authorization Code: Voer de Authorize URI en Token URI uit de API-documentatie van de service.
    • Implicit: Voer de Authorize URI uit de API-documentatie van de service.
    Scope Afzonderlijk bereik toevoegen. U kunt deze informatie in de bepaalde de ontwikkelaar (API) documentatie van de dienst vinden.
    Scope separator

    Selecteer door welk bereik de bovenstaande gegevens moeten worden gescheiden. U kunt deze informatie in de bepaalde de ontwikkelaar (API) documentatie van de dienst vinden.

    Waarschuwing: als het scheidingsteken niet correct is ingesteld, Workfront Fusion kan geen verbinding maken en er is een ongeldige bereikfout opgetreden.
    Client ID Voer de client-id in. U hebt de client-id opgehaald toen u een OAuth-client hebt gemaakt in de service waarmee u verbinding wilt maken.
    Client Secret Voer het clientgeheim in. U verkrijgt het Geheime punt van de Cliënt toen u een cliënt OAuth in de dienst creeerde u wilt verbinden.
    Authorize parameters

    Voeg om het even welke parameters toe die u in de vergunningsvraag wilt omvatten. De volgende standaardparameters worden altijd automatisch opgenomen en hoeven niet te worden toegevoegd.

    Standaardparameters:

    • response_type

      code for Authorization Code flow en token for 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

      De client-id die u hebt ontvangen bij het maken van de account
    Access token parameters

    Voeg om het even welke parameters toe die u in de symbolische vraag wilt omvatten. De volgende standaardparameters worden altijd automatisch opgenomen en hoeven niet te worden toegevoegd.

    Standaardparameters:

    • 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: De client-id die u hebt ontvangen bij het maken van de account, wordt automatisch opgenomen in de aanvraaginstantie

    • client_geheime: Het clientgeheim dat u hebt ontvangen bij het maken van de account, wordt automatisch opgenomen in de aanvraaginstantie

    • code: De code die door het vergunningsverzoek wordt geretourneerd

    Opmerking:

    De norm OAuth 2.0 steunt minstens 2 methodes van cliëntauthentificatie tijdens deze stap (client_secret_basic en client_secret_post). Workfront Fusion verzendt automatisch de opgegeven client-id en verzendt het geheim door de client_secret_post methode. Daarom zijn deze parameters automatisch inbegrepen als deel van het symbolische verzoeklichaam.

    Voor meer informatie over OAuth 2.0 authentificatie, zie OAuth 2.0 Authorization Framework.
    Refresh token parameters

    Voeg om het even welke parameters toe die u in de symbolische vraag wilt omvatten. De volgende standaardparameters worden altijd automatisch opgenomen en hoeven niet te worden toegevoegd.

    Standaardparameters:

    • grant_type: refresh_token

    • refresh_token: De meest recente vernieuwingstoken die door de dienst wordt verkregen u met verbindt

    • client_id: De client-id die u hebt ontvangen bij het maken van de account, wordt automatisch opgenomen in de aanvraaginstantie

    • client_secret: Het clientgeheim dat u hebt ontvangen bij het maken van de account, wordt automatisch opgenomen in de aanvraaginstantie

    Opmerking:

    De norm OAuth 2.0 steunt minstens 2 methodes van cliëntauthentificatie tijdens deze stap (client_secret_basic en client_secret_post). Workfront Fusion verzendt automatisch de opgegeven client-id en verzendt het geheim door de client_secret_post methode. Daarom zijn deze parameters automatisch inbegrepen als deel van het symbolische verzoeklichaam.

    Voor meer informatie over OAuth 2.0 authentificatie, zie OAuth 2.0 Authorization Framework.
    Custom Headers

    Geef aanvullende sleutels en waarden op die u in de koptekst van Token en Refresh Token stappen.

    Opmerking:

    De norm OAuth 2.0 steunt minstens 2 methodes van cliëntauthentificatie tijdens deze stap (client_secret_basic en client_secret_post). Workfront Fusion biedt niet automatisch ondersteuning voor client_secret_basic methode. Als de dienst die u verbindt om Cliënt te verwachten - identiteitskaart en Geheim om in één enkel koord worden gecombineerd en dan base64 die in de kopbal van de Vergunning wordt gecodeerd, dan zou u die kopbal en zeer belangrijke waarde hier moeten toevoegen.

    Voor meer informatie over OAuth 2.0 authentificatie, zie OAuth 2.0 Authorization Framework.
    Token placement

    Geef op of u het token wilt verzenden in het dialoogvenster header, query stringof in beide gevallen wanneer verbinding wordt gemaakt met de opgegeven URL.

    Tokens worden meestal verzonden in de verzoekkopbal.
    Header token name Voer de naam van het machtigingstoken in de koptekst in. Standaard: Bearer.
    Query string parameter name Voer de naam van het verificatietoken in de queryreeks in. Standaard: access_token.

  7. Klikken Continue om verbindingsinstellingen op te slaan.

  8. Doorgaan naar OAuth 2.0 opstelling van de verzoekmodule.

Instructies voor het maken van een verbinding met Google in de HTTP >Make an OAuth 2.0 request module

In het volgende voorbeeld wordt getoond hoe u de HTTP > Make an OAuth 2.0 request module to connect to Google.

  1. Zorg ervoor dat u een project, gevormde montages OAuth hebt gecreeerd, en uw geloofsbrieven zoals die in worden beschreven geproduceerd Verbinden Adobe Workfront Fusion tot Google Services een aangepaste OAuth-client gebruiken.

  2. Open de HTTP >Make an OAuth 2.0 request -module.

  3. Klikken Add naast het verbindingsvak.

  4. Voer de volgende waarden in:

    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 Voer de naam van de verbinding in.
    Flow type Authorization Code
    Authorize URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Scope Afzonderlijk bereik toevoegen. Zie voor meer informatie over het bereik OAuth 2.O-bereiken voor Google API's in de Google documentatie.
    Scope separator SPACE
    Client ID

    Voer uw Google Client-id.

    Als u een client-id wilt maken, raadpleegt u OAuth-referenties maken in Connect Adobe Workfront Fusion tot Google Services een aangepaste OAuth-client gebruiken.
    Client Secret

    Voer uw Google Clientgeheim.

    Als u een clientgeheim wilt maken, raadpleegt u OAuth-referenties maken in Connect Adobe Workfront Fusion tot Google Services die een aangepaste OAuth-client gebruiken.
    Authorize parameters

    Toevoegen access_type - offline sleutelwaardepaar.

    Opmerking: als u problemen ondervindt met verificatie, bijvoorbeeld bij het vernieuwen van token, kunt u het volgende proberen: prompt - consent sleutelwaardepaar.

  5. Klikken Continue om verbindingsinstellingen op te slaan.

  6. Doorgaan naar OAuth 2.0 opstelling van de verzoekmodule.

Instructies voor verbinding maken met Microsoft Graph API via de HTTP > Make an OAuth 2.0 request module

Voor instructies over Microsoft Graph API, zie Roep de MS Graph REST API via de Adobe Workfront Fusion HTTP > Make an OAuth 2.0 request module.

OAuth 2.0 opstelling van de verzoekmodule

Wanneer u een Oauth 2.0 verbinding zoals beschreven in Verbinding maken voor een OAuth verzoekzet u de module naar wens in. Alle toestemmingstokens worden automatisch inbegrepen in dit verzoek, en in een ander verzoek dat de zelfde verbinding gebruikt.

Wanneer u vormt HTTP >Make an OAuth 2.0 request module, Workfront Fusion geeft de onderstaande velden weer. Een bolde titel in een module wijst op een vereist gebied.

Als u de kaartknoop boven een gebied of een functie ziet, kunt u het gebruiken om variabelen en functies voor dat gebied te plaatsen. Zie voor meer informatie De informatie van de kaart van één module aan een andere binnen Adobe Workfront Fusion.

Connection
Zie voor informatie over het instellen van een verbinding Verbinding maken voor een OAuth-verzoek in dit artikel.
Evaluate all states as errors (except for 2xx and 3xx)

Gebruik deze optie om foutafhandeling in te stellen.

Zie voor meer informatie Foutafhandeling in Adobe Workfront Fusion.

URL
Voer de URL in waarnaar u een aanvraag wilt verzenden, zoals een API-eindpunt, website, enzovoort.
Method
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Zie voor meer informatie HTTP-aanvraagmethoden in Adobe Workfront Fusion.
Headers
Voeg de kopteksten van het verzoek toe in de vorm van een standaard JSON-object. Bijvoorbeeld: {"Content-type":"application/json"}
Query String
Voer de gewenste sleutel-waardeparen voor de query in.
Body type

De hoofdtekst van HTTP is de gegevensbytes die in een HTTP- transactiebericht onmiddellijk na de kopballen worden overgebracht als er om het even welk zijn om worden gebruikt.

  • Raw

    Het type Raw-hoofdtekst is over het algemeen geschikt voor de meeste HTTP-hoofdtekstaanvragen, zelfs in situaties waarin in de documentatie van de ontwikkelaar geen gegevens zijn opgegeven die moeten worden verzonden.

    Geef een vorm op voor het parseren van de gegevens in het dialoogvenster Content type veld.

    Ondanks het geselecteerde inhoudstype, worden de gegevens ingevoerd in om het even welk formaat dat door de ontwikkelaarsdocumentatie wordt bepaald of wordt vereist.

  • Application/x-www-form-urlencoded

    Dit lichaamstype is aan POST gegevens gebruikend application/x-www-form-urlencoded.

    Voor application/x-www-form-urlencoded, is de hoofdtekst van het HTTP-bericht dat naar de server wordt verzonden, in wezen één queryreeks. De toetsen en waarden worden gecodeerd in sleutelwaardeparen, gescheiden door & en met een = tussen de toets en de waarde.

    Voor binaire gegevens, use multipart/form-data in plaats daarvan.

    Voorbeeld:

    Voorbeeld van de resulterende HTTP-aanvraagindeling:

    field1=value1&field2=value2

  • Multipart/form-data

    De Multipart/form-data is een multipart HTTP-aanvraag die wordt gebruikt om bestanden en gegevens te verzenden. Het wordt doorgaans gebruikt om bestanden naar de server te uploaden.

    Voeg velden toe die in de aanvraag moeten worden verzonden. Elk veld moet een sleutelwaardepaar bevatten.

    • Text

      Voer de sleutel en waarde in die binnen de aanvraaginstantie moeten worden verzonden.

    • File

      Voer de sleutel in en geef het bronbestand op dat u wilt verzenden in de hoofdtekst van de aanvraag.

      Wijs het bestand toe dat u uit de vorige module wilt uploaden (bijvoorbeeld HTTP >Get a File of Google Drive >Download a File)of voer de bestandsnaam en de bestandsgegevens handmatig in.

Parse response

Schakel deze optie in om reacties automatisch te parseren en JSON- en XML-reacties om te zetten zodat u deze niet hoeft te gebruiken JSON > Parse JSON of XML > Parse XML modules.

Voordat u geparseerde JSON- of XML-inhoud kunt gebruiken, voert u de module één keer handmatig uit, zodat de module de inhoud van de reactie herkent en deze in volgende modules kunt toewijzen.

Timeout
Voer de time-out van het verzoek in seconden in (1-300). De standaardwaarde is 40 seconden.
Share cookies with other HTTP modules
Schakel deze optie in om cookies van de server te delen met alle HTTP-modules in uw scenario.
Self-signed certificate
Upload uw certificaat als u TLS wilt gebruiken met uw zelfondertekende certificaat.
Reject connections that are using unverified (self-signed) certificates
Schakel deze optie in om verbindingen die niet-geverifieerde TLS-certificaten gebruiken, te weigeren.
Follow redirect
Schakel deze optie in om de URL-omleidingen te volgen met 3xx-reacties.
Follow all redirects
Schakel deze optie in om de URL-omleidingen te volgen met alle antwoordcodes.
Disable serialization of multiple same query string keys as arrays
Standaard, Workfront Fusion Verwerkt meerdere waarden voor dezelfde URL-querytekenreeks-parametersleutel als arrays. Bijvoorbeeld: www.test.com?foo=bar&foo=baz wordt omgezet in www.test.com?foo[0]=bar&foo[1]=baz. Activeer deze optie om deze functie uit te schakelen.
Request compressed content

Schakel deze optie in om een gecomprimeerde versie van de website aan te vragen.

Hiermee voegt u een Accept-Encoding om gecomprimeerde inhoud aan te vragen.

Use Mutual TLS

Schakel deze optie in om Wederzijdse TLS te gebruiken in de HTTP-aanvraag.

Zie voor meer informatie over wederzijdse TLS Gebruik wederzijds TLS in HTTP-modules in Adobe Workfront Fusion.

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