DocumentatieWorkfrontHandleiding voor Workfront

HTTP > Make an OAuth 2.0 request module

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

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

Als u een Adobe Workfront Fusion HTTP(S)-aanvraag wilt indienen bij servers die een OAuth 2.0-verificatie vereisen, moet u eerst een OAuth-verbinding maken. 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 ondersteunt de volgende OAuth 2.0-verificatiestromen:

  • 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 het Kader van de Vergunning OAuth 2.0.

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.
Voor meer informatie, zie module van Adobe Authenticator.

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 licentievereiste: geen Workfront Fusion licentievereiste.

of

Vereiste voor oudere licenties: Workfront Fusion voor werkautomatisering en integratie

Product

Huidige productvereiste: als u het abonnement Select of Prime Adobe Workfront hebt, moet uw organisatie Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken. Workfront Fusion wordt opgenomen in het Ultimate Workfront -abonnement.

of

Vereiste verouderd product: uw organisatie moet Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken.

Neem contact op met de Workfront -beheerder als u wilt weten welk abonnement, licentietype of toegang u hebt.

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

Verbinding maken voor een OAuth -aanvraag

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

  1. Maak een OAuth-client in de target -service waarmee Adobe Workfront Fusion moet communiceren. Deze optie is meestal te vinden in het gedeelte Developer van de opgegeven service.

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

      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 client hebt gemaakt, geeft de opgegeven service twee toetsen weer: Client ID en Client Secret . Deze worden door sommige services App Key en App Secret genoemd. 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 naar Authorize URI en Token URI in de API-documentatie van de opgegeven service. Dit zijn URL-adressen waarmee Workfront Fusion communiceert met de target -service. De adressen dienen voor vergunning OAuth.

    note note
    NOTE
    Als de service impliciete stroom gebruikt, hebt u alleen de Authorize URI nodig.
    note info
    INFO
    Voorbeeld: de adressen van Yahoo:
    • 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, kan de verbinding niet tot stand worden gebracht in Workfront Fusion en ontvangt u een ongeldige bereikfout.

  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 in uit de API-documentatie van de service.
    • Implicit: Voer de Authorize URI in 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, kan de verbinding niet tot stand worden gebracht in Workfront Fusion en ontvangt u een ongeldige bereikfout.
    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 geheim van de Cliënt u ontving toen het creëren van de rekening is automatisch inbegrepen in het verzoeklichaam

    • code : De code die door het vergunningsverzoek is teruggekeerd

    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 -geheim via de methode client_secret_post . Daarom zijn deze parameters automatisch inbegrepen als deel van het symbolische verzoeklichaam.

    Voor meer informatie over OAuth 2.0 authentificatie, zie het Kader van de Vergunning OAuth 2.0.
    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 -geheim via de methode client_secret_post . Daarom zijn deze parameters automatisch inbegrepen als deel van het symbolische verzoeklichaam.

    Voor meer informatie over OAuth 2.0 authentificatie, zie het Kader van de Vergunning OAuth 2.0.
    Custom Headers

    Geef aanvullende sleutels en waarden op die u in de koptekst van de stappen Token en R efresh Token wilt opnemen.

    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 de methode client_secret_basic . 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 het Kader van de Vergunning OAuth 2.0.
    Token placement

    Selecteer of het token in de map header , query string of in beide moet worden verzonden 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. Klik op Continue om verbindingsinstellingen op te slaan.

  8. Ga aan OAuth 2.0 de opstelling van de verzoekmoduleverder.

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

In het volgende voorbeeld ziet u hoe u de aanvraagmodule HTTP > Make an OAuth 2.0 gebruikt om verbinding te maken met Google .

  1. Zorg ervoor dat u een project, gevormde montages OAuth hebt gecreeerd, en uw geloofsbrieven zoals die in worden beschreven verbind Adobe Workfront Fusion met Google Services gebruikend een douaneOAuth cliëntgeproduceerd.

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

  3. Klik op 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. Voor meer informatie over werkingsgebied, zie OAuth 2.O Scopes voor Google APIsin de Google documentatie.
    Scope separator SPACE
    Client ID

    Voer uw Google client-id in.

    Om een cliëntidentiteitskaart tot stand te brengen, zie OAuth Credentialsin Connect Adobe Workfront Fusion tot Google Services gebruikend een douaneOAuth cliëntleiden.
    Client Secret

    Voer uw Google clientgeheim in.

    Om een cliëntgeheim tot stand te brengen, zie OAuth Credentialsin Connect Adobe Workfront Fusion tot Google de Diensten creëren gebruikend een douaneOAuth cliënt.
    Authorize parameters

    Voeg access_type toe - offline zeer belangrijk-waardepaar.

    Nota: Als u authentificatiekwesties, bijvoorbeeld met symbolische verfrissing ervaart, probeer toevoegend prompt - consent zeer belangrijk-waardepaar.

  5. Klik op Continue om verbindingsinstellingen op te slaan.

  6. Ga aan OAuth 2.0 de opstelling van de verzoekmoduleverder.

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

Voor instructies betreffende Microsoft Graph API, zie Vraag MS Graph REST API via 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 die in wordt beschreven Creërend een verbinding voor een OAuth verzoekhebt gevestigd, zet opstelling de module voort zoals gewenst. Alle toestemmingstokens worden automatisch inbegrepen in dit verzoek, en in een ander verzoek dat de zelfde verbinding gebruikt.

Wanneer u de module HTTP > Make an OAuth 2.0 request configureert, geeft Workfront Fusion 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. Voor meer informatie, zie informatie van de Kaart van één module aan een andere in Adobe Workfront Fusion.

Connection
Voor informatie bij vestiging zie een verbinding, Creërend een verbinding voor een OAuth verzoekin dit artikel.
Evaluate all states as errors (except for 2xx and 3xx)

Gebruik deze optie om foutafhandeling in te stellen.

Voor meer informatie, zie de behandeling van de Fout 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 HTTP-aanvraagmethoden in Adobe Workfront Fusion voor meer informatie.
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 voor het parseren van de gegevens op in het veld Content type .

    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 hoofdtype is het POSTEN van gegevens met 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 sleutels en waarden worden gecodeerd in sleutel-waardeparen die door & worden gescheiden en met een = tussen de sleutel en de waarde.

    use multipart/form-data voor binaire gegevens.

    Voorbeeld:

    Voorbeeld van de resulterende HTTP-aanvraagindeling:

    field1=value1&field2=value2

  • Multipart/form-data

    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 dossier toe u van de vorige module (zoals HTTP > Get a File of Google Drive > Download a File) wilt uploaden, of ga de dossier - naam en gegevens manueel in.

Parse response

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

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 handelt Workfront Fusion meerdere waarden af voor dezelfde URL-querytekenreeks-parametersleutel als arrays. www.test.com?foo=bar&foo=baz wordt bijvoorbeeld 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 wordt een Accept-Encoding -header toegevoegd om gecomprimeerde inhoud aan te vragen.

Use Mutual TLS

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

Voor meer informatie over Wederzijdse TLS, zie Gebruik Wederzijdse TLS in de modules van HTTP in Adobe Workfront Fusion.

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