Skip to Content

Gebruikersprofielen & attributen

Standaardprofielvelden, aangepaste profielattributen en zichtbaarheid.

Het profiel van een gebruiker is de verzameling velden die het account beschrijven. Het platform levert een vaste set standaardvelden mee en laat u het profiel uitbreiden met eigen aangepaste attributen, die u eenmalig centraal definieert en toewijst aan de directory's die ze moeten gebruiken.

Standaardprofielvelden

Elke directory biedt een gemeenschappelijke set standaardvelden. De belangrijkste zijn:

VeldOpmerkingen
E-mailPrimair contact en, in de meeste directory's, de aanmeldidentificatie. Kan worden geverifieerd.
GebruikersnaamOptionele secundaire identificatie.
Volledige naamVoornaam, achternaam en optioneel een tweede voornaam.
MobileTelefoonnummer, gebruikt voor sms-factoren; kan worden geverifieerd. Een optioneel tweede nummer wordt ondersteund.
Titel, Afdeling, BedrijfsnaamFunctieattributen. Bedrijfsnaam is standaard uitgeschakeld en deelt de opslag met de waarde die een directorysynchronisatie aanlevert.
Kantoorlocatie, personeelsnummer, datum indiensttredingAanvullende functieattributen, beschikbaar waar de directory profielbewerking toestaat.

Elke directory bepaalt per veld of het is ingeschakeld, of het als aanmeldidentificatie dient, of het vereist is en of het bij de registratie verschijnt (off / optional / required). Er moet altijd ten minste één identificatie actief zijn. U configureert dit op de directory zelf, zie Gebruikersdirectory's → Profielschema.

Welk systeem een veld bezit

Of een profielveld in de console bewerkbaar is, hangt af van de directory:

  • Lokale directory's: velden zijn hier altijd bewerkbaar. Het platform is de bron van waarheid.
  • Gesynchroniseerde enterprise-directory's: de bovenliggende Active Directory-/LDAP-bron beheert de eigen velden. Ze zijn in de console alleen-lezen, tenzij upstream sync (write-back) voor die directory is ingeschakeld; in dat geval worden hier aangebrachte wijzigingen naar de bron teruggeschreven. Staat write-back uit, dan worden de formuliervelden wel getoond, maar zijn ze uitgeschakeld.

Dit hangt rechtstreeks samen met de schakelaars voor ingeschakeld/vereist per veld en met de upstream-syncinstelling van de directory, zie Gebruikersdirectory's → Synchronisatie.

Voor AD/LDAP-directory's toont het profiel de eigen identificaties van de directory, namelijk Common Name, Organizational Unit (gekozen uit een OU-kiezer) en User Principal Name, in plaats van vrij bewerkbare e-mail- en gebruikersnaamvelden.

Profielgegevens versus toegangsbepalende gegevens

Een profiel draagt twee soorten gegevens, en het verschil bepaalt wie een veld mag bewerken:

  • Profielgegevens beschrijven de persoon en veranderen mee met zijn leven, niet met zijn toegang: weergavenaam, telefoonnummer, voorkeurstaal, kantoorlocatie, T-shirtmaat voor het onboardingpakket. Waar een directory self-service toestaat, onderhouden gebruikers deze velden zelf.
  • Toegangsbepalende gegevens zijn alles wat een systeem leest om te bepalen wat de persoon mag: groepslidmaatschap, rollen, accountstatus, kostenplaats of afdeling wanneer een app daaruit rechten afleidt, een klantnummer waarop een applicatie vertrouwt. Zo'n veld wordt nooit voor self-service geopend: een waarde die de gebruiker kan wijzigen, is een waarde die de gebruiker zichzelf kan verlenen. Houd die onder beheer van beheerders of gesynchroniseerd vanuit het bezittende systeem.

Of een attribuut het platform verlaat, wordt per applicatie bepaald, op het tabblad Attributen van de applicatie: een OIDC-applicatie kiest welke aangepaste attributen zij als claims ontvangt, een SAML- of WS-Federation-applicatie beeldt ze af in haar attribuutstatements. Een attribuut definiëren geeft het dus op zichzelf nooit prijs. Behandel alles wat in een token of Assertion terechtkomt als operationele gegevens: geef alleen mee wat de ontvangende app nodig heeft, en maak nooit interne of gevoelige waarden op deze manier openbaar.

Aangepaste profielattributen

Let op: Aangepaste profielattributen maken deel uit van de functie profile metadata, beschikbaar vanaf het niveau Advanced (en tijdens de Trial).

Volstaan de standaardvelden niet, definieer dan een aangepast attribuut. Aangepaste attributen worden eenmalig in een centrale catalogus aangemaakt en vervolgens toegewezen aan elke directory die ze moet verzamelen. Dit tweetrapsmodel houdt één definitie consistent over directory's heen en laat elke directory tegelijk zelf bepalen of het veld vereist is en of het bij de registratie verschijnt.

Een aangepast attribuut definiëren

Aangepaste attributen beheert u in het directorygebied, op de pagina Attributen.

  1. Open Attributen en kies ervoor een nieuw attribuut toe te voegen.

  2. Geef het een naam (de stabiele identificatie) en een label (wat gebruikers en beheerders zien). De namen van de standaardprofielvelden en de namen van claims die in uitgegeven tokens worden gebruikt (bijvoorbeeld email, title, mobile, groups of sub) zijn gereserveerd, ongeacht hoofdlettergebruik: een aangepast attribuut met zo'n naam zou eruitzien als het standaardveld maar aparte gegevens bevatten, dus het aanmaken wordt geweigerd. Kies in plaats daarvan een eigen naam, bijvoorbeeld jobRole in plaats van title.

  3. Kies een type:

    TypeGebruik voor
    TextVrije korte tekst.
    NumberNumerieke waarden.
    DateKalenderdata.
    Select / ChoiceEen vaste lijst met opties die u zelf definieert (waarde en label).
    PasswordEen geheime waarde.
  4. Configureer optioneel:

    • Beschrijving: vrije tekst die als aanwijzing onder het veld verschijnt, bij de registratie en in het profiel, precies zoals ingevoerd (niet vertaald).
    • Multiple values: laat het veld een lijst bevatten.
    • Standaardwaarde.
    • Uniqueness: standaard moet de waarde van een attribuut uniek zijn over alle accounts (geen twee gebruikers mogen dezelfde waarde hebben, bijvoorbeeld een personeelsnummer). Schakel Duplicaten toestaan in om die beperking op te heffen en meerdere accounts dezelfde waarde te laten hebben.
    • Maintained via API only: de waarde wordt weergegeven maar is niet handmatig bewerkbaar, noch in het profiel van de gebruiker, noch in de Admin Console; alleen de management-API (een integratie of synchronisatie) schrijft ze. Zo'n attribuut wordt ook nooit bij de registratie verzameld.
  5. Stel de zichtbaarheid in (zie hieronder) en sla op.

Op elk aangepast attribuut kan via de management-API worden gefilterd; de index die deze query's ondersteunt, wordt automatisch bijgehouden.

Met een sjabloon beginnen

Sjablonen dekken attributen die de meeste tenants toch al nodig hebben, zoals bedrijfsgrootte, kostenplaats, dienstverband of datum indiensttreding. Kies er een onder Attribute template en de naam, het type en de opties worden voorgevuld, samen met een label. Er blijft niets aan het sjabloon gekoppeld: elke waarde is bewerkbaar en het resultaat gedraagt zich precies als een attribuut dat u zelf van nul hebt gedefinieerd.

Sjablonen zijn bovendien vertaald. Een label uit een sjabloon wordt aan elke gebruiker in de eigen taal getoond, dus een Duitse gebruiker leest "Unternehmensgröße" waar een Engelse gebruiker "Company size" leest. Nadat u een sjabloon hebt gekozen, toont het veld Label zelf de Engelse referentietekst, want via die tekst wordt de vertaling opgezocht. Laat de tekst ongewijzigd om de vertalingen te behouden.

Een label dat u zelf typt, wordt aan iedereen precies zo getoond als u het hebt ingevoerd, in elke taal. Hetzelfde geldt voor een sjabloonlabel dat u naderhand wijzigt, verander het dus alleen als u uw eigen formulering boven de vertalingen verkiest. Voor de optielabels van een Select-attribuut geldt dezelfde regel.

Zichtbaarheid

De zichtbaarheid bepaalt waar het attribuut wordt getoond en wie het mag bewerken:

ZichtbaarheidGedrag
VerborgenWordt niet in het profiel en niet in de Admin Console getoond. Wordt via de API ingesteld, of eenmalig bij de registratie verzameld waar een directory erom vraagt.
Alleen beheerderZichtbaar en bewerkbaar in de Admin Console, niet voor de eindgebruiker.
Profiel + beheerderWordt daarnaast aan de gebruiker in het eigen profiel getoond, waar deze de waarde zelf kan bewerken.

Let op: Zodra een attribuut aan een willekeurige directory is toegewezen, is de zichtbaarheid ervan vergrendeld en kan het attribuut niet worden verwijderd totdat het overal is losgekoppeld. Dit beschermt bestaande gebruikersrecords en de weergave bij registratie en in het profiel tegen afwijking van de definitie.

Toewijzen aan een directory

Elk aangepast attribuut kan aan een directory worden toegewezen, waarmee het beschikbaar wordt op de gebruikers van die directory. Waar de waarde wordt ingesteld, hangt af van de zichtbaarheid:

  • een attribuut met Profiel + beheerder verschijnt in het profiel van de gebruiker en, waar ingeschakeld, bij de registratie; de gebruiker kan het invullen;
  • een attribuut met Alleen beheerder verschijnt bij die gebruikers in de Admin Console, waar u het instelt; het wordt niet aan de gebruiker getoond;
  • een attribuut met Verborgen wordt via de API ingesteld en verschijnt niet in het profiel en niet in de Admin Console. Gebruik dit voor een waarde die een vertrouwende app afneemt (bijvoorbeeld een SAML-attribuut) en die door een integratie in plaats van door een persoon wordt bijgehouden.

In de attribuutconfiguratie van de directory kiest u per attribuut of het bij de registratie verschijnt (daar optioneel of vereist) en of het in het profiel vereist is. Het verzamelen bij de registratie staat los van de zichtbaarheid: een attribuut met Alleen beheerder of Verborgen dat bij de registratie wordt gevraagd, wordt eenmalig door de registrerende persoon ingevuld en is daarna alleen leesbaar waar de zichtbaarheid dat toelaat. Gebruik dit voor gegevens die u bij de registratie nodig hebt, maar die de gebruiker niet opnieuw hoeft te bekijken, zoals een verwijzingscode of een kostenplaats. Een attribuut met Maintained via API only kan niet bij de registratie worden verzameld, omdat de registrerende persoon het veld ervan nooit zou kunnen invullen. De instelling vereist geldt daar waar het attribuut ter bewerking wordt getoond.

Ook de definitie zelf is vanuit dit tabblad bewerkbaar: Attribuut toevoegen → Create new attribute maakt een nieuw attribuut aan en wijst het meteen aan de directory toe, en Edit attribute in het actiemenu van een rij opent het definitievenster (label, type, opties, instellingen). Configureren blijft de plek voor de hierboven beschreven verzamelinstellingen per directory.

De volgorde in de lijst is de weergavevolgorde: de registratie, het profiel van de gebruiker en de detailpagina van de gebruiker tonen de attributen precies zoals hier gerangschikt. Sleep de greep rechts in een rij om de volgorde te wijzigen.

Zie ook

Op deze pagina