Ga naar inhoud

Een app-registratie configureren in Azure

De volgende stappen moeten worden uitgevoerd om een app-registratie in Business Portals te maken. Een app-registratie is vereist voor Business Portals om alle functies die beschikbaar zijn in Business Portals te kunnen gebruiken.

Info

Om deze configuratie uit te voeren, moet het beheerdersaccount zowel in Business Central als in het Azure-portaal aanwezig zijn, aangezien alleen beheerders over de vereiste machtigingen beschikken.

Business Central (SaaS)

In Business Portals is er een app-registratie-assistent beschikbaar om een app-registratie in Business Portals te configureren. De app-registratie-assistent leidt u door het maken van een nieuwe app-registratie voor Business Portals of het gebruik van een bestaande app-registratie. Volg de onderstaande stappen om de app-registratie in Business Portals voor Business Central in een SaaS-omgeving te configureren.

  1. Navigeer naar Business Portals - Setup.
  2. Klik op de actie App-registratie en voer de actie App-registratie configureren uit.
  3. Klik op Start, om de configuratie van de app-registratie te starten.
  4. Kies of u een nieuwe app-registratie wilt maken of een bestaande app-registratie wilt gebruiken.

Een nieuwe app-registratie maken

In de volgende stappen leert u hoe u via de app-registratie-assistent een nieuwe app-registratie voor Business Portals kunt maken:

  1. Als er een pop-up verschijnt om in te loggen, zorg er dan voor dat u zich zowel in Business Portals als in Azure aanmeldt met een beheerdersaccount om door te gaan met het maken van de app-registratie.
  2. Voer in het veld Naam van de app-registratie een naam in voor de app-registratie.
  3. Door op Volgende te klikken, wordt het aanmaakproces van de app-registratie in Azure gestart. Tijdens dit proces worden alle vereiste machtigingen en inloggegevens aangemaakt die door Business Portals moeten worden gebruikt.
  4. Er verschijnt een pop-up waarin u een nieuwe gebruiker in de Azure Active Directory-app kunt maken. Klik op Ja om door te gaan met het maken van de app-registratie.
  5. U wordt naar de pagina Azure Active Directory-app geleid, waar u op de actieknop Toestemming verlenen kunt klikken om de toestemming en machtigingen van de beheerder in Azure te verlenen. Als er een pop-up verschijnt, zorg er dan voor dat u zich zowel in Business Portals als in Azure aanmeldt met een beheerdersaccount.
  6. Sluit de pagina Azure Active Directory-app, en de app-registratie-assistent navigeert automatisch naar de volgende stap.
  7. De geheime client-sleutel wordt slechts één keer weergegeven. De geheime client-sleutel is vereist als u een bestaande app-registratie opnieuw wilt gebruiken. U kunt niet naar deze stap terugkeren zodra u op Volgende klikt.
  8. Klik op Volgende om door te gaan.
  9. De configuratie van de app-registratie is nu voltooid. Klik op Voltooien om de app-registratie-assistent te sluiten.

Bestaande app-registratie gebruiken

De volgende stappen laten zien hoe u een bestaande app-registratie voor Business Portals kunt gebruiken via de app-registratie-assistent.

  1. Als er een pop-up verschijnt om in te loggen, zorg er dan voor dat u zich zowel in Business Portals als in Azure aanmeldt met een beheerdersaccount om door te gaan met het maken van de app-registratie.
  2. Voer de naam van de app-registratie die u wilt gebruiken in het veld Naam van de app-registratie in, of gebruik de zoekfunctie om naar alle bestaande app-registraties in uw Azure-tenant te zoeken.

De zoekfunctie gebruiken om de app-registratiegegevens automatisch in te voeren

  1. Selecteer een app-registratie via de zoekfunctie, de assistent vult automatisch alle vereiste velden in de app-registratie-assistent in, met uitzondering van de geheime client-sleutel.
  2. Voer de geheime client-sleutel van de geselecteerde app-registratie in het veld geheime client-sleutel in. Als de geheime client-sleutel correct is, wordt de knop Volgende geactiveerd om door te gaan met de configuratie van de app-registratie.

Handmatig invoeren van de app-registratiegegevens

  1. Voer de naam van de app-registratie die u wilt gebruiken in het veld Naam van de app-registratie in.
  2. Voer de toepassings-ID (client-ID) van de app-registratie die u wilt gebruiken in het veld Client-ID in.
  3. Voer de geheime client-sleutel van de app-registratie die u wilt gebruiken in het veld Geheime client-sleutel in.
  4. Voer de directory-ID (tenant-ID) van de app-registratie die u wilt gebruiken in het veld Tenant-ID in.
  5. Voer de omleidings-URL van de app-registratie die u wilt gebruiken in het veld Omleidings-URL in. In een SaaS-omgeving moet de omleidings-URL https://businesscentral.dynamics.com/OAuthLanding.htm zijn.
  6. Voer de service-principal-ID van de app-registratie die u wilt gebruiken in het veld Service-principal-ID in.
  7. Klik op Volgende om door te gaan met de configuratie. Als de knop Volgende is uitgeschakeld, zorg er dan voor dat alle velden correct zijn ingevuld.

Info

Om de service-principal-ID op te halen, kunnen de volgende stappen worden uitgevoerd:

  1. Navigeer in het Azure-portaal naar Bedrijfsapplicaties.
  2. Wijzig de filter naar toepassings type == Alle applicaties.
  3. Zoek naar de app-registratie die u wilt gebruiken.
  4. Klik op de app-registratie om de pagina app-registratie te openen.
  5. Kopieer de object-ID van de pagina Overzicht. De object-ID is de service-principal-ID.

Warning

Bestaande app-registraties worden overschreven na het voltooien van de app-registratie-assistent.

Vernieuwen van de inloggegevens voor de app-registratie

De geheime client-sleutel heeft een vervaldatum. De inloggegevens kunnen automatisch worden vernieuwd, zonder dat de beheerder naar het Azure-portaal hoeft te gaan met de actie Geheim vernieuwen. In de volgende stappen leert u hoe u de inloggegevens van een app-registratie kunt vernieuwen.

  1. Navigeer naar Business Portals - Setup.
  2. Klik op Geheim vernieuwen, om het verlengingsproces te starten.
  3. Zodra het verlengingsproces is voltooid, verschijnt er een bericht dat de gebruiker informeert dat het verlengingsproces succesvol was, en de nieuwe geheime client-sleutel wordt één keer weergegeven. Een beheerder kan de nieuwe geheime client-sleutel noteren voor toekomstig gebruik.
  4. Klik op OK om het bericht te sluiten, en de nieuwe geheime client-sleutel wordt automatisch opgeslagen en door Business Portals gebruikt.

Info

De nieuwe geheime client-sleutel wordt automatisch toegepast op de andere bedrijven in Business Central, als het bedrijf dezelfde app-registratiegegevens gebruikt.

Business Central (on-premise)

Het automatisch aanmaken van de app-registratie vanuit Business Central On-Premise is niet mogelijk. Daarom moet de creatie van de app-registratie handmatig via het Azure-portaal Azure worden uitgevoerd.

Creëren van de Azure-app-registratie in het Azure-portaal

In de volgende stappen leert u hoe u een nieuw portaal voor de app-registratie voor bedrijven in het Azure-portaal kunt maken.

  1. Meld u aan bij het Azure-portaal op Azure-portaal.
  2. Klik op het Azure Active Directory-pictogram in het linkernavigatiemenu.
  3. Klik in het Azure Active Directory-menu op App-registraties.
  4. Klik op de knop Nieuwe registratie.
  5. Voer in het veld Naam de naam Business Portals in.
  6. Kies de juiste optie Ondersteunde accounttypen voor de app-registratie.
  7. 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 voor het platform op Web zijn ingesteld en in het volgende formaat worden geschreven https:// externe Business Central-adres/BC/OAuthLanding.htm.
  8. Klik op de knop Registreren om de app-registratie te maken.
  9. Noteer op de pagina voor de app-registratie de toepassings-ID (client) en de directory-ID (tenant). Dit is de unieke identificatie voor uw app-registratie die u moet gebruiken bij het configureren van uw Business Portals in Business Central.
  10. Klik op het tabblad Certificaten en geheimen op Nieuwe geheime client-sleutel, om een nieuwe geheime sleutel te maken die wordt gebruikt om uw app bij Azure AD te authenticeren.
  11. Voer een beschrijving voor het geheim in, kies een vervaldatum en klik op Toevoegen.
  12. Noteer de gegenereerde geheime waarde, aangezien deze slechts één keer wordt weergegeven en later niet meer kan worden opgehaald. Noteer de geheime waarde, aangezien deze vereist is voor de configuratie van Business Portals in Business Central.

Klik op het tabblad API-machtigingen op Machtiging toevoegen, en voeg de volgende machtigingen toe.

Machtigingsset Naam van de API / Machtiging Type Beschrijving
Azure Service Management user_impersonation Delegated Toegang tot Azure Service Management als organisatiegebruiker
Dynamics 365 Business Central API.ReadWrite.All Applicatie Volledige toegang tot de webservices-API
Dynamics 365 Business Central Automation.ReadWrite.All Applicatie Volledige toegang tot de automatisering
Microsoft Graph User.Read Applicatie Lees alle gebruikersprofielen

Klik op de knop Beheerdersinstemming verlenen om de machtiging een beheerdersinstemming te verlenen.

Een rol aan een abonnement toevoegen

Het toewijzen van een rol in een abonnement voor de Business Portals-app is vereist om hen toegang te geven tot de App Service.

Info

De roltoewijzing kan alleen door een beheerdersaccount worden uitgevoerd.

  1. Meld u aan bij het Azure-portaal op Azure-portaal.
  2. Zoek via de zoekbalk naar Abonnementen.
  3. Als u meerdere abonnementen heeft, selecteert u het abonnement dat bedoeld is voor Azure Blob Storage, aangezien een opslagaccount over een abonnement moet beschikken.
  4. Ga naar het tabblad Toegangsbeheer (IAM) en klik op het tabblad Roltoewijzing.
  5. Klik op de knop Toevoegen, en selecteer Roltoewijzing toevoegen.
  6. Selecteer op het tabblad Rol de rol Bijdrager, en klik op Volgende.
  7. Klik op het tabblad Leden op de knop Leden selecteren en voeg dan Business Portals toe.
  8. Klik op Controleren + toewijzen, om het roltoewijzingsproces te voltooien.

Invoeren van de informatie voor de Azure-app-registratie in Business Central

In de volgende stappen leert u hoe u de app-registratie voor Business Portals via de app-registratie-assistent kunt configureren.

  1. Navigeer naar Business Portals - Setup.
  2. Klik op de actie App-registratie configureren in de Business Portals - Setup, om door te gaan.
  3. Een app-registratie-assistent wordt weergegeven. Klik op Start, om de configuratie te starten.
  4. Om met deze stap door te gaan, is het noodzakelijk dat u al een app-registratie voor Business Portals heeft voorbereid. Als u geen app-registratie voor Business Portals heeft gemaakt, lees dan de sectie Creëren van de Azure-app-registratie in het Azure-portaal.
  5. Vul de velden App-registratienaam, Client-ID, Geheime client-sleutel, Tenant-ID en Omleidings-URL in.
  6. Als alle velden correct zijn ingevuld, klik dan op Volgende, om door te gaan met de configuratie.
  7. Wanneer u op Voltooien klikt, worden de wijzigingen toegepast op de app-registratie-instellingen in Business Portals.

Warning

  • Als de app-registratie niet correct is geconfigureerd, kunnen de Business Portals in sommige gebieden niet goed functioneren.
  • Bestaande app-registraties worden overschreven na het voltooien van de app-registratie-assistent.

Machtigingssets op de Entra Application Card

De app-registratiegebruiker in Business Portals heeft bepaalde machtigingssets toegewezen gekregen. Deze zijn nodig om centrale functies zoals het aanmaken van facturen via het portaal mogelijk te maken. Hieronder staan alle machtigingssets die aan de app-registratie zijn toegewezen, inclusief hun respectieve functie:

Machtigingsset Gebruik
D365 BASIC Voert de codeunit voor gegevensbeheer uit bij inloggen.
LOGIN Staat de basisinlog toe.
SIM_CORE ADMIN Maakt de licentiecontrole mogelijk
SIM_DPS ADMIN Vereist voor het gebruik van de standaardfuncties van Business Portals.
SIM_DMS USER Wordt automatisch toegewezen bij het licentiëren van DMStoDPS. Vereist voor uploaden en downloaden van documenten.

Info

De Entra Application Card vertegenwoordigt de Microsoft Entra ID-app-registratie, waarmee Business Portals zich tegenover Business Central authenticeert.

De standaard toegewezen machtigingssets dekken de voor Business Portals vereiste functies. Als er extra uitbreidingen, aangepaste processen of maatwerk worden gebruikt, kunnen aanvullende machtigingssets vereist zijn.

Wijs in dat geval de relevante machtigingssets toe aan de Entra Application Card, zodat de app toegang heeft tot de benodigde gegevens en functies.