Overslaan en naar hoofdcontent gaan
Aanmelden
English (United States)

SSO: Claims beschrijving

  • Bijgewerkt

Een claim is een stukje informatie over een gebruiker dat tijdens het inloggen wordt meegestuurd van de Identity Provider (IdP) naar de Service Provider (SP). Je kunt een claim zien als een eigenschap of kenmerk van de gebruiker.

Claimmapping stelt je in staat om claims die door de OIDC-provider worden aangeleverd, te koppelen aan persoonsvelden binnen Coachview. Voor elke SSO-provider wordt een afzonderlijke mappingconfiguratie opgeslagen.
Voorbeeld
De standaard claimnamen zijn gebaseerd op veelgebruikte OpenID Connect-claimnamen en dienen als uitgangspunt. Deze kunnen worden aangepast zodat ze overeenkomen met de claims die door jouw identiteitsprovider worden verstrekt.

Scenario's

Scenario Resultaat
Claim is aanwezig met een waarde Het bijbehorende Coachview-veld wordt bijgewerkt met de claimwaarde.
Claim is aanwezig met geen waarde (lege string) Het bijbehorende Coachview-veld wordt gewist.
Claim is niet aanwezig De claim wordt genegeerd.
Coachview-veld is niet beschikbaar voor mapping Het veld kan niet worden geselecteerd in de configuratie.

De volgende regels zijn van toepassing:

  1. Bij claimnamen wordt onderscheid gemaakt tussen hoofdletters en kleine letters.
  2. Toewijzingen worden verwerkt in de volgorde waarin ze zijn geconfigureerd. 
  3. Als meerdere toewijzingen betrekking hebben op hetzelfde Coachview-persoonsveld, wordt de 'laatste toewijzing' toegepast. Eerdere toewijzingen voor hetzelfde veld worden overschreven.

Het hierboven beschreven gedrag geldt voor velden met één enkele waarde. Het veld 'Persoonscategorie' vormt hierop een uitzondering, aangezien dit veld meerdere waarden ondersteunt. 

Voor dit veld geldt het volgende:

  1. Waarden die via de claim worden ontvangen, worden **toegevoegd** aan de categorieën die al aan de persoon zijn gekoppeld, in plaats van deze te overschrijven.
  2. Bestaande categorieën die niet in de claim voorkomen, worden 'niet verwijderd'.
  3. Als een categorie al aan de persoon is gekoppeld, wordt deze 'niet opnieuw toegevoegd'.

Let op!

Een persoonscategorie moet bestaan in Coachview. Deze wordt niet automatisch aangemaakt.

Beschikbare persoonsvelden

De onderstaande tabel bevat alle persoonsvelden in Coachview die beschikbaar zijn voor claimmapping. Per veld wordt de standaard claimnaam weergegeven, evenals of het veld meerdere waarden ondersteunt.
Elk Coachview-veld heeft een maximale lengte. Als de waarde die via een claim wordt ontvangen deze maximale lengte overschrijdt, wordt de waarde door Coachview automatisch ingekort zodat deze binnen de toegestane veldlengte past.

Display name

Default claim name

Supports multiple values

Expected value

Last name

family_name

No

string (max. 50)

Prefixes

middle_name

No

string (max. 10)

First name

given_name

No

string (max. 50)

Initials

initials

No

string (max. 50)

Title

title

No

string (max. 50)

Postnominal title

postnominal_title

No

string (max. 50)

Gender

gender

No

man, vrouw, onbekend

Salutation

salutation

No

string (max. 50)

Alternative salutation

alternative_salutation

No

string (max. 50)

Alternative title

alternative_title

No

string (max. 50)

Use birth name by default

birth_use_last_name

No

boolean

Birth last name

birth_family_name

No

string (max. 50)

Birth name prefixes

birth_middle_name

No

string (max. 10)

Address line 1

address_line_1

No

string (max. 100)

Address line 2

address_line_2

No

string (max. 100)

Address line 3

address_line_3

No

string (max. 100)

Address line 4

address_line_4

No

string (max. 100)

Postal code

postal_code

No

string (max. 15)

City

locality

No

string (max. 100)

Country

country_id

No

string (max. 2)

Use private address as billing address

address_use_as_billing

No

boolean

Billing address line 1

billing_address_line_1

No

string (max. 100)

Billing address line 2

billing_address_line_2

No

string (max. 100)

Billing address line 3

billing_address_line_3

No

string (max. 100)

Billing address line 4

billing_address_line_4

No

string (max. 100)

Billing postal code

billing_postal_code

No

string (max. 15)

Billing city

billing_locality

No

string (max. 100)

Billing country

billing_country_id

No

string (max. 100)

Date of birth

birthdate

No

date (dd/mm/yyyy)

Place of birth

place_of_birth

No

string (max. 50)

Phone number 1

phone_number

No

string (max. 50)

Phone number 2

phone_number_2

No

string (max. 50)

Phone number 3

phone_number_3

No

string (max. 50)

Fax number

fax_number

No

string (max. 50)

Email address 1

email

No

string (max. 255)

Email address 2

email_2

No

string (max. 255)

Email address 3

email_3

No

string (max. 255)

Person category

person_category

Yes

boolean

External ID

external_id

No

string (max. 50)

External source

external_source

No

string (max. 50)

SurfConext

OpenID Connect Claim

 Omschrijving
sub

OpenID Subject (comparable to NameID/eduPersonTargetedID in SAML)

given_name

Given name

family_name

Surname
name

Common name (e.g. Prof.dr. John Doe)

nickname

Display name (e.g. Prof.dr. Jane Doe)

preferred_username

Display name (e.g. Prof.dr. Jane Doe)

locale

Preferred language (e.g. nl, en)

email

Email address

email_verified

Boolean, always "true" when an email address is provided
ou

Organizational Unit

schac_home_organization

Organization (e.g. university.nl)

schac_home_organization_type

Organization type (e.g. educationInstitution, universityHospital)

eduperson_affiliation

Affiliation (student, employee, etc)

eduperson_scoped_affiliation

Scoped affiliation (e.g. student@uniharderwijk.nl, faculty@uniharderwijk.nl )

uids

UID (unique code for a person that is used as the login name within the institution)

schac_personal_unique_code

Personal code (e.g. student number)

eduperson_principal_name

EduPersonPrincipleName (This is a scoped identifier. e.g. piet@studenthartingcollege.nl)

eduperson_entitlement

eduPersonEntitlement (e.g. urn:x-surfnet:surf.nl:surfdrive:quota:100)
Lees meer over het configureren van SurfConext: Configureer SURFConext als een SSO provider

September '26

Verwante artikelen