Overslaan en naar hoofdcontent gaan
Aanmelden

Microsoft Graph API inrichten voor e-mailverzending vanuit B3net

  • Bijgewerkt

Inleiding

B3net ondersteunt het verzenden van e-mail via Microsoft Graph API. Hiermee kan B3net veilig e-mails versturen via jouw Microsoft 365-omgeving zonder gebruik te maken van traditionele SMTP-authenticatie. Hier zitten wel aansluit kosten aan verbonden.
Voor de inrichting is een eenmalige configuratie nodig binnen Microsoft Entra ID en Exchange Online.
Belangrijk
B3net ondersteunt een inrichting via Exchange Online RBAC for Applications. Hiermee wordt de applicatie beperkt tot het verzenden van e-mail vanuit één specifieke gedeelde mailbox.
Gebruik bij voorkeur geen standaard Microsoft Graph-toepassingsmachtiging zoals Mail.Send. Deze machtiging geeft een applicatie toestemming om namens alle gebruikers binnen de Microsoft 365-tenant e-mails te versturen.

Wat heb je nodig?

Na de inrichting ontvangen wij graag de volgende gegevens:
  • Client ID
  • Client Secret
  • Tenant ID
  • Afzender e-mailadres (gedeelde mailbox)
Deze gegevens gebruiken wij om de Microsoft Graph-koppeling binnen B3net te configureren.
Voorbeeld configuratie:
 
YAML
mailer_dsn: 'microsoft://<client_id>:<client_secret>@graph.microsoft.com?tenant_id=<tenant_id>'

Handleiding voor Microsoft 365-beheerders

De volledige stap-voor-stap handleiding voor de inrichting vind je onderaan deze pagina.
Deze handleiding beschrijft onder andere:
  • Het aanmaken van een App Registration in Microsoft Entra ID
  • Het genereren van een Client Secret
  • Het bepalen van de Tenant ID
  • Het configureren van Exchange Online RBAC for Applications
  • Het beperken van verzendrechten tot één gedeelde mailbox
  • Het testen van de configuratie

Gegevens veilig aanleveren

Lever de volgende gegevens aan bij Paragin:
GegevenOmschrijving
Tenant IDTenant-ID van jouw Microsoft 365-omgeving
Client IDApplication ID van de app-registratie
Client SecretHet aangemaakte client secret
AfzenderadresHet e-mailadres waarvan B3net mag verzenden
Verstuur een Client Secret bij voorkeur via een beveiligd kanaal en niet in dezelfde e-mail als de overige gegevens.

Testen na inrichting

Wij adviseren om na de inrichting en deployment altijd een test uit te voeren via:
https://www.mail-tester.com

Testprocedure

  1. Open mail-tester.com.
  2. Maak een tijdelijk testadres aan.
  3. Wijzig tijdelijk het e-mailadres van een bestaande gebruiker in B3net naar dit testadres.
  4. Vraag een nieuw wachtwoord aan voor deze gebruiker.
  5. Controleer of de e-mail correct wordt ontvangen.
  6. Controleer de score en eventuele verbeterpunten.

Ondersteuning

Loop je tijdens de inrichting tegen problemen aan? Neem dan contact op met Support en vermeld daarbij:
  • Tenant ID
  • Eventuele foutmeldingen
  • Een schermafbeelding van de configuratie (zonder Client Secret)
  • Welke stap uit de handleiding niet lukt
Zo kunnen wij sneller helpen.