Een app-registratie maken in Azure
De volgende stappen moeten worden uitgevoerd om een app-registratie in Document Inbound van Simova te maken. Een app-registratie is vereist voor Document Inbound om alle beschikbare functies te kunnen gebruiken.
Info
Om deze instelling uit te voeren, moet het beheerder-account zowel in Business Central als in het Azure-portaal aanwezig zijn, aangezien alleen beheerders over de noodzakelijke machtigingen beschikken.
Business Central (SaaS)
- Navigeer naar de Document Inbound - Module-instelling.
- Klik op de actie Registratie maken in de Document Inbound - Module-instelling om door te gaan.
- Wanneer er een pop-up voor aanmelding verschijnt, meld u aan met een beheerder-account zowel in Document Inbound als in Azure om door te gaan met het maken van de app-registratie.
- Zodra de app-registratie is gemaakt, wordt er automatisch een nieuwe gebruiker genaamd Document Inbound by Simova gegenereerd voor de Azure Active Directory-applicatie. Een pop-up leidt u naar de Azure Active Directory-applicatiepagina, waar u op de knop Toestemming verlenen kunt klikken om de beheerders-toestemming en machtigingen in Azure te verlenen.
- De app-registratie-veldgroep in de Document Inbound - Module-instelling zou nu ingevuld moeten zijn, en er is een app-registratie met de naam Document Inbound by Simova aangemaakt in uw Azure-portaal-app-registraties.
Business Central (On-Premise)
De automatische creatie van de app-registratie van Business Central On-Premise is niet mogelijk. Daarom moet de creatie van de app-registratie handmatig via het Azure-portaal plaatsvinden.
Een Azure-app-registratie maken in het Azure-portaal
De volgende stappen begeleiden u bij het maken van een nieuwe app-registratie voor Document Inbound in het Azure-portaal.
- Meld u aan bij het Azure-portaal op Azure-portaal.
- Klik in de linker navigatiebalk op het pictogram Azure Active Directory.
- Klik in het menu van Azure Active Directory op App-registraties.
- Klik op de knop Nieuwe registratie.
- Voer de naam Document Inbound in het veld Naam in.
- Kies de juiste optie voor de Ondersteunde accounttypen voor de app-registratie.
- Voer de juiste Omleidings-URI voor uw app-registratie in. Dit is de URI waar Azure AD de gebruiker na authenticatie naartoe omleidt. De URI moet ingesteld zijn op Web voor het platform en in het volgende formaat geschreven zijn: https://**externe Business Central-adres/BC/OAuthLanding.htm**.
- Klik op de knop Registreren om de app-registratie te maken.
- Noteer op de pagina van de app-registratie de Toepassing (client) ID en de Directory (tenant) ID. Dit is de unieke identificator voor uw app-registratie die u moet gebruiken wanneer u uw Document Inbound in Business Central configureert.
- Klik onder het tabblad Certificaten & geheimen op Nieuw clientgeheim om een nieuw geheim te maken dat wordt gebruikt voor de authenticatie van uw app met Azure AD.
- Voer een beschrijving voor het geheim in, kies een vervaldatum en klik op Toevoegen.
- Noteer de gegenereerde geheimwaarde, aangezien deze slechts één keer wordt weergegeven en later niet meer kan worden opgehaald. Noteer de geheimwaarde, aangezien deze nodig is om Document Inbound in Business Central te configureren.
- Klik onder het tabblad API-machtigingen op Machtiging toevoegen en voeg de volgende machtigingen toe.
| Machtigingsgroep | API / Machtigingsnaam | Type | Beschrijving |
|---|---|---|---|
Microsoft Graph |
Directory.Read.All |
Toepassing | Maakt het mogelijk om directorygegevens in de gehele Microsoft Entra ID-tenant te lezen. Dit omvat onder andere gebruikers, groepen, app-registraties en andere directoryobjecten. De machtiging wordt gebruikt om informatie tenantbreed op te halen, directoryobjecten op te lossen en hun bestaan of eigenschappen te controleren, zonder dat een gebruiker aangemeld hoeft te zijn. |
Microsoft Graph |
Directory.Read.All |
Toepassing | Is vereist wanneer het product gebruikers-, groepen- of applicatie-informatie tenant-overstijgend moet ophalen, controleren of weergeven. Dit kan bijvoorbeeld nodig zijn voor gebruikersselecties, groepstoewijzingen, machtigingscontroles of achtergrondprocessen. |
Microsoft Graph |
Group.ReadWrite.All |
Toepassing | Maakt het mogelijk om Microsoft 365- en Entra ID-groepen te maken, lezen, bijwerken en te verwijderen. Daarnaast kunnen groepskenmerken en groepslidmaatschappen worden beheerd zonder dat een gebruiker aangemeld hoeft te zijn. |
Microsoft Graph |
Group.ReadWrite.All |
Toepassing | Maakt het mogelijk om groepslidmaatschappen te beheren, bijvoorbeeld het toevoegen of verwijderen van gebruikers in Microsoft 365- of Entra ID-groepen. Hierdoor kunnen gebruikers automatisch aan de juiste groepen en machtigingen worden toegewezen. |
Microsoft Graph |
Group.ReadWrite.All |
Toepassing | Maakt het mogelijk om groepsgerelateerde inhoud en gesprekken binnen Microsoft 365-groepen te lezen en te schrijven. Deze machtiging wordt gebruikt wanneer de applicatie functies biedt die zijn gebaseerd op groepssamenwerking of groepscommunicatie. |
Microsoft Graph |
Mail.ReadBasic.All |
Toepassing | Maakt het mogelijk om basiskenmerken van e-mails in alle postvakken te lezen, zoals afzender, ontvanger, onderwerp en ontvangstdatum. De toegang omvat uitdrukkelijk geen berichtinhoud, voorbeeldteksten, bijlagen of uitgebreide e-mailkenmerken. |
Microsoft Graph |
Mail.ReadBasic.All |
Toepassing | Wordt gebruikt om e-mailmetadata te bieden voor overzichten, controles, zoekfuncties of synchronisatieprocessen, zonder toegang te hoeven hebben tot vertrouwelijke inhoud van de e-mails. |
Microsoft Graph |
Mail.ReadWrite |
Toepassing | Maakt het mogelijk om e-mails in alle postvakken van de tenant te maken, lezen, bijwerken en te verwijderen. De applicatie kan hierdoor e-mailobjecten beheren en bewerken zonder dat een gebruiker aangemeld hoeft te zijn. |
Microsoft Graph |
Mail.ReadWrite |
Toepassing | Wordt gebruikt voor de geautomatiseerde verwerking van e-mails, bijvoorbeeld om berichten te verplaatsen, op te slaan, aan te passen of te verwijderen. De machtiging omvat niet het verzenden van e-mails. |
Microsoft Graph |
User.Read |
Gelelegeerd | Maakt het mogelijk dat een gebruiker zich aanmeldt bij de applicatie en basisprofielinformatie van de momenteel aangemelde gebruiker leest. Dit omvat bijvoorbeeld naam, e-mailadres en andere informatie die nodig is voor de gebruikersidentificatie. |
Microsoft Graph |
User.Read |
Gelelegeerd | Wordt gebruikt om de huidige gebruikerscontext binnen de applicatie te bieden, bijvoorbeeld om gebruikersinformatie weer te geven of acties aan de aangemelde gebruiker toe te wijzen. |
Microsoft Graph |
User.Read.All |
Toepassing | Maakt het mogelijk om de volledige gebruikersprofielen van alle gebruikers in de Microsoft Entra ID-tenant te lezen. Dit omvat informatie zoals namen, e-mailadressen, afdelingen en andere profielattributen. |
Microsoft Graph |
User.Read.All |
Toepassing | Wordt gebruikt om gebruikersinformatie tenantbreed op te lossen, weer te geven en te verwerken. Typische gebruikssituaties zijn gebruikerslijsten, gebruikerstoewijzingen, controles, machtigingsanalyses of geautomatiseerde achtergrondprocessen. |
- Klik op de knop Admin-toestemming verlenen om de machtiging een admin-toestemming te verlenen.
Invoeren van de informatie voor de Azure-app-registratie in Business Central
De volgende stappen begeleiden u bij het configureren van de app-registratie voor inkomende documenten via de app-registratie-assistent.
- Navigeer naar Inkomend Document - Module instellen.
- Klik op de actie App-registratie configureren in de instelling van Document Inbound - Module om door te gaan.
- Een app-registratie-assistent wordt weergegeven. Klik op Start, om de configuratie te starten.
- Om met deze stap door te gaan, is het noodzakelijk dat u al een app-registratie voor Document Inbound heeft voorbereid. Als u geen app-registratie voor inkomende documenten heeft gemaakt, lees dan de sectie Een Azure-app-registratie maken in het Azure-portaal.
- Vul de velden App-registratienaam, Client-ID, Geheime client sleutel, Tenant-ID en Omleidings-URL in.
- Als alle velden correct zijn ingevuld, klik dan op Volgende om door te gaan met de configuratie.
- Wanneer u op Voltooien klikt, worden de wijzigingen toegepast op de instellingen voor de app-registratie in Inkomend Document.
!! Waarschuwing * Als de app-registratie niet correct is geconfigureerd, kan Document Inbound in sommige gebieden niet goed functioneren. * Bestaande app-registraties worden overschreven na het voltooien van de app-registratie-assistent.