Zum Inhalt springen

Voraussetzungen für den Connector von Microsoft Dynamics 365 Business Central v2

Einführung

Als Microsoft Dynamics 365 Business Central v2-Verbindung eine Anwendung sein wird, die eine Schnittstelle zu Microsoft hat, müssen Sie eine Anwendung mit Microsoft Entra ID registrieren mit einem bestimmten Satz an Berechtigungen.

Schritte zur Registrierung der Microsoft Azure-App

Befolgen Sie diese Schritte, um eine App-Registrierung zu erstellen mit der Microsoft Identity Platform:

  1. Suchen Sie im Azure Portal nach Microsoft Entra ID (früher bekannt als Azure Active Directory oder Azure AD) und klicken Sie darauf:

    Voraussetzungen für Microsoft Dynamics 365 Business Central 1

  2. Klicken Sie in der linken Seitenleiste unter Verwalten auf App-Registrierungen.

  3. Klicken Sie auf Neue Registrierung:

    Voraussetzungen für Microsoft Dynamics 365 Business Central 2

  4. Geben Sie einen Namen für Ihre App ein. Dieser Anzeigename ist für Benutzer sichtbar:

    Voraussetzungen für Microsoft Dynamics 365 Business Central 3

  5. Klicken Sie auf Registrieren, um die App-Registrierung abzuschließen. Sie werden dann auf die Übersichtsseite der App weitergeleitet:

    Voraussetzungen für Microsoft Dynamics 365 Business Central 4

    Wichtig

    Behalten Sie die Anwendungs-ID (Client) und Verzeichnis-ID (Mandant) der App-Registrierung bei, um sie als client_id Und tenant_id beim Konfigurieren einer Verbindung.

  6. Klicken Sie auf Zertifikat oder Geheimnis hinzufügen.

  7. Klicken Sie auf der Tab Client-Geheimnisse auf Neues Client-Geheimnis, um den Bereich Client-Geheimnis hinzufügen zu öffnen. Geben Sie in diesem Bereich eine Beschreibung ein und wählen Sie ein Ablaufdatum für das Client-Geheimnis aus. Klicken Sie anschließend auf Hinzufügen:

    Voraussetzungen für Microsoft Dynamics 365 Business Central 5

  8. Das Client-Geheimnis ist nun auf der Tab Client-Geheimnisse sichtbar. Behalten Sie es bei, wenn Sie eine Verbindung konfigurieren möchten unter Verwendung des Berechtigungstyps Client Credentials.

Erforderliche Berechtigungen zur App-Registrierung hinzufügen

Ihre App-Registrierung muss über einen bestimmten Berechtigungssatz verfügen.

Navigieren Sie im Azure-Portal zu Ihrer App-Registrierung und klicken Sie in der linken Seitenleiste auf API Berechtigungen:

Voraussetzungen für Microsoft Dynamics 365 Business Central 7

Wichtig

Abhängig von den Sicherheitseinstellungen Ihrer Azure-Organisation ist für die Zulassung mancher Berechtigungen die Zustimmung des Administrators erforderlich.

Dies sind die Berechtigungen, die Sie festlegen müssen:

Dynamics 365 Business Central Anwendungsberechtigungen

Um Dynamics 365 Business Central Anwendungsberechtigungen hinzuzufügen, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf der Seite API Berechtigungen auf Berechtigung hinzufügen.

  2. Klicken Sie im Bereich API Berechtigungen anfordern auf die Tab Von meiner Organisation verwendete APIs, suchen Sie nach** Dynamics 365 Business Central** und klicken Sie darauf:

  3. Klicken Sie auf Anwendungsberechtigungen.

  4. Aktivieren Sie die Berechtigungen AdminCenter.ReadWrite.All, API, app_access und Automation.ReadWrite.All.

  5. Klicken Sie auf Berechtigungen hinzufügen. Die Seite Konfigurierte Berechtigungen der aktualisierten App-Registrierung wird angezeigt.

Delegierte Berechtigungen für Dynamics 365 Business Central

  1. Klicken Sie auf der Seite API Berechtigungen auf Berechtigung hinzufügen.

  2. Klicken Sie im Bereich API Berechtigungen anfordern auf die Tab Von meiner Organisation verwendete APIs, suchen Sie nach** Dynamics 365 Business Central** und klicken Sie darauf:

  3. Klicken Sie auf Anwendungsberechtigungen.

  4. Aktivieren Sie die Berechtigungen Financials.ReadWrite.All und user_impersonation.

  5. Klicken Sie auf Berechtigungen hinzufügen. Die Seite Konfigurierte Berechtigungen der aktualisierten App-Registrierung wird angezeigt.

Delegierte Berechtigungen für Microsoft Graph

  1. Klicken Sie auf der Seite API Berechtigungen auf Berechtigung hinzufügen.

  2. Klicken Sie im Bereich API Berechtigungen anfordern auf die Tab Von meiner Organisation verwendete APIs, suchen Sie nach Microsoft Graph und klicken Sie darauf:

    Voraussetzungen für Microsoft Dynamics 365 Business Central 9

  3. Klicken Sie auf Anwendungsberechtigungen.

  4. Aktivieren Sie die Berechtigungen Financials.ReadWrite.All und user_impersonation.

  5. Klicken Sie auf Berechtigungen hinzufügen. Die Seite Konfigurierte Berechtigungen der aktualisierten App-Registrierung wird angezeigt.

In der folgenden Tabelle sind die mindestens erforderlichen Berechtigungen zusammengefasst.

API/Berechtigungsname Typ Beschreibung Zustimmung des Administrators erforderlich
AdminCenter.ReadWrite.All Anwendung Vollständiger Zugriff auf die Admin Center API Ja
API.ReadWrite.All Anwendung Vollständiger Zugriff auf die Webdienst API Ja
app_access Anwendung Zugriff gemäß den Berechtigungen der Anwendung in Dynamics 365 Business Central Ja
Automation.ReadWrite.All Anwendung Vollzugriff auf Automatisierung Ja
Financials.ReadWrite.All Delegiert Greifen Sie als angemeldeter Benutzer auf Dynamics 365 Business Central zu Nein
user_impersonation Delegiert Zugriff als angemeldeter Benutzer Nein
User.Read Delegiert Anmelden und Benutzerprofil lesen Nein

Nachdem Sie diese Berechtigungen hinzugefügt haben, klicken Sie auf Administratorzustimmung erteilen, um die Registrierung abzuschließen. Nach Abschluss sollte jede Berechtigung mit einem grünen Häkchen versehen sein.

Als nächstes müssen Sie Ihre Anwendung mit Dynamics 365 Business Central verknüpfen. Gehen Sie dazu folgendermaßen vor:

  1. Rufen Sie die folgende URL auf und nehmen Sie die erforderlichen Ersetzungen vor: `https://businesscentral.dynamics.com/{tenant_id}/{en}

  2. Melden Sie sich an.

  3. Klicken Sie unter Microsoft Entra ID suchen auf Neu. Fügen Sie die client_id und fügen Sie eine Beschreibung hinzu (obligatorisch).

  4. Wählen Sie unter Benutzergruppen im Dropdown-Menü die Berechtigung aus, die Sie erteilen möchten. Jitterbit empfiehlt D365 BUS FULL ACCESS, aber das Mindestmaß ist D365 COMPANY HUB.

Veröffentlichen von Objekten als Webdienste

Business Central-Objekte müssen als Webdienste veröffentlicht werden, um über den Connector zugänglich zu sein. Befolgen Sie hierzu die in der Microsoft-Dokumentation beschriebenen Schritte.