Aanmelden bij D365

DynBrowser meldt zich aan met de officiële Microsoft-aanmelding (Microsoft Entra ID, OAuth 2.0 met PKCE) en leest D365 namens de gebruiker, met diens eigen rechten. Er wordt geen wachtwoord en geen geheim opgeslagen.

Je hebt drie gegevens nodig:

Gegeven Wat
Tenant-ID De ID van je Microsoft Entra-tenant (een GUID)
Client-ID De Application (client) ID van de app-registratie hieronder
D365-omgevings-URL Het adres van je omgeving, bijvoorbeeld https://jouwbedrijf.operations.dynamics.com

1. App-registratie aanmaken

In het Microsoft Entra-beheercentrum, onder App-registraties → Nieuwe registratie:

  1. Geef de registratie een naam, bijvoorbeeld DynBrowser.
  2. Kies als platform Mobiele en desktoptoepassingen en voeg de omleidings-URI http://localhost toe (precies zo).
  3. Voeg onder API-machtigingen de gedelegeerde machtiging voor Dynamics ERP toe, en verleen zo nodig beheerderstoestemming voor je organisatie.
  4. Noteer de Application (client) ID en de Directory (tenant) ID.

DynBrowser vraagt bij het aanmelden de machtigingen op die aan de registratie voor je D365-omgeving zijn toegekend. Er is geen clientgeheim of certificaat nodig: DynBrowser is een public client.

2. Gegevens invullen

Kies één van deze manieren:

  • Vooraf, voor iedereen: in het blok D365Auth van publisher-defaults.json, of in het paneel D365-omgevingen van de installatiewizard. Zie Installatie.
  • Via een gedeelde map: staat er een gedeelde map ingesteld, dan worden de aanmeldgegevens daar opgeslagen en lezen alle werkplekken dezelfde.
  • Op de werkplek zelf: in Browser Instellingen → D365-authenticatie: Tenant-ID, Client-ID en de D365-omgevings-URL. Meerdere omgevingen (productie, test) kun je in de lijst zetten.

Lokaal staan de gegevens in %LocalAppData%\ERPBrowser\auth.json.

3. Aanmelden

De gebruiker klikt op Inloggen bij D365. De aanmeldpagina van Microsoft opent in de standaardbrowser van Windows. Daarna onthoudt DynBrowser de aanmelding (versleuteld voor die Windows-gebruiker) en vernieuwt hij die zelf.

Veranderen de aanmeldgegevens via publisher-defaults.json, dan moeten gebruikers zich één keer opnieuw aanmelden.

Wat DynBrowser in D365 doet

  • DynBrowser leest D365 via de standaard OData-koppeling (/data/…), met de rechten van de aangemelde gebruiker. Welke D365-beveiligingsrollen nodig zijn, hangt af van de pagina's die iemand gebruikt: dezelfde rollen als voor die gegevens in D365 zelf.
  • Schrijven naar D365 gebeurt alleen in twee functies, die allebei standaard uit staan en apart door DynSolutionZ voor je organisatie worden vrijgegeven: het terugschrijven van planning vanuit DynPlanboard, en wijzigen in de OData Explorer. Beide werken alleen op omgevingen die daarvoor zijn aangewezen.
  • Wat gebruikers in DynBrowser zelf bewaren (notities, sjablonen, berekeningen) komt niet in D365 terecht.

Geverifieerde aanmelding verplichten

Je organisatie kan eisen dat DynBrowser alleen werkt na een door Microsoft bevestigde aanmelding van jullie eigen tenant. Geef daarvoor je Tenant-ID en Client-ID door aan DynSolutionZ; wij zetten de controle aan. Zie Licenties en gebruikers.

Melding: "D365-aanmelding is niet ingesteld"

Deze melding betekent dat Tenant-ID, Client-ID of omgevings-URL ontbreekt op die werkplek. Vul ze in zoals hierboven beschreven.