Configuration de la connexion API D365 F&O

Microsoft Azure

Enregistrement de l'application

URL : https://portal.azure.com/#home à ouvrir.

1. Cliquer sur Enregistrements d'applications
2. Cliquer sur "Nouvel enregistrement".

Nom

Cela devrait être un nom courant, par exemple "Accès API DeDeSales"

Types de comptes pris en charge

En général, il faut sélectionner ici "Un seul mandant - ..." avec le nom de votre mandant. Si un accès à plusieurs mandants est nécessaire, vous devez configurer cela en conséquence.

Configurer les URI de redirection

Deux URI sont nécessaires pour vos systèmes de test et de production. La plateforme doit toujours être "Web".

Dans la capture d'écran, les URL suivantes ont été utilisées :

1. https://usnconeboxax1aos.cloud.onebox.dynamics.com/
2. https://usnconeboxax1aos.cloud.onebox.dynamics.com/oauth/

Il se peut que vous n'ayez pas besoin d'entrer d'URL ici, cela dépend de votre environnement.
Mais si vous en entrez, vous devez inscrire vos URL. Les URL montrées ici à titre d'exemple ne fonctionneront pas chez vous.

Cliquez maintenant sur "Enregistrer"

Créer une clé client

Sous "Gérer", cliquez sur "Certificats & secrets". Sélectionnez "Nouvelle clé secrète client".

Nommez la clé "Secret" et choisissez une durée de 24 mois. Cliquez ensuite sur "Ajouter".

La clé secrète sera alors affichée dans la colonne "Valeur".

Attention ! Elle n'est visible qu'une seule fois et doit être copiée maintenant, car nous en aurons besoin.

Autorisations API

Ajoutez maintenant les autorisations montrées ici.

1. Cliquez sur "Ajouter une autorisation"
2. Dans Dynamics ERP, sélectionnez l'autorisation indiquée ci-dessous.
3. L'autorisation Microsoft Graph "User.Read" est également nécessaire.
4. Cliquez sur "Accorder le consentement de l'administrateur"

ID de l'application (client)

Vous trouverez l'ID de l'application en cliquant sur Aperçu. Copiez l'ID de l'application qui apparaît, car nous en aurons besoin. 

D365 Finance & Operation

Applications Microsoft Entra ID

Ouvrez D365 F&O et recherchez "Applications Microsoft Entra ID". 

Par exemple accessible via :
Modules -> Administration système -> +Tout développer -> sous la catégorie "Configuration-> Applications Microsoft Entra ID

Créez une nouvelle entrée et saisissez ce qui suit :

1. ID de l'application
2. Nom comme indiqué ci-dessus : "Accès API DeDeSales"
3. Choisissez un utilisateur sous le contexte duquel l'appel API sera effectué par nous. 
   1. Utilisez un mot de passe fort
   2. Ne sélectionnez pas l'option de changement de mot de passe au premier appel.
   3. Désactivez tout MFA pour l'utilisateur
   4. Attribuez à l'utilisateur le rôle et les droits corrects. Un aperçu de l'accès aux entités requises vous sera fourni par votre Chef de projet.
   5. Le rôle "System user" est une obligation et doit être attribué à l'utilisateur.

Configuration de la sécurité

Les autorisations décrites ici couvrent le connecteur standard de DeDeSales. Pour des adaptations individuelles, les autorisations doivent être étendues en conséquence.

N'oubliez pas de publier les privilèges et rôles après leur création !

Privilèges

Veuillez créer une nouvelle entrée : DeDeSales API

Entités

Attribuez les entités suivantes et donnez les droits correspondants.

Entité	Lecture	Mise à jour	Création	Suppression
CustCustomerV3Entity	Accorder	Non défini	Non défini	Non défini
CustomerPaymentMethodEntity	Accorder	Non défini	Non défini	Non défini
DeliveryTermsEntity	Accorder	Non défini	Non défini	Non défini
EcoResProductBarcodeV3Entity	Accorder	Non défini	Non défini	Non défini
EcoResProductV2Entity	Accorder	Non défini	Non défini	Non défini
EcoResReleasedProductV2Entity	Accorder	Non défini	Non défini	Non défini
InventProductSpecificOrderSettingsV3Entity	Accorder	Non défini	Non défini	Non défini
PaymentTermEntity	Accorder	Non défini	Non défini	Non défini
SalesOrderHeaderV2Entity	Accorder	Accorder	Accorder	Accorder
SalesOrderLineV2Entity	Accorder	Accorder	Accorder	Accorder
smmContactPersonV2Entity	Accorder	Accorder	Accorder	Accorder
smmEmploymentJobFunctionEntity	Accorder	Non défini	Non défini	Non défini

Rôles

Créez un rôle nommé "DeDeSales API Role".

Fonctions

Ajoutez ce qui suit :

• Maintenir les contacts

Privilèges

Ajoutez ce qui suit :

• DeDeSales API
• DeDeSalesPriceDiscountsView

Clore la commande

Test de l'API

L'API doit être accessible à l'URL indiquée ci-dessus /metadata et fournir le résultat suivant. Exemple : https://usnconeboxax1aos.cloud.onebox.dynamics.com/metadata/DataEntities

Depuis votre configuration, nous avons besoin de

1. ID de l'application
2. Secret
3. TenantId
4. URL