Core attributes

Identity providers in YETKİM are required to produce and release the following attributes as defined here, for interoperability within YETKİM and across eduGAIN.

Summary

AttributeOIDValues
givenNameurn:oid:2.5.4.42single
snurn:oid:2.5.4.4single
displayNameurn:oid:2.16.840.1.113730.3.1.241single
mailurn:oid:0.9.2342.19200300.100.1.3multiple
schacHomeOrganizationurn:oid:1.3.6.1.4.1.25178.1.2.9single
schacHomeOrganizationTypeurn:oid:1.3.6.1.4.1.25178.1.2.10multiple
eduPersonAffiliationurn:oid:1.3.6.1.4.1.5923.1.1.1.1multiple
eduPersonScopedAffiliationurn:oid:1.3.6.1.4.1.5923.1.1.1.9multiple
eduPersonPrincipalNameurn:oid:1.3.6.1.4.1.5923.1.1.1.6single
eduPersonTargetedIDurn:oid:1.3.6.1.4.1.5923.1.1.1.10multiple
eduPersonEntitlementurn:oid:1.3.6.1.4.1.5923.1.1.1.7multiple
schacPersonalUniqueCodeurn:oid:1.3.6.1.4.1.25178.1.2.14multiple

Values: single means the attribute holds exactly one value, multiple means it can hold more than one.

givenName

single

The person's given name.

OID
urn:oid:2.5.4.42
Example
Ayşe FatmaMehmet Ali

This attribute can normally hold several values, for example Mehmet and Ali for Mehmet Ali. In YETKİM it must be used once, as Mehmet Ali.

sn (surname)

single

The person's surname.

OID
urn:oid:2.5.4.4
Example
KayaYıldız Şahin
Reference
eduPerson#sn

This attribute can normally hold several values, for example Yıldız and Şahin, or even Yıldız-Şahin, for Yıldız Şahin. In YETKİM it must be used once, as Yıldız Şahin.

displayName

single

The person's preferred name for display. Usually givenName sn.

OID
urn:oid:2.16.840.1.113730.3.1.241
Example
Elif DeğerliAhmet Kara

mail

multiple

The person's e-mail address.

OID
urn:oid:0.9.2342.19200300.100.1.3
Example
ahmet.yigit@ankara.edu.trelifk@ankara.edu.tr

May hold several values, but an institutional address of the form kullanici@universite.edu.tr is preferred.

schacHomeOrganization

single

The domain name of the person's home organisation.

OID
urn:oid:1.3.6.1.4.1.25178.1.2.9
Example
istanbul.edu.tr
Reference
SCHAC

schacHomeOrganizationType

multiple

The type of the person's home organisation.

OID
urn:oid:1.3.6.1.4.1.25178.1.2.10
Example
urn:schac:homeOrganizationType:int:universityurn:schac:homeOrganizationType:int:researchHospitalurn:schac:homeOrganizationType:int:nrenurn:schac:homeOrganizationType:int:other
Reference
SCHAC

Universities in YETKİM must use urn:schac:homeOrganizationType:int:university.

eduPersonAffiliation

multiple

The person's relationship to the institution (broad category).

OID
urn:oid:1.3.6.1.4.1.5923.1.1.1.1
Example
studentfacultymember

This attribute takes one or more of the following values:

faculty
academic staff
student
student
staff
administrative staff
member
everyone with a direct relationship to the institution. Anyone who is faculty, student or staff must also be member. People outside these three whose relationship can be described as member must also be member.
affiliate
people without a direct relationship who cannot be described as member (neither employees nor students). For example guests, parents of students, external auditors.
alum
graduate
library-walk-in
people from outside the institution using the library (not expected to be common)
Example assignments
PersonValues
Academic stafffacultymember
Studentstudentmember
Administrative staffstaffmember
Research assistant who is a PhD studentfacultystudentmember
Administrative staff doing a master's degreestaffstudentmember
Parent of a studentaffiliate
Graduatealum
Full employee not described as staff, faculty or studentmember

If the attribute contains faculty, staff or student, it must also contain member.

eduPersonScopedAffiliation

multiple

The person's affiliation within a given security domain (scope), broad category.

OID
urn:oid:1.3.6.1.4.1.5923.1.1.1.9
Example
student@izmir.edu.trfaculty@izmir.edu.trmember@izmir.edu.tr

The value has the form x@y. x is one of the values allowed in eduPersonAffiliation (such as student or faculty). y is the security domain (scope) and equals the part of eduPersonPrincipalName after the @.

For example, if your scope is izmir.edu.tr:

  • for a student: student@izmir.edu.tr, member@izmir.edu.tr
  • for academic staff: faculty@izmir.edu.tr, member@izmir.edu.tr

Service providers use this attribute often, because its value carries both the person's relationship to the institution and the institution itself.

eduPersonPrincipalName

single

A scoped identifier for the person.

OID
urn:oid:1.3.6.1.4.1.5923.1.1.1.6
Example
elif.kocak@adana.edu.trefy24@adana.edu.tr

The value must have the form user@scope. user must be unique within the scope; two people in the same scope cannot share it. A user@scope value that has been used must never be assigned to another person.

Although the value looks like, and is often the same as, an e-mail address, it must not be used as one.

It usually has a readable value such as ayse.gezer@bursa.edu.tr, but it does not have to: 743567@bursa.edu.tr is valid too.

As a rule, a user value used in a scope should not be reused and a person's value should not change. Institutions may be unable to follow this rule in exceptional cases, so service providers relying on eduPersonPrincipalName should take that into account.

eduPersonTargetedID

multiple

A persistent, non-reassigned, opaque and targeted identifier for the person.

OID
urn:oid:1.3.6.1.4.1.5923.1.1.1.10
<saml:NameID
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
    NameQualifier="https://kimlik.universite.edu.tr/simplesaml/saml2/idp/metadata.php"
    SPNameQualifier="https://sp.servis.com.tr/simplesaml/module.php/saml/sp/metadata.php/ornek-servis"
    Format="urn:oasis:names:tc:SAML:2.0:nameid-format:persistent">
        1e4774a0270be2d549196deebb61b1f20d183bc4
</saml:NameID>

An attribute form of the SAML 2.0 name identifier (NameID) in the urn:oasis:names:tc:SAML:2.0:nameid-format:persistent format. Its value is a tuple of a person identifier, the service provider's entityID and the identity provider's entityID.

The NameID is carried in the SAML assertion the identity provider sends after authentication and identifies the subject. It is not an attribute itself.

  • Each service provider gets a different identifier for the same person (targeted).
  • The identifier is persistent and stays valid for a very long time.
  • The identifier is opaque. No personal information can be derived from it, which protects privacy.
  • The identifier is unique. No two people share a value for the same identity and service provider pair, and a value is never reassigned.

The persistent NameID, and so eduPersonTargetedID, is usually computed by an algorithm from the values of certain attributes and a salt. For the result to be unique for all time, the attributes used must be unique for all time as well.

For example, a username attribute cannot be used, because the same username may be given to someone else two years later. Today's ali and the ali two years from now may be different people, yet both would get the same identifier.

If, on the other hand, a uid attribute holds an identifier that is unique to the person and will never be reused (a unix user id or a UUID), it can be used. username alone is not enough, but username together with the account creation date creationDate can be unique for all time and both can be used in the computation.

eduPersonEntitlement

multiple

The person's entitlements to specific resources. Values are URIs (URL or URN).

OID
urn:oid:1.3.6.1.4.1.5923.1.1.1.7
Example
urn:mace:dir:entitlement:common-lib-termshttps://kimlik.diyarbakir.edu.tr/entitlement/proxy/

Values and their meaning are usually defined by service providers. For example, people with https://kimlik.diyarbakir.edu.tr/entitlement/proxy/ can use the diyarbakir.edu.tr proxy service, and people with https://kimlik.diyarbakir.edu.tr/entitlement/proxy/admin are administrators of it.

People with urn:mace:dir:entitlement:common-lib-terms can access the Elsevier ScienceDirect database.

A service provider can define entitlements for its service and leave assigning them to home organisations. In the proxy example above, user and administrator rights are granted by the home organisation (identity provider) through eduPersonEntitlement, and nothing is assigned on the service side.

schacPersonalUniqueCode

multiple

A unique code associated with the person, such as a student or staff number.

OID
urn:oid:1.3.6.1.4.1.25178.1.2.14
Example
urn:schac:personalUniqueCode:int:esi:sinop.edu.tr:54332-7urn:schac:personalUniqueCode:int:esi:kars.edu.tr:O92435

This attribute carries the European Student Identifier (ESI). The ESI is globally unique, persistent, non-targeted, protocol neutral and data transport neutral.

In YETKİM the ESI must be expressed as:

urn:schac:personalUniqueCode:int:esi:<sHO>:<code>
<sHO>
The schacHomeOrganization value of the person's institution, for example sinop.edu.tr
<code>
A code uniquely identifying the student within the scope, for example 54332-7 or O92435. It must meet the requirements in RFC 2141 sections 2.2 to 2.4.

Within <sHO>, a <code> must always point to one student and allow the student record to be found. It is usually the student number. Using the Turkish national ID number is strongly discouraged.

Releasing this attribute is required for smooth access to Erasmus Without Paper services. The value must not exceed 255 characters in total.

↑ ↓ to move, Enter to open, Esc to close