Microsoft Entra ID ermöglicht die Verwaltung des Netzwerkzugriffs und schützt vor unautorisierten Zugriffen. Um die Sicherheit der Zugriffe zu gewährleisten, sind Konfigurationen innerhalb der Microsoft Entra ID erforderlich. Hierfür ist es erforderlich, eine App Registrierung durchzuführen.
|
Die Einrichtung der Entra-Anwendung kann über das Assisted Setup automatisch vorgenommen werden. In diesem Fall muss ein Administrator lediglich den Zugriff in Microsoft Entra ID bestätigen, um die Verbindung zu aktivieren. Die folgende Anleitung beschreibt eine alternative manuelle Vorgehensweise, falls die automatische Einrichtung über das Assisted Setup nicht verwendet werden kann. |
Um den Zugriff über das Internet zu ermöglichen, muss die collana pay Business Central-App im Microsoft Entra ID (www.portal.azure.com) registriert werden.
Mit der Registrierung der App werden folgende IDs angelegt, die zu einem späteren Zeitpunkt zur Konfiguration wichtig sind.
In dem Menüpunkt Endpoints können die URLS für die Endpunkte aufgerufen werden.
Im nächsten Schritt müssen Konfigurationen für die Plattform vorgenommen werden.
Der kopierte Link wird im markierten Bereich eingefügt und die Konfiguration wird vorgenommen. Für die Authentifizierung muss folgende URL eingetragen werden:
https://businesscentral.dynamics.com/OAuthLanding.htm
Diese Redirect-URLs dienen als Kommunikationswege für die Authentifizierung.
Im folgenden Fall wird eine OAuth2-Authentifizierung eingerichtet. Die Authentifizierung erfolgt in folgenden Schritten:
- Wenn eine bestimmte URL aufgerufen wird, ist eine Anmeldung erforderlich.
- Nach erfolgreicher Anmeldung erfolgt die Weiterleitung zu einem autorisierten Bereich, der in diesem Fall Business Central ist.
Client Secret
Im nächsten Schritt ist die Erstellung eines Client Secrets erforderlich. Dieses wird benötigt, um auf die Business Central App zuzugreifen. Während der Erstellung wird ein Wert generiert, der anschließend in im collana pay Admin Portal (COPAL) eingetragen werden muss.
Sobald das Client Secret erstellt wurde, wird dies in der Übersicht sichtbar. Im Feld Expires ist ein Datum hinterlegt, welches das Ablaufdatum repräsentiert. Dieses Ablaufdatum kann nicht verlängert werden. Stattdessen muss das Client Secret regelmäßig erneuert werden. Zu dem Zeitpunkt, an dem das Secret abläuft, wird collana pay nicht mehr in der Lage sein, Nachrichten zuzustellen. In Microsoft-Systemen ist es üblich, dass Passwörter regelmäßig geändert werden müssen, und es besteht keine Möglichkeit, diese Anforderung zu deaktivieren. Daher sollte das Ablaufdatum im Blick behalten und das Passwort in COPAL aktualisiert werdem, sobald es abgelaufen ist.
Das Feld Value enthält ein generiertes Passwort. Dieses Passwort ist von entscheidender Bedeutung, um auf die Business Central App zuzugreifen.
Achtung! Nachdem der Wert generiert wurde, muss das Passwort kopiert werden, um es im collana pay Admin Portal zu hinterlegen. Es ist zu einem späteren Zeitpunkt nicht mehr möglich, das Passwort zu kopieren, weil es nicht mehr angezeigt wird.
API Permissions
In diesem Schritt erfolgt die API-Berechtigung, bei der der Zugriff der Business Central-App ausgewählt wird. Hier wird festgelegt, welche Informationen collana pay durch die Registrierung im jeweiligen Tenant abrufen darf.
Es ist wichtig sicherzustellen, dass bei der Auswahl der Berechtigung Application permissions ausgewählt werden, da die Kommunikation ausschließlich über die API erfolgen soll und keine anderen Zugriffsrechte gewährt werden sollen.
Nach der Konfiguration wird im Statusfeld eine Hinweismeldung angezeigt, die darauf hinweist, dass der Administrator zustimmen muss, um den Zugriff zu gewähren.
Die Zustimmung kann über Grant admin consent erteilt werden. Falls die Erteilung der Berechtigung nicht funktioniert, liegt das an der Berechtigung des aktuellen Nutzers.
Die App-Registrierung wurde erfolgreich konfiguriert, um auf bestimmte Einrichtungen zuzugreifen. Die erfolgreiche Registrierung ist anhand des grünen Häkchens zu erkennen und die Hinweismeldung wurde entfernt.
Einrichtung Microsoft Entra-Anwendung in Business Central
Die folgende Einrichtung ist erforderlich, damit collana pay berechtigt wird, um auf den Callback Webservice von Business Central zuzugreifen.
Microsoft Entra-Anwendungen
1. Über die Suche in Business Central zu Microsoft Entra-Anwendungen navigieren.
2. Über den Button Neu wird eine neue Microsoft Entra-Anwendung angelegt.
3. Im Feld Client ID wird die angelegte Application Client-ID verwendet, die während der App Registrierung erstellt wurde.
4. Sobald die Client ID eingegeben wurde, sollte im Feld Beschreibung (Description) eine entsprechende Beschreibung eingetragen werden.
5. Im nachfolgenden Schritt ist es notwendig, die Zustimmung zu erteilen. Die Zustimmung muss über das Microsoft-Konto genehmigt werden.
6. Im folgenden Schritt erfolgt eine Bestätigung über die erfolgreiche Authentifizierung.
7. Um die erfolgreiche Nutzung sicherzustellen, ist es erforderlich, die Aktivierung im Feld Status (State) durchzuführen. Dabei sollte der Status (State) von Deaktiviert (Disabled) auf Aktiviert (Enabled) geändert werden.
8. Durch die Aktivierung wird ein Benutzer erstellt, mit dem Rechte über den Abschnitt Benutzerberechtigungssätze zugewiesen werden können.
Benutzerberechtigungssätze
Für collana pay stehen zwei Berechtigungssätze zur Verfügung:
- collana pay Admin
- collana pay User
Um Zugriff auf die für die Benachrichtigungszustellung notwendigen Ressourcen in Business Central zu ermöglichen, muss die Rolle Pay Admin hinzugefügt werden. Darüber hinaus sollte dem Benutzer die zusätzliche Rolle D365 Basic zugewiesen werden. Diese Rolle ist notwendig, damit sich der Benutzer in Business Central anmelden kann.
Der nächste Schritt ist die Einrichtung, um collana pay für den Zugriff auf den Business Central Callback Web Service zu autorisieren.
Verknüpfung mit