Wat doet deze koppeling?

Met deze koppeling laat je Microsoft Entra ID (voorheen Azure AD) automatisch gebruikers en groepen aanmaken, bijwerken en uitschakelen in Hix. Voeg je een medewerker toe in Entra ID? Dan staat hij kort daarna ook in Hix. Verwijder je iemand uit Entra (of uit de juiste groep)? Dan wordt zijn Hix-account automatisch uitgeschakeld.

Voor IT-beheerders betekent dit dat het beheer van gebruikersaccounts centraal in Entra ID blijft, en dat je niet meer handmatig accounts in Hix hoeft te koppelen of op te ruimen.

Goed om te weten: in de Microsoft Entra-toepassingsgalerie heet de Hix-app nog SecureLogin — dat is de oude productnaam. Zoek je in Entra op "SecureLogin", dan kom je op de juiste applicatie uit voor de Hix-koppeling.

Wat wordt er gesynchroniseerd?

De Microsoft Entra-voorzieningsservice ondersteunt voor Hix de volgende acties:

• Gebruikers aanmaken in Hix op basis van Entra ID.
• Gebruikers uitschakelen in Hix wanneer ze geen toegang meer nodig hebben (bijvoorbeeld bij uitdiensttreding).
• Gebruikerskenmerken synchroon houden tussen Entra ID en Hix.
• Groepen en groepslidmaatschappen inrichten in Hix.
• Optioneel: eenmalige aanmelding (SSO) zodat medewerkers met hun Entra-account in Hix kunnen inloggen.

Tip: combineer deze koppeling met SSO. Provisioning zorgt voor het bestaan van het account in Hix; SSO zorgt voor het inloggen. Samen leveren ze de minste handmatige beheer­handelingen op.

Voorwaarden

Voordat je begint, zorg dat je het volgende hebt:

Aan de Hix-kant:

• Een Hix-account met managerrechten — die heb je nodig om in stap 4 namens je organisatie te autoriseren.
• Het domein van je Hix-omgeving (bijvoorbeeld jouwbedrijf.hixportal.com of jouwbedrijf.securelogin.nu).

Aan de Microsoft Entra-kant:

• Een actief Microsoft Entra-abonnement.
• Een gebruikersaccount met een van deze rollen:
  • Toepassingsbeheerder
  • Cloudtoepassingsbeheerder
  • Applicatie-eigenaar van de SecureLogin-app in jouw tenant

In het kort: wat doe je in welke applicatie?

De inrichting raakt zowel Hix als Microsoft Entra ID. De hoofdlijn:

1. In Hix — zorg dat je een managers-account hebt en weet welk domein je gebruikt.
2. In Entra ID — voeg de SecureLogin-app toe vanuit de toepassingsgalerie.
3. In Entra ID — bepaal welke gebruikers en groepen binnen scope vallen.
4. In Entra ID — configureer de provisioning, autoriseer richting Hix en start de synchronisatie.
5. In Entra ID — bewaak het resultaat via de inrichtingslogboeken.

Hieronder lopen we de stappen door.

Stap 1 — Plan je implementatie

Voordat je begint te configureren, denk even na over:

• Wie binnen scope valt. Wil je alle medewerkers in Hix laten verschijnen, of alleen een bepaalde Entra-groep (bijvoorbeeld Accountancy of Klantenservice)?
• Welke kenmerken je vanuit Entra wilt doorsturen naar Hix (zie de mappingtabel verderop).
• Welke pilot-gebruikers je eerst meeneemt om de werking te valideren.

Tip: begin altijd klein. Wijs eerst één of twee testgebruikers aan de applicatie toe, valideer dat ze correct in Hix verschijnen, en breid daarna pas uit.

Stap 2 — Voeg SecureLogin toe uit de Entra-galerie

1. Meld je aan op het Microsoft Entra-beheercentrum met minimaal een cloudtoepassingsbeheerder-rol.
2. Ga naar Entra ID → Enterprise apps.
3. Klik op + Nieuwe toepassing en zoek in de gallery naar SecureLogin.
4. Voeg de applicatie toe.

Heb je SecureLogin al toegevoegd voor SSO? Dan kun je dezelfde app hergebruiken voor provisioning. Microsoft raadt aan om bij een eerste test eerst een aparte app aan te maken, zodat je de productie-SSO niet verstoort tijdens het inrichten.

Stap 3 — Bepaal wie binnen scope valt

In de Entra-app kun je op twee manieren bepalen wie er wordt voorzien:

• Op basis van toewijzing — alleen gebruikers en groepen die expliciet zijn toegewezen aan de applicatie.
• Op basis van een bereikfilter — alle gebruikers, gefilterd op een kenmerk (bijvoorbeeld afdeling = Accountancy).

Voor een gecontroleerde uitrol is op basis van toewijzing de veiligste keuze. Wijs één of twee gebruikers toe als pilot, test, en breid daarna uit.

Stap 4 — Configureer automatische gebruikersvoorziening

1. Ga in het Entra-beheercentrum naar Enterprise apps en open SecureLogin.
2. Selecteer in het linkermenu Inrichten.
3. Klik op + Nieuwe configuratie.
4. Klik onder Beheerdersreferenties op Autoriseren. Je wordt doorgestuurd naar SecureLogin/Hix:
   • Vul je SecureLogin-domein in (bijvoorbeeld jouwbedrijf.securelogin.nu).
   • Klik op Start.
   • Log in met een managers-account en bevestig de autorisatie.
5. Terug in Entra: klik op Verbinding testen om te valideren dat Entra met Hix kan praten. Lukt het niet? Controleer dan of je Hix-account daadwerkelijk managerrechten heeft en probeer opnieuw.
6. Klik op Maken om de configuratie aan te maken.
7. Ga naar Eigenschappen op de overzichtspagina en stel het volgende in:
   • E-mailmeldingen aanzetten voor quarantaine- en foutmeldingen, met een geldig e-mailadres.
   • Preventie van onbedoelde verwijderingen aanzetten — dit voorkomt dat een grote groep accounts per ongeluk in één run wordt uitgeschakeld.
8. Ga naar Kenmerktoewijzing → Gebruikers en controleer welke velden vanuit Entra naar Hix worden gestuurd. Pas eventueel het overeenkomende (matching) veld aan, en sla op. Zie de mappingtabel hieronder voor wat standaard wordt gesynchroniseerd.
9. Ga naar Kenmerktoewijzing → Groepen en doe hetzelfde voor groepsattributen.
10. Test eerst met inrichten op aanvraag (provision on demand) voor één gebruiker, om te zien of de account correct in Hix wordt aangemaakt.
11. Pas wanneer de testgebruiker succesvol in Hix verschijnt: klik op de overzichtspagina op Inrichting starten.

Vanaf dat moment loopt de synchronisatie cyclisch (standaard om de ~40 minuten).

Stap 5 — Bewaak en troubleshoot

Na het starten zijn er drie plekken om de werking in de gaten te houden:

• Inrichtingslogboeken (Provisioning logs) — toont per gebruiker of de provisioning is gelukt of mislukt, met details als hij niet is gelukt.
• Voortgangsbalk op de overzichtspagina — toont waar Entra zich in de huidige sync-cyclus bevindt.
• Quarantainestatus — als Entra te veel fouten op rij ziet, plaatst hij de configuratie in quarantaine om grootschalige schade te voorkomen. De ingestelde e-mail (zie stap 4.7) ontvangt dan een melding.

Tip: check de inrichtingslogboeken altijd na de eerste volledige cyclus. Hier zie je in één oogopslag of er accounts zijn waarvoor de match faalt (bijvoorbeeld door een ontbrekend e-mailadres of een dubbel userPrincipalName).

Welke kenmerken worden gesynchroniseerd?

Onderstaande tabellen tonen welke kenmerken Entra ID standaard naar Hix stuurt. De velden met een vinkje in Matching worden gebruikt om bestaande Hix-accounts te herkennen — laat dat veld op userName staan tenzij je een goede reden hebt om het te wijzigen.

Voor gebruikers

Voor groepen

Wil je het matching-kenmerk wijzigen (bijvoorbeeld naar externalId)? Dat kan, maar zorg dan dat de Hix-API filteren op dat kenmerk ondersteunt en dat het veld voor alle gebruikers correct is gevuld in Entra.

Veelvoorkomende problemen

Mijn "Verbinding testen" mislukt. Controleer of je in stap 4.4 een Hix-account met managers-rechten hebt gebruikt om te autoriseren. Een gewoon gebruikersaccount of een klantgebruiker heeft niet voldoende rechten.

Een Entra-gebruiker verschijnt niet in Hix. Loop dit lijstje af:

1. Is de gebruiker toegewezen aan de SecureLogin-applicatie in Entra?
2. Heeft de gebruiker een geldig werk-e-mailadres in Entra?
3. Is de provisioning daadwerkelijk gestart (stap 4.11)?
4. Staat er een fout op deze gebruiker in de inrichtingslogboeken?

Mijn configuratie staat in quarantaine. Open de overzichtspagina van de provisioning-configuratie in Entra. Daar staat de quarantaine-reden vermeld, vaak met directe stappen om dit op te lossen. Veelvoorkomende oorzaak: te veel mislukte matches op rij doordat een ander matching-veld is gekozen dat voor de meeste gebruikers leeg is.

Gebruikers worden niet uitgeschakeld in Hix wanneer ze uit Entra worden verwijderd. Controleer dat preventie van onbedoelde verwijderingen niet te streng staat ingesteld. Bij grote verwijderacties stelt Entra de uitschakeling uit en stuurt eerst een waarschuwingsmail naar het ingestelde e-mailadres.

Veelgestelde vragen

Is provisioning hetzelfde als SSO? Nee. Provisioning regelt het bestaan en de attributen van het Hix-account; SSO regelt het inloggen. Beide kun je los of in combinatie gebruiken — voor de meeste organisaties is de combinatie aan te raden.

Hoe vaak synchroniseert Entra? Standaard ongeveer elke 40 minuten. Voor een directe test gebruik je inrichten op aanvraag (provision on demand) op één gebruiker.

Worden bestaande Hix-accounts overschreven? Bestaande accounts worden herkend op basis van het matching-kenmerk (standaard userName). Vindt Entra een match, dan worden de overige kenmerken bijgewerkt. Vindt Entra geen match, dan wordt er een nieuw account aangemaakt.

Kan ik een testomgeving gebruiken voordat ik dit op productie zet? Ja. Microsoft raadt aan eerst een aparte SecureLogin-app in Entra toe te voegen voor de eerste integratie­test, en pas daarna de productie-app te koppelen.

Moet ik in Hix nog iets configureren voor SSO? SSO valt buiten dit artikel. Voor de inrichting van eenmalige aanmelding tussen Entra ID en Hix is een aparte configuratie nodig — neem daarvoor contact op met onze support.

Aanvullende bronnen

• Microsoft Learn: SecureLogin configureren voor automatische gebruikersvoorziening met Microsoft Entra ID — het officiële Microsoft-artikel, met alle achterliggende details over de Entra-voorzieningsservice.
• Microsoft Learn: Automatiseren van gebruikersprovisioning naar SaaS-toepassingen
• Microsoft Learn: Inrichtingslogboeken bekijken

Hulp nodig?

Loop je vast bij de inrichting of werkt de provisioning niet zoals verwacht? Stuur een bericht naar support@hellohix.com met:

• Je Hix-omgeving (subdomein, dus het deel vóór .hixportal.com of .securelogin.nu).
• De foutmelding of een screenshot uit de Entra-inrichtingslogboeken.
• De rol waarmee je in Entra werkt.

Voor vragen over Microsoft Entra ID zelf verwijzen we je naar Microsoft Learn of je Microsoft-partner.