Créer un jeton de sécurité d'API
Les jetons API sont de petits fragments de code conçus pour sécuriser l’accès à l’API. Ces jetons sont
Pour utiliser les API Sparkrock Impact, vous devez créer un jeton de sécurité, également appelé jeton Bearer.
Pour créer un jeton de sécurité, vous devez effectuer les étapes suivantes :
Inscrire Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID.
Configurez un nouveau jeton avec une plateforme API, telle que Postman.
Inscrire Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID
Sparkrock Impact doit établir une relation de confiance avec la plateforme d'identité Microsoft. Pour établir cette confiance, Sparkrock Impact doit être inscrit auprès de la plateforme d'identité dans Microsoft Entra ID.
Pour inscrire Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID
Ouvrez un navigateur Web et accédez à Microsoft Entra ID (https://aad.portal.azure.com/).
Connectez-vous.
Vous pouvez utiliser les informations d'identification que vous utilisez pour vous connecter à Sparkrock Impact.
Sur l' Accueil onglet, choisissez Microsoft Entra ID (Azure AD).
Dans le menu en haut de la page, choisissez Ajouter > Inscription d’application, puis après que la Inscrire une application page s’ouvre, effectuez les étapes suivantes :
- Dans Nom, spécifiez le nom de votre application.
- Sous Types de comptes pris en charge, assurez-vous que Le bouton radio Comptes dans cet annuaire organisationnel uniquement (<nom de la compagnie> - Locataire unique)
- Sous URI de redirection (facultatif), dans le Sélectionnez une plateforme dans le champ de liste déroulante, sélectionnez Web, puis dans le champ suivant, spécifiez l’URI de redirection suivant :
https://sparkrock365.bc.dynamics.com/OAuthLanding.htm - Choisissez Inscrire.
Une nouvelle page s’ouvre.
Dans le menu de gauche, choisissez Certificats et secrets, puis effectuez les étapes suivantes :
- Assurez-vous d’être sur le Secrets client puis choisissez Nouveau secret client.
A Ajouter un secret client panneau s’ouvre. - Dans Description, spécifiez une description pour ce secret client.
- Dans Expire, spécifiez une valeur, par exemple, 730 jours (24 mois).
- Choisissez Ajouter.
La Ajouter un secret client Le panneau se ferme. - Copiez la valeur du champ Valeur champ, puis collez la valeur quelque part pour pouvoir la référencer ultérieurement.
Lorsque vous configurez un nouveau jeton, Postman exige que vous saisissiez cette valeur.
- Assurez-vous d’être sur le Secrets client puis choisissez Nouveau secret client.
Dans le menu de gauche, choisissez Autorisations API, puis effectuez les étapes suivantes :
- Choisissez Ajouter une autorisation.
A Demander des autorisations API panneau s’ouvre. - Choisissez Dynamics 365 Business Central.
- Choisissez Autorisations déléguées.
- Sélectionner Financials.ReadWrite.All, puis choisissez Ajouter des autorisations.
- Choisissez Ajouter une autorisation.
Dans le menu de gauche, choisissez Vue d'ensemble, puis effectuez les étapes suivantes :
- Copiez la valeur pour ID d'application (client), puis collez la valeur quelque part pour pouvoir la référencer ultérieurement.
Lorsque vous configurez un nouveau jeton, Postman exige que vous saisissiez cette valeur. - Choisissez Points de terminaison.
- Copiez la valeur pour Point de terminaison d’autorisation OAuth 2.0 (v2), puis collez la valeur quelque part pour pouvoir la référencer ultérieurement.
Lorsque vous configurez un nouveau jeton, Postman exige que vous saisissiez cette valeur. - Copiez la valeur pour Point de terminaison du jeton OAuth 2.0 (v2), puis collez la valeur quelque part pour pouvoir la référencer ultérieurement.
Lorsque vous configurez un nouveau jeton, Postman exige que vous saisissiez cette valeur.
- Copiez la valeur pour ID d'application (client), puis collez la valeur quelque part pour pouvoir la référencer ultérieurement.
Configurer un nouveau jeton avec Postman
Après avoir inscrit Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID, vous pouvez configurer un nouveau jeton avec Postman.
Pour configurer un nouveau jeton avec Postman
Ouvrez Postman.
Sur l' Autorisation onglet, dans Type, spécifiez OAuth 2.0.
Dans la Configurer un nouveau jeton , effectuez les étapes suivantes :
- Assurez-vous que Type d’octroi est défini sur Code d’autorisation.
- Dans URL de rappel, spécifiez ce qui suit :
https://sparkrock365.bc.dynamics.com/OAuthLanding.htm - Dans URL d’authentification, spécifiez la valeur que vous avez copiée depuis Point de terminaison d'autorisation OAuth 2.0 (v2) lors de l'inscription de Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID.
- Dans URL du jeton d’accès, spécifiez la valeur que vous avez copiée depuis Point de terminaison du jeton OAuth 2.0 (v2) lors de l'inscription de Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID.
- Dans ID client, spécifiez la valeur que vous avez copiée depuis ID d'application (client) lors de l'inscription de Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID.
- Dans Clé secrète client, spécifiez la valeur que vous avez copiée depuis Valeur lors de l'inscription de Sparkrock Impact auprès de la plateforme d'identité dans Microsoft Entra ID.
- Dans Étendue, spécifiez ce qui suit :
https://api.businesscentral.dynamics.com/Financials.ReadWrite.All - Choisissez Obtenir un nouveau jeton d’accès.
- Connectez-vous.
Vous pouvez utiliser les informations d'identification que vous utilisez pour vous connecter à Sparkrock Impact.
Si vous êtes invité à accepter des autorisations, choisissez Accepter. - Pour utiliser le nouveau jeton, choisissez Utiliser le jeton.
Informations connexes
API de configuration des approbations
API financières
API d'approvisionnement des utilisateurs mySparkrock
Commentaires
Pour envoyer des commentaires sur cette page, sélectionnez le lien suivant :