Çekirdek nitelikler

YETKİM üyesi kimlik sağlayıcılar, YETKİM içinde ve eduGAIN üzerinden ortak çalışabilirlik için aşağıdaki nitelikleri buradaki tanımlara uygun biçimde üretmek ve yayımlamakla yükümlüdür.

Nitelik	OID	Değer sayısı
givenName	`urn:oid:2.5.4.42`	tek
sn	`urn:oid:2.5.4.4`	tek
displayName	`urn:oid:2.16.840.1.113730.3.1.241`	tek
mail	`urn:oid:0.9.2342.19200300.100.1.3`	çok
schacHomeOrganization	`urn:oid:1.3.6.1.4.1.25178.1.2.9`	tek
schacHomeOrganizationType	`urn:oid:1.3.6.1.4.1.25178.1.2.10`	çok
eduPersonAffiliation	`urn:oid:1.3.6.1.4.1.5923.1.1.1.1`	çok
eduPersonScopedAffiliation	`urn:oid:1.3.6.1.4.1.5923.1.1.1.9`	çok
eduPersonPrincipalName	`urn:oid:1.3.6.1.4.1.5923.1.1.1.6`	tek
eduPersonTargetedID	`urn:oid:1.3.6.1.4.1.5923.1.1.1.10`	çok
eduPersonEntitlement	`urn:oid:1.3.6.1.4.1.5923.1.1.1.7`	çok
schacPersonalUniqueCode	`urn:oid:1.3.6.1.4.1.25178.1.2.14`	çok

Değer sayısı: tek, niteliğin yalnızca bir değer alabileceğini; çok, birden fazla değer alabileceğini belirtir.

givenName

tek

Kişinin adı.

OID: urn:oid:2.5.4.42
Örnek: Ayşe FatmaMehmet Ali
Referans: eduPerson#givenName

Bu nitelik normalde birden fazla değer alabilir, örneğin Mehmet Ali için Mehmet ve Ali. YETKİM'de ise tek değer olarak, Mehmet Ali biçiminde kullanılmalıdır.

sn (surname)

tek

Kişinin soyadı.

OID: urn:oid:2.5.4.4
Örnek: KayaYıldız Şahin
Referans: eduPerson#sn

Bu nitelik normalde birden fazla değer alabilir, örneğin Yıldız Şahin için Yıldız ve Şahin, hatta Yıldız-Şahin. YETKİM'de ise tek değer olarak, Yıldız Şahin biçiminde kullanılmalıdır.

displayName

tek

Kişinin adı gösterilirken kullanılacak, tercih ettiği ad. Genellikle givenName sn biçimindedir.

OID: urn:oid:2.16.840.1.113730.3.1.241
Örnek: Elif DeğerliAhmet Kara
Referans: eduPerson#displayName

mail

çok

Kişinin e-posta adresi.

OID: urn:oid:0.9.2342.19200300.100.1.3
Örnek: ahmet.yigit@ankara.edu.trelifk@ankara.edu.tr
Referans: eduPerson#mail

Birden fazla değer alabilir, ancak kullanici@universite.edu.tr biçiminde kurumsal e-posta adresi olması tercih edilir.

schacHomeOrganization

tek

Kişinin bağlı olduğu ev kurumun (home organization) alan adı.

OID: urn:oid:1.3.6.1.4.1.25178.1.2.9
Örnek: istanbul.edu.tr
Referans: SCHAC

schacHomeOrganizationType

çok

Kişinin bağlı olduğu ev kurumun türü.

OID: urn:oid:1.3.6.1.4.1.25178.1.2.10
Örnek: urn:schac:homeOrganizationType:int:universityurn:schac:homeOrganizationType:int:researchHospitalurn:schac:homeOrganizationType:int:nrenurn:schac:homeOrganizationType:int:other
Referans: SCHAC

YETKİM'de üniversiteler urn:schac:homeOrganizationType:int:university değerini kullanmalıdır.

eduPersonAffiliation

çok

Kişinin kurumuyla olan ilişkisi (geniş kategori).

OID: urn:oid:1.3.6.1.4.1.5923.1.1.1.1
Örnek: studentfacultymember
Referans: eduPerson#eduPersonAffiliation

Bu nitelik aşağıdaki değerlerden birini ya da birkaçını alabilir:

faculty: akademik personel
student: öğrenci
staff: idari personel
member: kurumla doğrudan ilişkisi olan herkes. faculty, student ya da staff olan herkes member da olmalıdır. Bu üçü dışında kalıp kurumla ilişkisi member olarak tanımlanabilen kişiler de member olmalıdır.
affiliate: kurumla doğrudan ilişkisi olmayan, member olarak tanımlanamayan (çalışan ya da öğrenci olmayan) kişiler. Örneğin misafirler, öğrenci velileri, dış denetçiler.
alum: mezun
library-walk-in: kurum dışından gelip kütüphaneyi kullanan kişiler (yaygın kullanılması beklenmez)

Örnek değer atamaları
Kişi	Değerler
Akademik personel	`facultymember`
Öğrenci	`studentmember`
İdari personel	`staffmember`
Doktora öğrencisi araştırma görevlisi	`facultystudentmember`
Yüksek lisans yapan idari personel	`staffstudentmember`
Öğrenci velisi	`affiliate`
Mezun	`alum`
staff, faculty ya da student sayılmayan tam zamanlı çalışan	`member`

Nitelikte faculty, staff ya da student değerlerinden biri varsa, member değeri de bulunmalıdır.

eduPersonScopedAffiliation

çok

Kişinin belirli bir güvenlik alanı (kapsam, scope) içindeki ilişkisi (geniş kategori).

OID: urn:oid:1.3.6.1.4.1.5923.1.1.1.9
Örnek: student@izmir.edu.trfaculty@izmir.edu.trmember@izmir.edu.tr
Referans: eduPerson#eduPersonScopedAffiliation

Değeri x@y biçimindedir. x, eduPersonAffiliation niteliğinin alabileceği değerlerden biridir (student, faculty gibi). y ise güvenlik alanıdır (kapsam) ve eduPersonPrincipalName değerinin @ işaretinden sonraki kısmıyla aynıdır.

Örneğin kapsamınız izmir.edu.tr ise:

öğrenci için student@izmir.edu.tr, member@izmir.edu.tr
akademik personel için faculty@izmir.edu.tr, member@izmir.edu.tr

Bu nitelik servis sağlayıcılar tarafından sıkça kullanılır, çünkü değeri hem kişinin kurumla ilişkisini hem de kurum bilgisini aynı anda taşır.

eduPersonPrincipalName

tek

Kişi için kapsamı (scope) olan bir tanımlayıcı.

OID: urn:oid:1.3.6.1.4.1.5923.1.1.1.6
Örnek: elif.kocak@adana.edu.trefy24@adana.edu.tr
Referans: eduPerson#eduPersonPrincipalName

Değeri kullanıcı@kapsam biçiminde olmalıdır. kullanıcı, verilen kapsamda benzersiz olmalıdır; aynı kapsamda iki kişi aynı kullanıcı değerini kullanamaz. Bir kez kullanılmış bir kullanıcı@kapsam değeri hiçbir zaman başka bir kişiye verilmemelidir.

Değeri e-posta adresine benzese, hatta çoğu zaman e-posta adresiyle aynı olsa da, bu nitelik e-posta adresi gibi kullanılmamalıdır.

Genellikle ayse.gezer@bursa.edu.tr gibi okunabilir bir değeri olur, ama böyle olmak zorunda değildir: 743567@bursa.edu.tr da geçerlidir.

Kural olarak bir kapsamda kullanılmış kullanıcı değeri yeniden kullanılmamalı ve bir kişinin değeri değiştirilmemelidir. Ancak kurumlar zorunlu durumlarda bu kurala uyamayabilir. eduPersonPrincipalName kullanan servis sağlayıcılar bunu hesaba katmalıdır.

eduPersonTargetedID

çok

Kişi için kalıcı (persistent), yeniden atanmayan, opak ve hedefli (targeted) bir tanımlayıcı.

OID: urn:oid:1.3.6.1.4.1.5923.1.1.1.10
Referans: eduPerson#eduPersonTargetedID

<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>

urn:oasis:names:tc:SAML:2.0:nameid-format:persistent biçimindeki SAML 2.0 ad tanımlayıcısının (NameID) nitelik haline getirilmiş halidir. Değeri; kişi tanımlayıcısı, servis sağlayıcının varlık kimliği ve kimlik sağlayıcının varlık kimliğinden oluşan bir üçlüdür.

Ad tanımlayıcı, kimlik doğrulamanın ardından kimlik sunucusundan gelen SAML Assertion mesajında yer alır ve kullanıcıyı (subject) tanımlar. Kendisi bir nitelik değildir.

Her servis sağlayıcı için farklı bir kişi tanımlayıcısı üretilir (hedefli tanımlayıcı).
Tanımlayıcı kalıcıdır, çok uzun süre geçerli kalır.
Tanımlayıcı opaktır. Değerinden kişisel bilgi çıkarılamaz, bu da gizliliği sağlar.
Tanımlayıcı benzersizdir. Aynı kimlik ve servis sağlayıcı çifti için iki kişi aynı değere sahip olamaz, değer başka bir kişiye yeniden verilemez.

Kalıcı ad tanımlayıcısı, dolayısıyla eduPersonTargetedID, genellikle belirli niteliklerin değerleri ve bir tuz (salt) kullanılarak bir algoritmayla hesaplanır. Sonucun her zaman benzersiz olması için hesaplamada kullanılan niteliklerin de her zaman benzersiz olması gerekir.

Örneğin kullanıcı adını tutan username niteliği bu hesaplamada kullanılamaz, çünkü aynı kullanıcı adı iki yıl sonra başka bir kişiye verilebilir. Bugünkü ali ile iki yıl sonraki ali farklı kişiler olabilir, ama ikisi için de aynı tanımlayıcı hesaplanır.

Buna karşılık uid niteliğinde kişiye özgü ve başkasına hiç verilmeyecek bir kimlik tutuluyorsa (unix userid ya da UUID gibi), bu nitelik hesaplamada kullanılabilir. username tek başına yeterli değildir ama username ile hesabın oluşturulma tarihi creationDate birlikte her zaman benzersiz olabilir ve hesaplamada birlikte kullanılabilir.

eduPersonEntitlement

çok

Kişinin belirli kaynaklar için yetkileri. Değeri URI (URL ya da URN) biçimindedir.

OID: urn:oid:1.3.6.1.4.1.5923.1.1.1.7
Örnek: urn:mace:dir:entitlement:common-lib-termshttps://kimlik.diyarbakir.edu.tr/entitlement/proxy/
Referans: eduPerson#eduPersonEntitlement

Bu niteliğin değerlerini ve anlamlarını genellikle servis sağlayıcılar belirler. Örneğin https://kimlik.diyarbakir.edu.tr/entitlement/proxy/ yetkisine sahip kişiler diyarbakir.edu.tr proxy hizmetini kullanabilir. https://kimlik.diyarbakir.edu.tr/entitlement/proxy/admin yetkisine sahip olanlar aynı hizmette yönetici olur.

urn:mace:dir:entitlement:common-lib-terms yetkisine sahip kişiler Elsevier ScienceDirect veritabanına erişebilir.

Servis sağlayıcı kendi servisi için yetki tanımlarını yaparak, kişilere yetki dağıtma işini ev kurumlara bırakabilir. Yukarıdaki proxy örneğinde normal kullanıcı ve yönetici yetkileri eduPersonEntitlement aracılığıyla ev kurum (kimlik sağlayıcı) tarafından verilir, servis tarafında ayrıca yetki dağıtılmaz.

schacPersonalUniqueCode

çok

Kişiyle ilişkili benzersiz kod. Öğrenci numarası ya da personel numarası olabilir.

OID: urn:oid:1.3.6.1.4.1.25178.1.2.14
Örnek: urn:schac:personalUniqueCode:int:esi:sinop.edu.tr:54332-7urn:schac:personalUniqueCode:int:esi:kars.edu.tr:O92435
Referans: SCHAC, European Student Identifier

Bu nitelik Avrupa Öğrenci Tanımlayıcısı (European Student Identifier, ESI) bilgisini taşımak için kullanılır. ESI evrensel olarak benzersiz, kalıcı, hedefsiz, protokolden ve veri aktarım yönteminden bağımsız bir tanımlayıcıdır.

YETKİM'de ESI şu biçimde tanımlanmalıdır:

urn:schac:personalUniqueCode:int:esi:<sHO>:<code>

<sHO>: Kişinin kurumunun schacHomeOrganization değeri, örneğin sinop.edu.tr
<code>: Kapsam içinde öğrenciyi benzersiz olarak tanımlayan kod, örneğin 54332-7 ya da O92435. Kod, RFC 2141 bölüm 2.2 ile 2.4 arasındaki gereklilikleri karşılamalıdır.

<sHO> içinde <code> her zaman tek bir öğrenciyi göstermeli ve öğrenci bilgisine bu kodla erişilebilmelidir. Genellikle öğrenci numarası kullanılır. T.C. kimlik numarası kullanılması kesinlikle önerilmez.

Kağıtsız Erasmus hizmetlerine sorunsuz erişim için bu niteliğin üretilip yayımlanabilmesi gerekir. Değer toplamda 255 karakteri geçmemelidir.