Maken van koppeling Azure
Bepaal welke data je wilt doorzetten naar DigiReceptie, zoals bijwerken van medewerker gegevens (1) of het ophalen van agenda afspraken (2).
We hebben deze 4 gegevens nodig:
1. Tenant ID
2. Client ID
3. Group ID (indien beschikbaar, alleen benodigde accounts aanbieden)
4. Client secret
Dit kunnen we vinden door deze stappen te doorlopen:
Log in op https://portal.azure.com/
Klik op de middelste optie: “Azure Active Directory beheren”
Bovenin beeld staat een Tenant ID — dit is het eerste gegeven dat we nodig hebben.
Klik op “App-registraties” in de linkerkolom
Klik op “Nieuwe registratie”
– Kies een logische naam voor de app registratie
– Zorg ervoor dat “Alleen accounts in deze organisatiemap” is aangevinkt
– Klik op “Registreren”
Boven in beeld staat nu een Applicatie (client) ID, dit is het tweede gegeven dat nodig is.
Ga vervolgens naar “Certificaten en geheimen” in de linkerkolom
– Klik op “Nieuw clientgeheim”
– Zorg ervoor dat deze NIET verloopt
– Klik op “Toevoegen”
– De sleutel wordt nu weergegeven, kopieer deze meteen want deze wordt maar 1x getoond! Dit is dus de Client secret
Ga vervolgens naar API-machtigingen
– Klik op “Een machtiging toevoegen”
– Klik op “Microsoft Graph”
– Klik op “Toepassingsmachtigingen”
– Scroll omlaag naar “Directory”
– Selecteer Directory.ReadAll
– Klik op “Machtigingen toevoegen”
De nieuwe machtiging moet nu zichtbaar zijn. Klik op de knop “Beheerderstoestemming verlenen voor ”.
(Het kan zijn dat deze knop pas na enkele seconden zichtbaar is ivm ingebouwde beveiliging)
KLAAR!
Geef de 3 gegevens aan ons door via info@digireceptie.nl. Verstuur deze vooral op een veilige manier (niet rechtstreeks per e-mail maar maak bijv. een link aan via onetimesecret.com).
Uitnodigen via Outlook
1. Categorie “DigiReceptie” (hoofdletterONgevoelig) aanmaken (éénmalig, kan ook voor hele organisatie gedaan worden door eigen IT)
2. Deze categorie toepassen op uitnodiging die ingeladen moet worden in DigiReceptie, genodigden ontvangen dan (ook) uitnodiging vanuit DigiReceptie
Wat hebben we nodig om een koppeling te maken?
1. vast contactpersoon om details mee door te spreken
2. functie eisen, wat is het doel van de koppeling
3. documentatie over de koppeling aan jullie zijde
4. koppelmethode (REST API, SOAP of anders)
5. endpoints URL
6. authenticatie gegevens (benodigde inloggegevens, token etc.)
7. testomgeving met testdata
Goed om te weten
– er is geen open API beschikbaar, wij realiseren de koppeling
– koppelen is alleen mogelijk met de Enterprise licentie
– voor een smtp koppeling (eigen afzender adres gebruik) geld dezelfde route
– realisatie duurt gemiddeld 4 tot 6 weken na ontvangst van de betaling
– je start het traject door de koppeling in de shop te bestellen
– onze KoppelKoning neemt dan contact op.