Schritt 2. Konfiguration des verbundenen Systems (SaaS)

Konfiguration bei Business Central Online in einem anderen Tenant, bzw. mit Dynamics 365

Empfohlen ist das OAuth-Autorisierungsprotokoll für die Verbindung zwischen SwissSalary und Business Central Online bzw. den Dynamics 365 Applikationen.

I. Registrieren Sie eine Azure Entra-Anwendung zur Authentifizierung für Business Central Online bzw. Dynamics 365 Applikationen

1.Melden Sie sich im Azure-Portal an.

2.Im Suchfeld geben Sie «App-Registrierungen» ein, dann klicken Sie auf «Neue Registrierung».

3.Füllen Sie die Felder mit den folgenden Werten aus:

Name: Anzeigename der Anwendung. Beispielwert: «Business Central OAuth 2.0»

Unterstützte Kontotypen: Wählen Sie die Option «Konten in einem beliebigen Organisationsverzeichnis (beliebiges Azure Entra-Verzeichnis – mehrinstanzenfähig)»

Umleitungs-URI (optional): Beim Feld «Plattform auswählen» wählen Sie «Web» aus, und geben Sie folgende URL in das Feld ein: «businesscentral.dynamics.com/OAuthLanding.htm»

4.Klicken Sie auf «Registrieren».

II. Erteilen Sie der registrierten Anwendung die Berechtigungen API.ReadWrite.All für Dynamics 365 Business Central, bzw. AX.Full Access und OData.FullAccess für die Dynamics 365 Applikationen

1.Gehen Sie zum Menüpunkt «API-Berechtigungen», und klicken Sie auf «Berechtigung hinzufügen».

2.A. Business Central Online: Klicken Sie auf die Kachel «Dynamics 365 Business Central» und dann auf die Kachel «Anwendungsberechtigungen».

3.A. Business Central Online: Kreuzen Sie die Option «API.ReadWrite.All» ein und klicken Sie auf «Berechtigungen hinzufügen».

B. Dynamics 365 Applikationen:  Kreuzen Sie die Option «Connector.FullAccess» ein und klicken Sie auf «Berechtigungen hinzufügen».

Schritt 3. Erstellen Sie ein Client-Geheimnis für Ihre Anwendung.

1.Gehen Sie zum Menüpunkt «Zertifikate & Geheimnisse» und klicken Sie auf «Neuer geheimer Clientschlüssel».

2.Füllen Sie die Felder mit den folgenden Werten aus:

Beschreibung: “Business Central Client Service”.

Gültig bis: Wählen Sie die Option «Empfohlen: 180 Tage (6 Monate)» aus.

3.Klicken Sie auf «Hinzufügen».

4.Kopieren und speichern Sie auf einer sicheren Art und Weise den Code aus der Spalte «Wert».

Schritt 4. Die erstellte Anwendung im Business Central Online hinzufügen.

1.Öffnen Sie SwissSalary365.

2.Im Suchfeld suchen und wechseln Sie zu «Microsoft Entra-Anwendungen», und klicken Sie auf «Neu»

3.Füllen Sie die Felder mit den folgenden Werten aus:

Client-ID: Geben Sie Ihr «Client-id» an. (Siehe Schritt x Punkt x)

Beschreibung: «Business Central OAuth 2.0»

Status: Wählen Sie die Option «Aktiviert» aus.

4.Beim Register «Benutzerberechtigungssätze» fügen Sie die entsprechenden Berechtigungssätze hinzu. Die Applikationen braucht die Berechtigungssätze, mit denen die Cloud Connector Applikationen die zu synchronisierenden Tabellen lesen, bearbeiten bzw. löschen können.

5.Klicken Sie auf «Zustimmung erteilen» und in dem Dialogfenster wählen Sie das Konto mit der Rolle «Globaler Administrator» aus, und klicken Sie auf «Akzeptieren» und auf «OK».