Teknik gereksinimler

SAML 2.0 kimlik sağlayıcısı kurun

Kurumun kendine ait bir kimlik doğrulama altyapısı olmalıdır. Bu altyapının üzerine Shibboleth ya da SimpleSAMLphp ile SAML 2.0 destekleyen bir kimlik sağlayıcı kurulur. Kurulum dört aşamadan oluşur:

Kullanıcı doğrulama (User Authentication)

Kurumun kimlik doğrulama altyapısı kullanılarak kullanıcının doğrulanması.

Nitelik çözümleme (Attribute Resolution)

Doğrulanan kişi (subject) hakkında niteliklerin toplanması. Bu işlem bazen doğrulama sırasında, bazen sonrasında yapılır. Bilgiler kimlik doğrulama altyapısından ya da SQL, web servisi gibi başka sistemlerden alınabilir, birleştirilebilir, dönüştürülebilir ya da sabit değer olarak verilebilir. Toplanan niteliklerin bir kısmı daha sonra servis sağlayıcıya iletilir.

Nitelik yayımlama (Attribute Release)

Kişiye ait hangi niteliklerin hangi servise yayımlanacağına karar verilmesi. Bunun için gerekli kurallar tanımlanır.

Üstverilerin düzenli olarak çekilmesi

YETKİM ve eduGAIN içindeki servislere ait güncel üstverinin periyodik olarak çekilmesi.

Çekirdek nitelikleri yayımlayın

Kimlik sağlayıcı, YETKİM için belirlenmiş çekirdek nitelikleri düzgün ve doğru biçimde yayımlayabilmelidir.

Üstverideki kurum, servis ve irtibat bilgilerini tamamlayın

Kurum bilgileri

Kurum adı, web sayfası ve benzeri bilgiler.

İrtibat bilgileri

En az teknik (technical) ve destek (support) irtibatı. İrtibatlar kişi değil grup olmalı, e-posta adresleri de bir takma ad ya da liste olmalıdır. Örnek: Kimlik Destek, kimlik-destek@universite.edu.tr

MDUI

Oturum açma ve keşif arayüzleri için üstveri eklentileri (Metadata Extensions for Login and Discovery User Interface): servis adı, tanımı, logo, bilgi sayfası, gizlilik sayfası ve keşif servisleri için ipuçları.

Üstveriyi eduGAIN doğrulayıcısıyla denetleyin

Kurum üstverisinin doğruluğu technical.edugain.org/validator adresinden denetlenir.

• Formda Metadata URL contains only one entity seçeneği işaretlenmelidir.
• Dil olarak hem Türkçe (tr) hem İngilizce (en) seçilmelidir.
• Bu aşamada mdrpi:RegistrationInfo ile ilgili hatalar göz ardı edilebilir.

Üstveriyi YETKİM'e gönderin

Kurum üstverisi yetkim@ulakbim.gov.tr adresine gönderilir. Üstveri kontrol edilir, sorun yoksa YETKİM test altyapısına eklenir. Varsayılan varlık kimliği (entityID) ve üstveri adresleri:

Üstveri adresiniz aynı zamanda kimlik sunucunuzun varlık kimliği olur. Kurum üstverisine bu kimlik üzerinden erişilir ve servis sağlayıcılar kurum kullanıcılarına bu kimlik üzerinden yetki verir.

Alan adı. Varlık kimliği alan adına bağlıdır. Alan adı değişirse YETKİM kapsamındaki servislere erişimde sorun yaşanabilir.

Test ortamında deneyin ve katılım isteği gönderin

Test altyapısına eklenen kurum, YETKİM test servislerini test.yetkim.org.tr adresinden kontrol eder. Sorun yoksa kurumun YETKİM yetkilisi, kimlik sunucusunun YETKİM altyapısına katılım isteğini yetkim@ulakbim.gov.tr adresine e-postayla iletir.

Kayıt bilgisi eklenirYETKİM tarafından

Bu aşamada kurum üstverisi son kez kontrol edilir ve üstveriye kayıt bilgisi (mdrpi:RegistrationInfo) eklenir.

Üstveri YETKİM'e ve eduGAIN'e dahil edilirYETKİM tarafından

Kimlik sunucusunun üstverisi YETKİM'e dahil edilir ve aynı anda eduGAIN üstveri havuzuna gönderilir. Birkaç saat içinde, en geç bir gün içinde, eduGAIN aracılığıyla eduGAIN'deki tüm servislere ulaşır.

Katılımcı listesine eklenirYETKİM tarafından

Bu aşamalar tamamlandığında kurum, YETKİM katılımcılar listesine eklenir.

Nitelik yayımını eduGAIN'de test edin

Üstverisi dağıtılan kurum, eduGAIN'in nitelik yayımlama test servislerini (release-check.edugain.org) kullanarak gerekli kontrolleri yapar.

F-Ticks ayarlarını yapın

Kurum, servis kullanım bilgisi için F-Ticks ayarlarını yapmalıdır. F-Ticks bilgisi varsayılan olarak hem YETKİM'e hem eduGAIN'e gönderilir. Kurum isterse yalnızca YETKİM'e de gönderebilir.

Shibboleth ve SimpleSAMLphp ayarları için f-ticks.edugain.org/techidp.html sayfasına bakın.

Varlık kategorileri (isteğe bağlı)

Belirli varlık kategorilerine dahil olmak isteyen kimlik sağlayıcılar YETKİM ile iletişime geçer. Değerlendirme sonucuna göre uygun varlık kategorileri üstveriye eklenir.