Konfiguration einer App-Registrierung in Azure

Die folgenden Schritte müssen abgeschlossen werden, um eine App-Registrierung in Document Central zu erstellen. Eine App-Registrierung wird von Document Central benötigt, um alle verfügbaren Funktionen von Document Central nutzen zu können.

Info

Um diese Einrichtung durchzuführen, ist es notwendig, dass das Administrator-Konto sowohl in Business Central als auch im Azure-Portal vorhanden ist, da nur Administratoren die notwendigen Berechtigungen haben.

Business Central (On-Premise)

Die automatische Erstellung der App-Registrierung von Business Central On-Premise ist nicht möglich. Daher muss die Erstellung der App-Registrierung manuell über das Azure-Portal erfolgen.

Erstellen der Azure App-Registrierung im Azure-Portal

Die folgenden Schritte leiten Sie an, wie Sie eine neue App-Registrierung für Document Central im Azure-Portal erstellen.

Melden Sie sich beim Azure-Portal an unter Azure-Portal.
Klicken Sie in der linken Navigationsleiste auf das Symbol Azure Active Directory.
Klicken Sie im Menü von Azure Active Directory auf App-Registrierungen.
Klicken Sie auf die Schaltfläche Neue Registrierung.
Geben Sie den Namen Document Central im Feld Name ein.
Wählen Sie die entsprechende Option für die Unterstützten Kontotypen für die App-Registrierung aus.
Geben Sie die entsprechende Weiterleitungs-URI für Ihre App-Registrierung ein. Dies ist die URI, zu der Azure AD den Benutzer nach der Authentifizierung umleitet. Die URI sollte auf Web für die Plattform eingestellt und im folgenden Format geschrieben sein: https://**externe Business Central-Adresse/BC/OAuthLanding.htm**.
Klicken Sie auf die Schaltfläche Registrieren, um die App-Registrierung zu erstellen.
Notieren Sie auf der Seite der App-Registrierung die Anwendungs- (Client-) ID und die Verzeichnis- (Mandanten-) ID. Dies ist der eindeutige Bezeichner für Ihre App-Registrierung, den Sie verwenden müssen, wenn Sie Ihr Document Central in Business Central konfigurieren.
Klicken Sie unter dem Tab Zertifikate & Geheimnisse auf Neues Clientgeheimnis, um ein neues Geheimnis zu erstellen, das zur Authentifizierung Ihrer App mit Azure AD verwendet wird.
Geben Sie eine Beschreibung für das Geheimnis ein, wählen Sie ein Ablaufdatum und klicken Sie auf Hinzufügen.
Notieren Sie das generierte Clientgeheimnis, da er nur einmal angezeigt wird und später nicht mehr abgerufen werden kann. Bitte notieren Sie sich das Clientgeheimnis, da er benötigt wird, um Document Central in Business Central zu konfigurieren.

Klicken Sie unter dem Tab API-Berechtigungen auf Berechtigung hinzufügen und fügen Sie die folgenden Berechtigungen hinzu.

Berechtigungsgruppe	API/Berechtigungsname	Typ	Beschreibung
Microsoft Graph	offline_access	Delegiert	Ermöglicht die Verwendung von Refresh Tokens, damit die Benutzerauthentifizierung automatisch erneuert werden kann. Dadurch müssen sich Benutzer bei der Nutzung von Document Central und den angebundenen Microsoft-Diensten nicht bei jeder Sitzung erneut anmelden.
Microsoft Graph	User.Read	Delegiert	Wird verwendet, um den aktuell angemeldeten Benutzer zu ermitteln und den Benutzerkontext für Authentifizierungs- und Berechtigungsprüfungen bereitzustellen. Diese Berechtigung wird unter anderem bei der Anmeldung sowie bei der Überprüfung der Verbindung zu Microsoft-Diensten verwendet.
Microsoft Graph	User.Read.All	Delegiert	Ermöglicht das Suchen, Auswählen und Auflösen von Benutzern aus Microsoft Entra ID. Wird bei der Konfiguration und Verwaltung von Benutzergruppen sowie bei der Auswahl von Benutzern innerhalb von Document Central verwendet.
Microsoft Graph	Group.ReadWrite.All	Delegiert	Ermöglicht das Erstellen und Verwalten von Microsoft Entra ID-Gruppen direkt aus Document Central heraus. Diese Berechtigung wird insbesondere für die Benutzergruppenfunktionen sowie bei der Erstellung neuer SharePoint-Sites benötigt, da hierbei automatisch Gruppen angelegt werden können.
Microsoft Graph	GroupMember.ReadWrite.All	Delegiert	Ermöglicht das Hinzufügen und Entfernen von Benutzern in Microsoft Entra ID-Gruppen. Diese Berechtigung wird verwendet, um Gruppenmitgliedschaften aus Document Central zu verwalten und Benutzer automatisch den entsprechenden Gruppen zuzuweisen.
Microsoft Graph	Sites.ReadWrite.All	Delegiert	Wird benötigt, um SharePoint-Sites direkt aus Document Central heraus zu erstellen. Ohne diese Berechtigung können neue SharePoint-Sites nicht automatisch angelegt werden und entsprechende Einrichtungsprozesse schlagen fehl.
SharePoint	AllSites.Read	Delegiert	Ermöglicht den lesenden Zugriff auf Inhalte der verbundenen SharePoint-Sites. Diese Berechtigung wird für den Export von Dokumenten, die Document Entry Synchronization sowie für die Anzeige von Dokumenten in der Document Preview benötigt.
SharePoint	AllSites.Manage	Delegiert	Wird für Verwaltungsaufgaben innerhalb bestehender SharePoint-Sites verwendet. Hierzu gehören das Veröffentlichen von Metadaten, Inhaltstypen und Dokumentbibliotheken sowie das Hochladen von Dokumenten in SharePoint-Bibliotheken.
SharePoint	AllSites.FullControl	Delegiert	Ermöglicht die Veröffentlichung von Subsites. Diese Berechtigung wird insbesondere während der initialen Einrichtung oder bei späteren Erweiterungen der SharePoint-Struktur benötigt, beispielsweise wenn zusätzliche Subsites veröffentlicht werden sollen.

Klicken Sie auf die Schaltfläche Admin-Zustimmung erteilen, um die Berechtigung eine Admin-Zustimmung zu erteilen.

Achtung

Das Entfernen oder Deaktivieren einzelner Berechtigungen kann dazu führen, dass bestimmte Funktionen von Document Central nicht mehr korrekt arbeiten oder vollständig ausfallen.

Da einzelne Funktionen von unterschiedlichen Berechtigungen abhängig sind, empfehlen wir ausdrücklich, keine der bereitgestellten Berechtigungen zu entfernen. Andernfalls kann nicht sichergestellt werden, dass Document Central auch bei zukünftigen Updates oder der Nutzung weiterer Funktionen uneingeschränkt funktioniert.

Zertifikat erstellen

Die Erstellung eines Client-Zertifikats ermöglicht es Document Central, sich bei SharePoint zu authentifizieren, ohne den Benutzer zu imitieren. Dies vermeidet auch das Problem des Ablaufens des Tokens, das auftreten kann, wenn mit einem Benutzerkontext gearbeitet wird. Die Verwendung eines Client-Zertifikats ist optional. Wenn Sie jedoch ein Client-Zertifikat zur Authentifizierung bei SharePoint verwenden möchten, leiten Sie die folgenden Schritte an, wie Sie ein Client-Zertifikat für Document Central erstellen.

Navigieren Sie zu Zertifikate und folgen Sie den Schritten zur Erstellung eines Client-Zertifikats. Die .pfx-Datei und die .cer-Dateien werden benötigt. Bitte notieren Sie sich das Passwort der .pfx-Datei, da es benötigt wird, um Document Central in Business Central zu konfigurieren.
Navigieren Sie zur erstellten Azure App-Registrierung für Document Central.
Klicken Sie unter dem Tab Zertifikate & Geheimnisse auf den Tab Zertifikate.
Klicken Sie auf Zertifikat hochladen, dann laden Sie die .cer-Datei hoch und schreiben Sie eine Beschreibung.
Klicken Sie auf Hinzufügen, um das Zertifikat zu speichern.
Die pfx-Datei wird in der Document Central Konfiguration hochgeladen.

Hinzufügen einer Rolle zu einem Abonnement

Das Zuweisen einer Rolle für die Document Central-App in einem Abonnement ist notwendig, um die Erstellung und Konfiguration eines Speicherkontos für Azure Blob Storage zu ermöglichen. Wenn Azure Blob Storage jedoch nicht in Document Central im Abonnement genutzt wird, kann dieser Schritt übersprungen werden.

Info

Die Rollenzuweisung kann nur von einem Administrator-Konto durchgeführt werden.

Melden Sie sich beim Azure-Portal an unter Azure Portal.
Suchen Sie nach Abonnements mithilfe der Suchleiste.
Wenn Sie mehrere Abonnements haben, wählen Sie das für Azure Blob Storage vorgesehene aus, da ein Speicherkonto ein Abonnement haben muss.
Gehen Sie zum Tab Zugriffskontrolle (IAM) und klicken Sie auf den Tab Rollenzuweisung.
Klicken Sie auf die Schaltfläche Hinzufügen und wählen Sie Rollenzuweisung hinzufügen.
Wählen Sie unter dem Tab Rolle die Rolle Mitwirkender aus und klicken Sie auf Weiter.
Klicken Sie unter dem Tab Mitglieder auf die Schaltfläche Mitglieder auswählen und fügen Sie Document Central hinzu.
Klicken Sie auf Überprüfen + zuweisen, um den Prozess der Rollenzuweisung abzuschließen.

Eingabe der Azure App-Registrierungsinformationen in Business Central

Die folgenden Schritte leiten Sie an, wie Sie die App-Registrierung für Document Central über den App-Registrierungsassistenten konfigurieren.

Navigieren Sie zu Document Central - Modul Einrichtung.
Klicken Sie in der Document Central - Modul Einrichtung auf die Aktion App-Registrierung konfigurieren, um fortzufahren.
Ein App-Registrierungsassistent wird erscheinen. Klicken Sie auf Beginnen, um die Konfiguration zu starten.
Um diesen Schritt fortzusetzen, ist es notwendig, bereits eine App-Registrierung für Document Central vorbereitet zu haben. Wenn Sie noch keine App-Registrierung für Document Central erstellt haben, beziehen Sie sich bitte auf den Abschnitt Erstellen der Azure App-Registrierung im Azure-Portal.
Füllen Sie die Felder App-Registrierungsname, Client-ID, Client-Geheimnis, Mandanten-ID und Weiterleitungs-URL aus.
Sobald alle Felder korrekt ausgefüllt sind, klicken Sie auf Weiter, um mit der Konfiguration fortzufahren.
Die Konfigurationsseite für das Client-Zertifikat wird angezeigt. Dieser Schritt ist optional und kann durch Klicken auf Weiter übersprungen werden. Wenn Sie jedoch ein Client-Zertifikat zur Authentifizierung bei SharePoint verwenden möchten, muss ein Zertifikat vorbereitet werden.
Klicken Sie auf das Feld Zertifikatschlüssel, um ein Popup zu öffnen, das Ihnen erlaubt, die .pfx-Datei auszuwählen, die im Schritt Zertifikat erstellen erstellt wurde.
Geben Sie das Passwort der .pfx-Datei im Feld Zertifikatschlüssel-Passwort ein und klicken Sie auf Weiter, um mit der Konfiguration fortzufahren.
Nach dem Klicken auf Fertigstellen werden die Änderungen an den Einstellungen der App-Registrierung in Document Central angewendet.

Warnung

Wenn die App-Registrierung nicht korrekt konfiguriert ist, wird Document Central in einigen Bereichen nicht ordnungsgemäß funktionieren können.
Bestehende App-Registrierungen werden beim Abschluss des App-Registrierungsassistenten überschrieben.

Siehe auch

Modul-Einrichtung