Einrichtung API-Verbindung D365 F&O

Microsoft Azure

App-Registrierung

URL: https://portal.azure.com/#home aufrufen.

1. App-Registrierungen anklicken
2. Auf "Neue Registrierung" klicken.

Name

Dies sollte ein gängiger Name sein, z.B. "DeDeSales API Zugriff"

Unterstützte Kontotypen

I.d.R. ist hier "Nur ein Mandant - ..." mit ihrem Mandantennamen einzustellen. Benötigen wir Zugriff auf mehrere Mandanten müssen Sie dies entsprechend konfigurieren.

Umleitung URIs einrichten

Es werden jeweils zwei URIs für Ihr Test+Produktiv-System benötigt. Als Plattform ist immer "Web" zu wählen.

In dem Screenshot wurden folgende URLs verwendet:

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

Klicken Sie nun auf "Registrieren"

Clientschlüssel anlegen

Klicken Sie unter "Verwalten" auf "Zeritifkate & Geheimnisse". Wählen Sie dort "Neuer geheimer Clientschlüssel".

Benennen Sie den Schlüssel mit dem Namen "Secret" und wählen eine Dauer von 24 Monaten. Klicken Sie anschließend auf "Hinzufügen.

Nun wird der Geheime Schlüssel in der Spalte "Wert" angezeigt.

Achtung! Dieser ist nur einmalig sichtbar und muss jetzt kopiert werden, da wir diesen benötigen.

API-Berechtigungen

Fügen Sie nun die hier gezeigten Berechtigungen hinzu.

1. Klicken Sie auf "Berechtigung hinzufügen"
2. Wählen Sie in Dynamics ERP die unten gezeigten Berechtitung aus.
3. Klicken Sie auf "Administrato

Anwendungs-ID (Client)

Die Anwendungs-ID finden Sie, wenn Sie auf Übersicht klicken. Die nun erscheinende Anwendungs-ID kopieren, da wir diese benötigen. 

D365 Finance & Operation

Microsoft Entra ID-Anwendungen

Rufen Sie D365 F&O auf und suchen nach "Microsoft Entra ID-Anwendungen". 

Z.B. erreichbar unter:
Module -> Systemverwaltung -> +Alle Erweitern -> unter der Kategorie "Einstellungen-> Microsoft Entra ID-Anwendungen

Tragen Sie die Anwendungs-ID und den Namen der App ein. Wählen Sie den User aus unter dem die Berechtigungen für die DeDeSales API konfiguriert sind.

Abschluss

Test der API

Die API muss unter der oben angegebenen URL /data aufrufbar sein und folgendes Ergebnis liefern. Beispiel: https://usnconeboxax1aos.cloud.onebox.dynamics.com/data

Aus Ihrer Einrichtung heraus benötigen wir

1. Anwendungd-ID
2. Secret
3. TenantId
4. URL