Uw identiteitsprovider configureren
Uw identiteitsprovider configureren
Deze pagina beschrijft hoe u de SCIM-connector van uw identiteitsprovider kunt verbinden met Axe. De exacte stappen variëren per provider, maar de instellingen zijn hetzelfde.
Before you begin, make sure you have completed the Vereisten & Installatie: a SCIM subscription, SSO configured, your basis-URL, and your SCIM API-sleutel.
Verbindingsinstellingen
Configureer uw SCIM-connector met het volgende:
| Instelling | Waarde |
|---|---|
| SCIM basis-URL | https://<your-base-url>/api/scim/v2 |
| Authenticatie | API-sleutel (bearer / header-token) |
| Token | Uw SCIM API-sleutel |
| Tokenheader | Authorization: <API_KEY> of X-API-Key: <API_KEY> |
Attribuuttoewijzing
Koppel de gebruikersattributen van uw identiteitsprovider aan Axe:
| Axe attribuut | Bron |
|---|---|
userName |
Werkemail van gebruiker |
emails[].value (primair) |
Werkemail van gebruiker |
name.givenName |
Voornaam |
name.familyName |
Achternaam |
externalId |
Unieke gebruikersidentificatie van uw directory (aanbevolen) |
Het wordt aanbevolen om externalId aan de stabiele identificatie van uw directory toe te wijzen — dit stelt Axe in staat om gebruikers betrouwbaar te matchen bij synchronisaties.
Niet-conforme servermodus (optioneel maar aanbevolen)
Sommige connectors (bijvoorbeeld SailPoint) proberen het volledige SCIM-schema te valideren tijdens de installatie. Als uw connector een „Niet-conforme server“ (of „relaxed“) optie biedt, kunt u deze inschakelen om die validatiestap over te slaan. Axe biedt wel de standaard discovery-eindpunten (/ServiceProviderConfig, /Schemas, /ResourceTypes), dus probeer eerst zonder deze optie verbinding te maken — schakel deze alleen in als uw connector de testverbinding of schema-discovery niet haalt terwijl de authenticatie wel slaagt.
Providerspecifieke opmerkingen
Okta
- Creëer een SCIM 2.0-toepassing (of gebruik het provisioning-tabblad van uw bestaande app).
- Stel de basis-URL en API-sleutel van de SCIM-connector in zoals hierboven.
- Okta gebruikt de email van de gebruiker als unieke identificatie.
Microsoft Entra ID (Azure AD)
- Open in uw ondernemingsapplicatie Provisioning en stel de modus in op Automatisch.
- Voer de basis-URL in als de Tenant-URL en de API-sleutel als de Geheim Token.
- Entra stuurt de directory Object-ID als
externalId; zorg ervoor dat deze wordt toegewezen.
SailPoint (IdentityIQ / Identity Security Cloud)
- Configureer een SCIM 2.0-bron met API-sleutel authenticatie.
- Voer de basis-URL en API-sleutel in.
- Schakel de „Niet-conforme server?“-optie in om schemasignalering over te slaan (alleen
/Usersen/Groupszijn vereist).
De verbinding valideren
Na het configureren van de connector, valideer de integratie in de volgende volgorde:
- Verbinding testen — bevestig dat authenticatie slaagt.
- Groepen lezen — bevestig dat je productabonnementen en teams verschijnen (
GET /Groups). - Maak een testgebruiker — maak één gebruiker aan en bevestig dat ze in axe verschijnen en de uitnodigingsmail ontvangen.
- Wijs een product toe — voeg de gebruiker toe aan een abonnementsroep en bevestig dat ze een productplaats ontvangen.
- Deactiveer de testgebruiker — bevestig dat de toegang is ingetrokken.
Als een stap mislukt, zie Probleemoplossing.