Appeler l’API REST MS Graph
De nombreux services web Microsoft sont accessibles via l’API Microsoft Graph. Vous pouvez créer une connexion à l’API Microsoft Graph à l’aide du module de requête HTTP > Créer une requête OAuth 2.0 de Workfront Fusion .
Conditions d’accès
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Package Adobe Workfront | Tous |
Licence Adobe Workfront |
Nouveau : Standard Ou Actuellement : Travail ou licence supérieure |
Licence Adobe Workfront Fusion ** |
Actuel : aucune exigence de licence Workfront Fusion. Ou Héritée : n’importe laquelle. |
Produit |
Nouveau :
Ou Actuel : votre entreprise doit acheter Adobe Workfront Fusion. |
Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Enregistrement de Workfront Fusion dans le portail d’enregistrement d’applications Microsoft
Pour créer une connexion à l’API REST Microsoft Graph, vous devez d’abord enregistrer Adobe Workfront Fusion.
-
Commencez l’enregistrement d’une nouvelle application comme décrit dans la section Enregistrement d’une application avec la plateforme d’identités Microsoft dans la documentation de Microsoft.
Dans le cadre de l’enregistrement, Microsoft nécessite les informations suivantes :
table 0-row-2 1-row-2 layout-auto html-authored no-header Nom de l’application Saisissez un nom pour l’application, par exemple « Mon application Workfront Fusion ». URL de redirection https://app.workfrontfusion.com/oauth/cb/oauth2
-
Une fois l’enregistrement de l’application terminé, notez l’ID de l’application.
note important IMPORTANT Vous aurez besoin de l’ID d’application pour configurer votre connexion dans Workfront Fusion. -
Générez un secret client. Prenez note de cette clé secrète.
Pour obtenir des instructions, consultez Enregistrement d’une application auprès de la plateforme d’identités Microsoft dans la documentation de Microsoft.
note important IMPORTANT Vous aurez besoin du secret client pour configurer votre connexion dans Workfront Fusion. -
Configurez les autorisations de votre application.
Pour plus d’informations sur l’emplacement et la configuration de ces champs, consultez la section « Configurer des autorisations pour le graphique Microsoft » dans Obtenir l’accès sans utilisateur dans la documentation de Microsoft.
table 0-row-2 1-row-2 layout-auto html-authored no-header De quel type d’autorisations votre application a-t-elle besoin ? Sélectionnez Delegated permissions
.Sélectionner des autorisations Sélectionnez les autorisations suivantes :
-
offline_access
-
openid
-
Toutes les autres autorisations requises par vos intégrations (par exemple :
User.Read
).
Important : vous aurez besoin des autorisations sélectionnées pour configurer votre connexion dans Workfront Fusion.
-
-
Passez à Configurer la connexion de l’API MS Graph dans Workfront Fusion.
Configurer la connexion de l’API MS Graph dans Workfront Fusion
Après avoir enregistré Workfront Fusion, comme indiqué dans la section Enregistrer Workfront Fusion sur le portail d’enregistrement d’applications Microsoft, vous pouvez configurer votre connexion dans le module HTTP > Créer une requête Oauth 2.0.
-
Ajoutez un module HTTP > Créer un appel OAuth 2.0 à votre scénario.
-
Cliquez sur Ajouter en regard du champ de connexion.
-
Configurez les champs de connexion comme suit :
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 layout-auto html-authored no-header Nom de la connexion Saisissez un nom pour la connexion. Environnement Choisissez si vous vous connectez à un compte de production ou hors production. Type Indiquez si vous vous connectez à un compte de service ou à un compte personnel. Type de flux Sélectionnez Authorization Code
.Autoriser URI Saisissez https://login.microsoftonline.com/common/oauth2/v2.0/authorize
.URI du jeton Saisissez https://login.microsoftonline.com/common/oauth2/v2.0/token
.Étendue Saisissez les autorisations que vous avez sélectionnées lors de l’enregistrement, comme expliqué dans la section Enregistrement de Workfront Fusion sur le portail d’enregistrement d’applications Microsoft.
Pour chaque portée, cliquez sur Ajouter et saisissez l’autorisation.
Exemple :
offline_access
.Séparateur d’étendue Sélectionnez SPACE
.ID client Saisissez l’ID d’application à l’étape 2 dans Enregistrer Workfront Fusion sur le portail d’enregistrement d’applications Microsoft. Clé secrète client Saisissez le secret client que vous avez généré à l’étape 3 dans Enregistrement de Workfront Fusion sur le portail d’enregistrement d’applications Microsoft. Autoriser les paramètres Ajoutez les paramètres Autoriser suivants. Pour chaque paramètre que vous ajoutez, cliquez sur Ajouter un élément et saisissez les informations suivantes :
-
Clé :
response_mode
Valeur :query
-
Clé :
prompt
Valeur :consent
Paramètres du jeton d’accès Vous n’avez rien à saisir dans ce champ. Paramètres du jeton d’actualisation -
Cliquez sur Ajouter un élément .
-
Dans le champ Clé, saisissez
scope
. -
Dans le champ Valeur, saisissez toutes les portées que vous avez saisies dans le champ de portée, séparées par des espaces.
Exemple :
offline_access openid User.Read
En-têtes personnalisés Vous n’avez rien à saisir dans ce champ. Placement du jeton In the header
-
-
Cliquez sur Continuer.
-
Dans la fenêtre qui s’affiche, cliquez sur Accepter pour terminer la connexion et revenir au module.