Zum Inhalt

Erstellen einer App-Registrierung in Azure

Die folgenden Schritte müssen durchgeführt werden, um eine App-Registrierung in Document Inbound von Simova zu erstellen. Eine App-Registrierung ist für Document Inbound erforderlich, um alle verfügbaren Funktionen nutzen zu können.

Info

Um diese Einrichtung durchzuführen, muss das Administrator-Konto sowohl in Business Central als auch im Azure-Portal vorhanden sein, da nur Administratoren über die notwendigen Berechtigungen verfügen.

Business Central (SaaS)

  1. Navigieren Sie zur Document Inbound - Moduleinrichtung.
  2. Klicken Sie auf die Aktion Registrierung erstellen in der Document Inbound - Moduleinrichtung, um fortzufahren.
  3. Wenn ein Pop-up zur Anmeldung erscheint, melden Sie sich mit einem Administrator-Konto sowohl in Document Inbound als auch in Azure an, um mit der Erstellung der App-Registrierung fortzufahren.
  4. Sobald die App-Registrierung erstellt wurde, wird ein neuer Benutzer namens Document Inbound by Simova automatisch für die Azure Active Directory-Anwendung generiert. Ein Pop-up führt Sie zur Azure Active Directory-Anwendungsseite, auf der Sie auf die Schaltfläche Zustimmung gewähren klicken können, um die Administrator-Zustimmung und Berechtigungen in Azure zu erteilen.
  5. Die App-Registrierungs-Feldgruppe in der Document Inbound - Moduleinrichtung sollte nun ausgefüllt sein, und eine App-Registrierung mit dem Namen Document Inbound by Simova wurde in Ihren Azure-Portal-App-Registrierungen erstellt.

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 Inbound im Azure-Portal erstellen.

  1. Melden Sie sich beim Azure-Portal an unter Azure-Portal.
  2. Klicken Sie in der linken Navigationsleiste auf das Symbol Azure Active Directory.
  3. Klicken Sie im Menü von Azure Active Directory auf App-Registrierungen.
  4. Klicken Sie auf die Schaltfläche Neue Registrierung.
  5. Geben Sie den Namen Document Inbound im Feld Name ein.
  6. Wählen Sie die entsprechende Option für die Unterstützten Kontotypen für die App-Registrierung aus.
  7. 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**.
  8. Klicken Sie auf die Schaltfläche Registrieren, um die App-Registrierung zu erstellen.
  9. 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 Inbound in Business Central konfigurieren.
  10. 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.
  11. Geben Sie eine Beschreibung für das Geheimnis ein, wählen Sie ein Ablaufdatum und klicken Sie auf Hinzufügen.
  12. Notieren Sie den generierten Geheimniswert, da er nur einmal angezeigt wird und später nicht mehr abgerufen werden kann. Bitte notieren Sie sich den Geheimniswert, da er benötigt wird, um Document Inbound in Business Central zu konfigurieren.

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

    Permission group API / Permission name Type Description
    Microsoft Graph Directory.Read.All Application Read directory data
    Microsoft Graph Group.ReadWrite.All Application Read and write all groups
    Microsoft Graph Mail.ReadBasic.All Application Read basic mail in all mailboxes
    Microsoft Graph Mail.ReadWrite Application Read and write mail in all mailboxes
    Microsoft Graph User.Read Delegated Sign in and read user profile
    Microsoft Graph User.Read.All Application Read all users' profiles

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

Eingeben der Informationen zur Azure-App-Registrierung in Business Central

Die folgenden Schritte führen Sie durch die Konfiguration der App-Registrierung für eingehende Belege über den App-Registrierungs-Assistenten.

  1. Navigieren Sie zu Eingehender Beleg - Modul einrichten.
  2. Klicken Sie auf die Aktion App-Registrierung konfigurieren in der Einrichtung des Dokumenteingangs - Modul, um fortzufahren.
  3. Ein App-Registrierungsassistent wird angezeigt. Klicken Sie auf Start, um die Konfiguration zu starten.
  4. Um mit diesem Schritt fortzufahren, ist es notwendig, dass Sie bereits eine App-Registrierung für den Document Inbound vorbereitet haben. Wenn Sie keine App-Registrierung für eingehende Dokumente erstellt haben, lesen Sie den Abschnitt Erstellen der Azure-App-Registrierung im Azure-Portal.
  5. Füllen Sie die Felder App-Registrierungsname, Client-ID, Geheimer Clientschlüssel, Mandanten-ID und Umleitungs-URL aus.
  6. Wenn alle Felder korrekt ausgefüllt sind, klicken Sie auf Weiter, um mit der Konfiguration fortzufahren.
  7. Wenn Sie auf Fertig stellen klicken, werden die Änderungen auf die Einstellungen für die App-Registrierung in Eingehender Beleg angewendet.

!! Warnung * Wenn die App-Registrierung nicht korrekt konfiguriert ist, kann Document Inbound in einigen Bereichen nicht ordnungsgemäß funktionieren. * Vorhandene App-Registrierungen werden nach Abschluss des App-Registrierungsassistenten überschrieben.

Siehe auch