Asset-configuratie voor Azure AD-gebruikersprovisioning

Avatar
Laura CARBO

Voordat je begint

De klant of leverancier moet de Azure AD-klanthandleiding hebben ontvangen en uitgevoerd. Daarna moeten de volgende waarden beschikbaar zijn:

  • Client ID
  • Client Secret
  • Tenant ID
  • Group ID
  • Resource: alleen voor Graph API v1. Dit staat niet in de klanthandleiding; vraag het indien nodig op

Een Graph-applicatie instellen

  1. Klik op Setup of ga naar Admin > Setup

  1. Open Applications

  1. Klik op Create application


  1. Vul de gegevens in en kies de Graph API-app. Dit voorbeeld gebruikt Azure AD; kies Custom Graph application voor een generieke verbinding. Stappen 5 en 6 zijn gelijk.

  1. Klik op Generate default key value pairs. Standaard is API-versie 2; vraag bij versie 1 ook Resource op

  1. Vul de gegenereerde waarden voor productie, back-up en test in volgens:

a. client_id = Client ID

b. client_secret = Client Secret

c. scope = instellen op https://graph.microsoft.com/.default tenzij de leverancier of klant anders aangeeft

d. tenant_id = Tenant ID

e. resource = Resource bij versie 1

Klik op Test connection. Als een toegangstoken wordt opgehaald, is de verbinding geslaagd.

  1. Zet Enable GetUsers op yes

Nieuwe sleutel-waardeparen verschijnen. Verplichte en optionele acties:

a. GetUsers_defaultContactCategory: vul in value de categorie voor nieuwe contacten in

b. GetUsers_defaultGroup / GetUsers_defaultProfile: kies in Related object de groep of het profiel

c. GetUsers_defaultUserType: selecteer in Related object het licentietype

d. GetUsers_groupid: vul de ontvangen Group ID in

e. GetUsers_scheduledScript: alleen voor maatwerk, een script na gegevensophaling

f. GetUsers_selectQuery: alleen voor maatwerk, beperk of breid de opgehaalde velden uit

  1. Een gepland script is aangemaakt. Pas dit aan en stel ten minste Execute as in.


  1. Stel desgewenst een archive limit in om massale verwijdering bij verkeerde gegevens te voorkomen


Uitleg van de verbinding

De volgende velden identificeren gebruikers uit deze verbinding:

  • Contact.externalReference
  • Contact.datasource
  • SystemUser.datasource
  • SystemUser.externalReference

Gebruik deze velden dan niet voor andere doelen.

Het geplande script doet het volgende:

  • Zoekt contacten van de applicatie via datasource
  • Markeert systeemgebruikers voor verwijdering
  • Werkt via de API opgehaalde gebruikers bij
  • Verwijdert niet-bijgewerkte, gemarkeerde gebruikers binnen de archive limit

GetUsers = no deactiveert het script.

Bij fouten staat onder de applicatie een eventlog met de ruwe webservicerespons voor analyse.

Maatwerkmogelijkheden

Zoek op SwbApplication naar scripts voor gebruikersmaatwerk. De lijst hieronder is niet volledig.

  • SwbApplicationIsActiveInOperationMode – controleert of de applicatie in de huidige modus actief is
  • SwbApplicationGraphAccessToken – haalt het Graph API-token op en vernieuwt dit als het ontbreekt of verlopen is
  • SwbApplicationGraphGetWebservice  – geeft het gewenste standaardendpoint terug, bijvoorbeeld met parameter GET
  • SwbApplicationGetKeyValuePairsMap ­– retourneert een map met sleutel-waardeparen
  • SwbApplicationGraphUpdateUser – maakt een node om gebruikersgegevens in Graph API bij te werken. Hiervoor zijn extra Azure-bewerkrechten nodig

Beperkingen

De verbinding heeft beperkingen:

  • Geneste groepen worden niet verwerkt, alleen gebruikers rechtstreeks in de groep
  • De SKIM-standaard voor gebruikersprovisioning wordt momenteel niet ondersteund
  • Just-in-time provisioning moet afzonderlijk worden geïmplementeerd

Artikelen in deze sectie