App-registratie aanmaken in Azure
De volgende stappen moeten worden voltooid om een App-registratie aan te maken in Document Inbound. Een App-registratie is vereist om alle functies van Document Inbound te kunnen gebruiken.
Info
Voor deze configuratie is het noodzakelijk dat het beheerder-account aanwezig is in zowel Business Central als Azure Portal, aangezien alleen beheerders de benodigde rechten hebben.
Business Central (SaaS)
- Navigeer naar Document Inbound - Module Setup.
- Klik op de actie Create Registration in het scherm Document Inbound - Module Setup.
- Als er een pop-up verschijnt om in te loggen, log dan in met een beheerder-account in zowel Document Inbound als Azure.
- Na het aanmaken van de App-registratie wordt automatisch een nieuwe gebruiker genaamd Document Inbound aangemaakt voor de Azure Active Directory Application. Een pop-up leidt je naar de pagina van de Azure Active Directory Application waar je op de knop Grant Consent kunt klikken om beheerdersrechten toe te kennen.
- De groep App Registration in het scherm Document Inbound - Module Setup is nu ingevuld en een App-registratie met de naam Document Inbound is aangemaakt in je Azure Portal App Registrations.
Business Central (On-Premise)
Het automatisch aanmaken van een App-registratie vanuit Business Central On-Premise is niet mogelijk. Daarom moet de registratie handmatig worden aangemaakt via het Azure Portal.
App-registratie aanmaken in Azure Portal
- Log in op het Azure Portal via Azure Portal.
- Klik op Azure Active Directory in het linkermenu.
- Klik op App Registrations.
- Klik op New registration.
- Voer Document Inbound in als Name.
- Kies het juiste type Supported account types.
- Voer de juiste Redirect URI in. Deze moet ingesteld zijn op Web en het volgende formaat hebben: https://**extern Business Central-adres/BC/OAuthLanding.htm**.
- Klik op Register.
- Noteer de Application (client) ID en Directory (tenant) ID.
- Ga naar het tabblad Certificates & secrets en klik op New client secret.
- Geef een beschrijving, kies een verloopdatum en klik op Add.
- Noteer de gegenereerde secret value, deze wordt slechts één keer weergegeven.
-
Ga naar het tabblad API permissions, klik op Add a permission en voeg de volgende rechten toe:
Permissiegroep API / Permissienaam Type Beschrijving Microsoft GraphDirectory.Read.AllApplication Directorygegevens lezen Microsoft GraphGroup.ReadWrite.AllApplication Groepen lezen en schrijven Microsoft GraphMail.ReadBasic.AllApplication Basis e-mail lezen in alle mailboxen Microsoft GraphMail.ReadWriteApplication E-mail lezen en schrijven in alle mailboxen Microsoft GraphUser.ReadDelegated Gebruikersprofiel lezen Microsoft GraphUser.Read.AllApplication Alle gebruikersprofielen lezen -
Klik op Grant admin consent om de rechten goed te keuren.
App-registratiegegevens invoeren in Business Central
- Navigeer naar Document Inbound - Module Setup.
- Klik op Configure App Registration.
- Klik op Begin in de App Registration Wizard.
- Vul de velden App Registration Name, Client ID, Client Secret, Tenant ID en Redirect URL in.
- Klik op Next en vervolgens op Finish om de instellingen op te slaan.
Warning
- Als de App-registratie niet correct is geconfigureerd, zullen sommige functies van Document Inbound niet correct werken.
- Bestaande App-registraties worden overschreven bij het voltooien van de wizard.