HTTP > Make an OAuth 2.0 request module

NOTE
Adobe Workfront Fusion vereist naast een Adobe Workfront-licentie een Adobe Workfront Fusion-licentie.

Als u een Adobe Workfront Fusion HTTP(S)-aanvraag wilt indienen bij servers die een OAuth 2.0-autorisatie 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 Adobe-product 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

Breid uit om de toegangseisen voor de functionaliteit in dit artikel weer te geven.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-pakket Alle
Adobe Workfront-licentie

Nieuw: Standaard

of

Huidig: Werk of hoger

Adobe Workfront Fusion-licentie**

Huidig: Geen Workfront Fusion-licentievereisten

of

Verouderd: Workfront Fusion for Work Automation and Integration

Product

Nieuw:

  • Select- of Prime Workfront-pakket: uw organisatie moet Adobe Workfront Fusion aanschaffen.
  • Ultimate Workfront-pakket: Workfront Fusion is inbegrepen.

of

Huidig: Uw organisatie moet Adobe Workfront Fusion aanschaffen.

Voor meer detail over de informatie in deze lijst, zie vereisten van de Toegang in documentatie.

Voor informatie over de vergunningen van de Fusie van Adobe Workfront, zie de Fusie van Adobe Workfront 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 . Sommige services roepen deze App Key en App Secret aan. 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.
  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 Workfront Fusion geen verbinding maken en ontvangt u een ongeldige bereikfout.

  4. Nadat u de bovenstaande stappen hebt uitgevoerd, kunt u de OAuth-verbinding maken in Workfront Fusion. Voeg HTTP > van OAuth 2 aanvraagmodule 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 17-row-2 18-row-2 layout-auto html-authored no-header
    Connection name Voer de naam van de verbinding in.
    Environment Selecteer of u een productie- of niet-productieomgeving gebruikt.
    Type Selecteer of u een serviceaccount of een persoonlijke account gebruikt.
    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 Workfront Fusion geen verbinding maken 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 de verbinding op te slaan en terug te keren naar de module.

  8. Ga aan te werk vormen doe een OAuth 2.0 verzoekmodule.

Instructies voor het maken van een verbinding met Google in het dialoogvenster 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 artikel worden beschreven Connect de Fusie van Adobe Workfront aan Google Services gebruikend een douaneOAuth cliëntgeproduceerd.

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

  3. Klik in een willekeurige module op Add naast het vak Verbinding.

  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 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name Voer een naam in voor de verbinding.
    Environment Selecteer of u een productie- of niet-productieomgeving gebruikt.
    Type Selecteer of u een serviceaccount of een persoonlijke account gebruikt.
    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 het artikel Connect Adobe Workfront Fusion tot Google Services gebruikend een cliënt van douaneOAuth leiden.

    Client Secret

    Voer uw Google clientgeheim in.

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

    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 te werk vormen doe een OAuth 2.0 verzoekmodule.

Vorm Make een OAuth 2.0 verzoekmodule

Nadat u een verbinding OAuth 2.0 hebt 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 de Fusie van Adobe Workfront.

Kaart knevel

Connection
Voor informatie bij vestiging een verbinding, zie een verbinding voor een OAuth verzoekin dit artikel creëren.
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.

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. Voor meer informatie, zie HTTP- verzoekmethodes.
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 type body is voor POST-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 bestand dat u uit de vorige module wilt uploaden (bijvoorbeeld HTTP > Get a File ) toe 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 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
Om een zelfondertekend certificaat of een privé sleutel voor TLS te gebruiken, klik Extraheren en verstrek het van het certificaat of privé sleutel dossier en wachtwoord.
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
Workfront Fusion verwerkt standaard meerdere waarden voor dezelfde URL-queryparametersleutel 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 de Fusie van Adobe Workfront.

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