HTTP > Make an OAuth 2.0 request module
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.
Toegangsvereisten
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:
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
-
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.
-
Wanneer u een client maakt, voert u de juiste URL in het veld
Redirect URL
ofCallback 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
-
Nadat u de client hebt gemaakt, geeft de opgegeven service twee toetsen weer:
Client ID
enClient Secret
. Sommige services roepen dezeApp Key
enApp 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.
-
-
Zoek naar
Authorize URI
enToken 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. -
(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.
-
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.
-
Klik in het veld Verbinding van de module op Add .
-
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
enToken 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 entoken
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
enclient_secret_post
). Workfront Fusion verzendt automatisch de opgegeven client-id en -geheim via de methodeclient_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
enclient_secret_post
). Workfront Fusion verzendt automatisch de opgegeven client-id en -geheim via de methodeclient_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
enclient_secret_post
). Workfront Fusion biedt niet automatisch ondersteuning voor de methodeclient_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
. - Authorization Code: Voer de
-
Klik op Continue om de verbinding op te slaan en terug te keren naar de module.
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 .
-
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.
-
Open de module HTTP > Make an OAuth 2.0 request
-
Klik in een willekeurige module op Add naast het vak Verbinding.
-
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. -
Klik op Continue om verbindingsinstellingen op te slaan.
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.