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
Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
| 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 :
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.
IMPORTANTVous 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.
IMPORTANTVous 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.
De quel type d’autorisations votre application a-t-elle besoin ?SélectionnezDelegated permissions.Sélectionner des autorisationsSé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 :
Nom de la connexionSaisissez un nom pour la connexion.EnvironnementChoisissez si vous vous connectez à un compte de production ou hors production.TypeIndiquez si vous vous connectez à un compte de service ou à un compte personnel.Type de fluxSélectionnezAuthorization Code.Autoriser URISaisissezhttps://login.microsoftonline.com/common/oauth2/v2.0/authorize.URI du jetonSaisissezhttps://login.microsoftonline.com/common/oauth2/v2.0/token.ÉtendueSaisissez 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’étendueSélectionnezSPACE.ID clientSaisissez l’ID d’application à l’étape 2 dans Enregistrer Workfront Fusion sur le portail d’enregistrement d’applications Microsoft.Clé secrète clientSaisissez 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ètresAjoutez 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_modeValeur :query -
Clé :
promptValeur :consent
Paramètres du jeton d’accèsVous 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ésVous n’avez rien à saisir dans ce champ.Placement du jetonIn the header -
-
Cliquez sur Continuer.
-
Dans la fenêtre qui s’affiche, cliquez sur Accepter pour terminer la connexion et revenir au module.