HTTP > Effectuer une requête OAuth 2.0
Pour envoyer une requête HTTP(S) Adobe Workfront Fusion aux serveurs nécessitant une autorisation OAuth 2.0, vous devez d’abord créer une connexion OAuth. Adobe Workfront Fusion s’assure que tous les appels effectués avec cette connexion comportent les en-têtes d’autorisation appropriés et actualisent automatiquement les jetons associés si nécessaire.
Workfront Fusion prend en charge les flux d’authentification OAuth 2.0 suivants :
- Flux de code d’autorisation
- Flux implicite
D’autres flux, tels que Flux d’informations d’identification de mot de passe du propriétaire des ressources et Flux d’informations d’identification du client, ne sont pas automatiquement pris en charge par ce module.
Pour plus d’informations sur l’authentification OAuth 2.0, voir The OAuth 2.0 Authorization Framework.
Conditions d’accès
Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :
Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Création d'une connexion pour une requête OAuth
Instructions générales pour la création d’une connexion dans le module HTTP > Effectuer une requête OAuth 2.0
-
Créez un client OAuth dans le service target avec lequel vous souhaitez que Adobe Workfront Fusion communique. Cette option se trouve probablement dans la section Développeur du service donné.
-
Lors de la création d’un client, saisissez l’URL appropriée dans le champ
Redirect URL
ouCallback URL
:table 0-row-2 1-row-2 Amériques/APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
Une fois le client créé, le service donné affiche 2 clés :
Client ID
etClient Secret
. Certains services appellent cesApp Key
etApp Secret
. Enregistrez la clé et le secret dans un emplacement sécurisé afin de pouvoir les fournir lors de la création de la connexion dans Workfront Fusion.
-
-
Recherchez les
Authorize URI
etToken URI
dans la documentation API du service donné. Il s’agit d’adresses URL par lesquelles Workfront Fusion communique avec le service target. Les adresses servent à l’autorisation OAuth.note note NOTE Si le service utilise le flux Implicit, vous n’aurez besoin que de Authorize URI
.note info INFO Exemple : Adresses Yahoo : - Authorize URI :
https://api.login.yahoo.com/oauth2/request_auth
- URI du jeton :
https://api.login.yahoo.com/oauth2/get_token
-
(Conditionnel) Si le service cible utilise des portées (droits d’accès), vérifiez comment le service sépare les portées individuelles et assurez-vous de définir le séparateur dans les paramètres avancés en conséquence. Si le séparateur n’est pas défini correctement, Workfront Fusion ne parvient pas à créer la connexion et vous recevez une erreur de plage non valide.
-
Après avoir suivi les étapes ci-dessus, vous pouvez commencer à créer la connexion OAuth dans Workfront Fusion. Ajoutez le module de traitement des requêtes et réponses HTTP(S) OAuth 2.0 à votre scénario.
-
Dans le champ Connexion du module, cliquez sur Ajouter.
-
Renseignez les champs suivants pour créer une connexion :
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 Saisissez le nom de la connexion. Type de flux Sélectionnez le flux permettant d’obtenir les jetons.
- Authorization Code : saisissez les
Authorize URI
etToken URI
de la documentation de l’API du service. - Implicit : saisissez le
Authorize URI
de la documentation de l’API du service.
Scope Ajoutez des portées individuelles. Vous trouverez ces informations dans la documentation destinée aux développeurs (API) du service donné. Séparateur de portée Sélectionnez les portées saisies ci-dessus à séparer. Vous trouverez ces informations dans la documentation destinée aux développeurs (API) du service donné.
Avertissement : si le séparateur n’est pas défini correctement, Workfront Fusion ne parvient pas à créer la connexion et vous recevez une erreur de plage non valide.
Client ID Saisissez l’ID client. Vous avez obtenu l’identifiant du client lorsque vous avez créé un client OAuth dans le service que vous souhaitez connecter. Client Secret Saisissez le secret client. Vous avez obtenu le secret client lorsque vous avez créé un client OAuth dans le service que vous souhaitez connecter. Autoriser les paramètres Ajoutez tous les paramètres que vous souhaitez inclure dans l’appel d’autorisation. Les paramètres standard suivants sont toujours automatiquement inclus et ne doivent pas être ajoutés.
Paramètres standard :
-
response_type
code
pour Flux de code d’autorisation ettoken
pour Flux implicite -
redirect_uri
table 0-row-2 1-row-2 layout-auto html-authored no-header Amériques/APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id
Identifiant client que vous avez reçu lors de la création du compte
Paramètres du jeton d’accès Ajoutez les paramètres que vous souhaitez inclure dans l’appel de jeton. Les paramètres standard suivants sont toujours automatiquement inclus et ne doivent pas être ajoutés.
Paramètres standard :
-
grant_type :
authorization_code
-
redirect_uri:
table 0-row-2 1-row-2 layout-auto html-authored no-header Amériques/APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id : l’ID client que vous avez reçu lors de la création du compte est automatiquement inclus dans le corps de la requête.
-
client_secret : le secret client que vous avez reçu lors de la création du compte est automatiquement inclus dans le corps de la requête.
-
code : code renvoyé par la demande d’autorisation
Remarque :
La norme OAuth 2.0 prend en charge au moins 2 méthodes d’authentification du client au cours de cette étape (
client_secret_basic
etclient_secret_post
). Workfront Fusion envoie automatiquement l’ID client spécifié et le secret par le biais de la méthodeclient_secret_post
. Par conséquent, ces paramètres sont inclus automatiquement dans le corps de la requête de jeton.Pour plus d’informations sur l’authentification OAuth 2.0, voir The OAuth 2.0 Authorization Framework.
Paramètres du jeton d’actualisation Ajoutez les paramètres que vous souhaitez inclure dans l’appel de jeton. Les paramètres standard suivants sont toujours automatiquement inclus et ne doivent pas être ajoutés.
Paramètres standard :
-
grant_type :
refresh_token
-
refresh_token : jeton d’actualisation le plus récent obtenu par le service auquel vous vous connectez.
-
client_id : l’ID client que vous avez reçu lors de la création du compte est automatiquement inclus dans le corps de la requête.
-
client_secret : le secret client que vous avez reçu lors de la création du compte est automatiquement inclus dans le corps de la requête
Remarque :
La norme OAuth 2.0 prend en charge au moins 2 méthodes d’authentification du client au cours de cette étape (
client_secret_basic
etclient_secret_post
). Workfront Fusion envoie automatiquement l’ID client spécifié et le secret par le biais de la méthodeclient_secret_post
. Par conséquent, ces paramètres sont inclus automatiquement dans le corps de la requête de jeton.Pour plus d’informations sur l’authentification OAuth 2.0, voir The OAuth 2.0 Authorization Framework.
En-têtes personnalisés Indiquez les clés et valeurs supplémentaires à inclure dans l’en-tête des étapes Token et RActualiser le jeton .
Remarque :
La norme OAuth 2.0 prend en charge au moins 2 méthodes d’authentification du client au cours de cette étape (
client_secret_basic
etclient_secret_post
). Workfront Fusion ne prend pas automatiquement en charge la méthodeclient_secret_basic
. Si le service que vous vous connectez à suppose que l’identifiant du client et le secret du client soient combinés en une seule chaîne, puis codés en base64 dans l’en-tête Authorization, vous devez ajouter cet en-tête et cette valeur key ici.Pour plus d’informations sur l’authentification OAuth 2.0, voir The OAuth 2.0 Authorization Framework.
Token placement Choisissez d’envoyer le jeton dans l’en-tête, la chaîne de requête ou dans les deux lors de la connexion à l’URL spécifiée.
Les jetons sont le plus souvent envoyés dans l’en-tête de la requête.
Nom du jeton d’en-tête Saisissez le nom du jeton d’autorisation dans l’en-tête . Valeur par défaut : Bearer
.Nom du paramètre de chaîne de requête Saisissez le nom du jeton d’autorisation dans la chaîne de requête. Valeur par défaut : access_token
. - Authorization Code : saisissez les
-
Cliquez sur Continuer pour enregistrer les paramètres de connexion.
-
Passez à la configuration du module de requête OAuth 2.0.
Instructions de création d’une connexion à Google dans le HTTP >Créer un module de requête OAuth 2.0
L’exemple suivant montre comment utiliser le module de requête HTTP > Make an OAuth 2.0 pour se connecter à Google.
-
Assurez-vous d’avoir créé un projet, configuré les paramètres OAuth et généré vos informations d’identification comme décrit dans Se connecter Adobe Workfront Fusion à Google Services à l’aide d’un client OAuth personnalisé.
-
Ouvrez le module HTTP >Créer une requête OAuth 2.0 .
-
Cliquez sur Ajouter en regard de la zone de connexion.
-
Saisissez les valeurs suivantes :
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 Saisissez le nom de la connexion. Type de flux Authorization Code Autoriser l’URI https://accounts.google.com/o/oauth2/v2/auth
Token URI https://www.googleapis.com/oauth2/v4/token
Scope Ajoutez des portées individuelles. Pour plus d’informations sur les portées, voir Portées OAuth 2.O pour les Google APIs dans la documentation Google. Séparateur de portée SPACE Client ID Saisissez votre ID client Google.
Pour créer un ID client, voir Création des informations d’identification OAuth dans Connect Adobe Workfront Fusion vers Google Services à l’aide d’un client OAuth personnalisé.
Client Secret Saisissez votre secret client Google.
Pour créer un secret client, voir Création des informations d’identification OAuth dans Connect Adobe Workfront Fusion vers Google Services à l’aide d’un client OAuth personnalisé.
Autoriser les paramètres Ajoutez
access_type
-offline
paire clé-valeur.Remarque : Si vous rencontrez des problèmes d’authentification, par exemple avec l’actualisation des jetons, essayez d’ajouter la paire
prompt
-consent
clé-valeur. -
Cliquez sur Continuer pour enregistrer les paramètres de connexion.
-
Passez à la configuration du module de requête OAuth 2.0.
Instructions pour se connecter à Microsoft Graph API via le module HTTP > Effectuer une requête OAuth 2.0
Pour obtenir des instructions sur Microsoft Graph API, voir Appel de MS Graph REST API via le Adobe Workfront Fusion HTTP > Lancer une requête OAuth 2.0 module.
Configuration du module de requête OAuth 2.0
Lorsque vous avez établi une connexion Oauth 2.0 comme décrit dans Création d’une connexion pour une OAuth requête, continuez à configurer le module suivant vos besoins. Tous les jetons d’autorisation sont automatiquement inclus dans cette requête, ainsi que dans toute autre requête qui utilise la même connexion.
Lorsque vous configurez le module HTTP >Make an OAuth 2.0 request , Workfront Fusion affiche les champs répertoriés ci-dessous. Un titre en gras dans un module indique un champ obligatoire.
Si le bouton de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, consultez Mapper les informations d’un module à un autre dans Adobe Workfront Fusion.