​ HTTP ​ > ​ maak een OAuth 2.0 verzoek ​ module

Laatst bijgewerkt: 4 maart 2025
  • Onderwerpen:
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 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:

Adobe Workfront-pakketAlle
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 Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen.

Verbinding maken voor een OAuth -aanvraag

Algemene instructies voor het creëren van een verbinding in ​ HTTP ​ > ​ maak een OAuth 2.0 verzoek ​ module

  1. Maak een OAuth-client in de target -service waarmee Adobe Workfront Fusion moet communiceren. Deze optie wordt zeer waarschijnlijk gevonden in de ​ sectie van de Ontwikkelaar ​ van de bepaalde dienst.

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

      Amerika/APAChttps://app.workfrontfusion.com/oauth/cb/oauth2
      EMEAhttps://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
    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 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 HTTP > van OAuth 2 aanvraagmodule aan uw scenario toe.

  5. Op het gebied van de Verbinding van de module, voegt de klik ​ ​toe.

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

    Connection nameVoer de naam van de verbinding in.
    -omgevingSelecteer of u een productie- of niet-productieomgeving gebruikt.
    -typeSelecteer of u een serviceaccount of een persoonlijke account gebruikt.
    Flow type

    Selecteer de stroom voor het verkrijgen van tokens.

    • Authorization Code : Ga Authorize URI en Token URI van de API documentatie van de dienst in.
    • Impliciet : ga Authorize URI van de API documentatie van de dienst in.
    -bereikAfzonderlijk bereik toevoegen. U kunt deze informatie in de bepaalde de ontwikkelaar (API) documentatie van de dienst vinden.
    Scheidingsteken-bereik

    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 IDVoer 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 SecretVoer 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.
    autoriseert 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 voor de stroom van de Code van de Vergunning en token voor impliciete stroom

    • redirect_uri

      Amerika/APAChttps://app.workfrontfusion.com/oauth/cb/oauth2
      EMEAhttps://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id

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

    Access-tokenparameters

    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:

      Amerika/APAChttps://app.workfrontfusion.com/oauth/cb/oauth2
      EMEAhttps://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id : De cliënt identiteitskaart u ontving toen het creëren van de rekening is automatisch inbegrepen in het verzoeklichaam

    • 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.

    vernieuwen symbolenparameters

    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

    • verfrist_token : Het meest recente vernieuwingstoken dat wordt verkregen door de service waarmee u verbinding maakt

    • client_id : De cliënt identiteitskaart u ontving toen het creëren van de rekening is automatisch inbegrepen in het verzoeklichaam

    • client_geheime : Het geheim van de Cliënt u ontving toen het creëren van de rekening is automatisch inbegrepen in het verzoeklichaam

    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.

    - Aangepaste kopteksten

    Geef aanvullende sleutels en waarden op die moeten worden opgenomen in de koptekst van de stappen Token en RVernieuwt token.

    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.

    Tokenplaatsing

    Selecteer of het token in de header, query string of in beide moet worden verzonden wanneer verbinding wordt gemaakt met de opgegeven URL.

    Tokens worden meestal verzonden in de verzoekkopbal.

    naam van kopteksttokenVoer de naam van het machtigingstoken in de koptekst in. Standaard: Bearer.
    naam van parameterparameter voor query-tekenreeksVoer de naam van het verificatietoken in de queryreeks in. Standaard: access_token.

  7. Klik verdergaan om de verbinding te bewaren en aan de module terug te keren.

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

Instructies voor het creëren van een verbinding aan Google in ​ HTTP ​ > ​ maak een OAuth 2.0 verzoekmodule ​

Het volgende voorbeeld toont hoe te om ​ HTTP ​ te gebruiken > ​ maak een OAuth 2.0 ​ verzoekmodule om met Google te verbinden.

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

  2. Open ​ HTTP ​ > ​ maak een OAuth 2.0 verzoek ​ module.

  3. In om het even welke module, voegt de klik toe naast het vakje van de Verbinding.

  4. Voer de volgende waarden in:

    Connection nameVoer een naam in voor de verbinding.
    -omgevingSelecteer of u een productie- of niet-productieomgeving gebruikt.
    -typeSelecteer of u een serviceaccount of een persoonlijke account gebruikt.
    Flow typeAuthorization Code
    autoriseer URIhttps://accounts.google.com/o/oauth2/v2/auth
    Token-URIhttps://www.googleapis.com/oauth2/v4/token
    -bereikAfzonderlijk bereik toevoegen. Voor meer informatie over werkingsgebied, zie OAuth 2.O Scopes voor Google APIsin de Google documentatie.
    Scheidingsteken-bereikSPACE
    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 .

    autoriseert 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 verdergaan om verbindingsmontages te bewaren.

  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 ​ HTTP ​ vormt > ​ maak een OAuth 2.0 verzoek ​ module, Workfront Fusion toont de hieronder vermelde gebieden. 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.

Kaart knevel

-verbindingVoor informatie bij vestiging een verbinding, zie een verbinding voor een OAuth verzoekin dit artikel creëren.
evalueert alle staten als fouten (behalve 2xx en 3xx)

Gebruik deze optie om foutafhandeling in te stellen.

Voor meer informatie, zie de behandeling van de Fout.

URLVoer de URL in waarnaar u een aanvraag wilt verzenden, zoals een API-eindpunt, website, enzovoort.
, methodeSelecteer de HTTP- verzoekmethode u de API vraag moet vormen. Voor meer informatie, zie HTTP- verzoekmethodes.
-koptekstenVoeg de kopteksten van het verzoek toe in de vorm van een standaard JSON-object. Bijvoorbeeld: {"Content-type":"application/json"}
-queryreeksVoer 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 -inhoudstype.

    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

    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.

    • Tekst

      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 vanuit de vorige module wilt uploaden (bijvoorbeeld HTTP > Get 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 niet JSON > Parse JSON of XML > Parse XML modules moet 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.

TimeoutVoer de time-out van het verzoek in seconden in (1-300). De standaardwaarde is 40 seconden.
Delen cookies met andere HTTP-modulesSchakel deze optie in om cookies van de server te delen met alle HTTP-modules in uw scenario.
Zelfondertekend certificaatOm 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.
weigert verbindingen die niet-geverifieerde (zelf-ondertekende) certificaten gebruikenSchakel deze optie in om verbindingen die niet-geverifieerde TLS-certificaten gebruiken, te weigeren.
Volg omleidingSchakel deze optie in om de URL-omleidingen te volgen met 3xx-reacties.
Volg alle omleidingenSchakel deze optie in om de URL-omleidingen te volgen met alle antwoordcodes.
onbruikbaar maakt rangschikking van veelvoudige zelfde sleutels van het vraagkoord zoals seriesStandaard 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.
-verzoek gecomprimeerde inhoud

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.

gebruikt wederzijds 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.

Vorige paginaHTTP > Make a Basic Authorization request module
Volgende paginaHTTP > Make a Client Certificate Authorization request module

Workfront