In English

Haka SAML 2.0 -profiili 2.0

SAML 2.0 -profiililla varmistetaan SAML 2.0 -protokollaa käyttävien palveluiden yhteensopivuus määrittämällä käytettävät osat laajasta SAML 2.0 -standardista. Lisäksi määritetään joitakin implementointiin liittyviä yksityiskohtia yhteensopivuuden takaamiseksi.

Hakan uuden profiilin tavoitteena on yhteensopivuus sekä eduGAIN-palvelun käyttämän profiilin että julkishallinnon yhteisen SAML 2.0 -profiilin (ver 1.1) kanssa. eduGAIN:n ja julkishallinnon profiilit perustuvat SAML2 Interoperable Profile versioon 0.2. Laajalla yhteensopivuudella helpotetaan järjestelmäkehittäjien, ohjelmistotoimittajien ja järjestelmiä hankkivien organisaatioiden tehtäviä.

Hakan teknisen ryhmän kokous 4.10.2011 hyväksyi ehdotetun SAML 2.0 profiilin:

Haka SAML 2.0 -profiili versio 2.0

Hakan SAML 2.0 Web SSO -profiili perustuu julkishallinnon yhteiseen SAML 2.0 -profiiliin (ver 1.1). Julkishallinnon profiilin kolmannen sarakkeen yleiset kommentit koskevat myös Hakaa.  Hakan lisäykset profiiliin on lueteltu alla.

Hakan lisäykset ja tarkennukset julkishallinnon profiiliin

Hakan SAML-profiili täydentää julkishallinon yhteistä SAML 2.0 -profiilia (ver 1.1) seuraavilla lisäyksillä:

  • Hakaan rekisteröidyt IdP- ja SP-palvelimet voivat käyttää kaikkien varmentajien X.509 -varmenteita (mukaanlukien itseallekirjoitetut varmenteet). Varmenteessa käytetyn RSA-avaimen minimikoko on 2048 bittiä.
  • SP:n ja IdP:n SAML-viestien vaihtoon rekisteröidyt osoitteet tulee suojata TLS/SSL protokollalla.
  • Haka-metadata on allekirjoitettu Digi- ja  väestötietoviraston -varmennepalvelun (DVV) antamalla varmenteella. Metadatan käyttäjän tulee varmistaa allekirjoituksen lisäksi, ettei käytetty varmenne ole sulkulistalla.
  • Kappaleessa Additional extensions määritellyn Single logout:in totetuttaminen on valinnaista.
  • Hakassa välitettävät attribuutit on kuvattu ja määritelty FunetEduPerson-skeemassa.
  • Rajatut attribuutit (scoped attributes). FunetEduPerson skeemassa on kaksi rajattua attribuuttia: eduPersonPrincipalName ja eduPersonScopedAffiliation. Kotiorganisaatiot saavat populoida rajatut attribuutit vain omistamillaan rajauksilla (esim. ePPN jalauros@csc.fi vain CSC:n IdP:n toimesta).  Rajattua attribuuttia hyödyntävän tahon olisi suositeltavaa tarkistaa että rajaus on sallittu. Haka- operaattori julkaisee listan sallituista kotiorganisaatioiden rajauksista osana Haka-metadataa.

Voimaantulo

Profiili astui voimaan 1.12.2011.


Haka SAML 2.0 -profiili 3.0 

Hyväksyntää odottava versio

SAML 2.0 -profiililla varmistetaan SAML 2.0 -protokollaa käyttävien palveluiden yhteensopivuus määrittämällä käytettävät osat laajasta SAML 2.0 -standardista. Lisäksi määritetään joitakin implementointiin liittyviä yksityiskohtia yhteensopivuuden takaamiseksi.

Hakan uuden profiilin tavoitteena on yhteensopivuus sekä eduGAIN-palvelun käyttämän profiilin että Kantaran SAML V2.0 Deployment Profile for Federation Interoperability kanssa.  Laajalla yhteensopivuudella helpotetaan järjestelmäkehittäjien, ohjelmistotoimittajien ja järjestelmiä hankkivien organisaatioiden tehtäviä.


Hakan uutta profiilia tulisi tulkita seuraavalla prioriteettijärjestyksellä:

  1. FunetEduPerson skeema määrittää attribuutteja
  2. SAML2int määrittää attribuutteja


Haka SAML 2.0 -profiili versio 3.0

Hakan SAML 2.0 Web SSO -profiili perustuu Kantaran SAML V2.0 Deployment Profile for Federation Interoperability profiiliin.  Hakan profiiliin suunnitellut  lisäykset on lueteltu alla.

Hakan profiilin suunnitellut lisäykset ja tarkennukset verrattuna Kantaran profiiliin

Hakan SAML-profiili täydentää Kantaran SAML V2.0 Deployment Profile for Federation Interoperability seuraavilla lisäyksillä:

Kantara SAML V2.0 Deployment Profile for Federation Interoperability profiilin täydennykset

  • Muiden kuin profiilissa määriteltyjen algoritmien käyttö on IdP-ylläpidon harkinnan varassa  [SDP-ALG01]
  • Hakaan rekisteröidyjen uusien ja päivitettävien IdP- ja SP-palvelimien varmenteessa käytettyjen RSA-avaimen, mukaanlukien itseallekirjoitetut varmenteet, minimikoon on oltava jatkossa 4096 bittiä  [SDP-MD06] 
  • Haka-palveluissa ei suositella käytettävän EC-avaimia yhteensopivuushaasteiden vuoksi. [SDP-MD07]
  • SubjectID:tä tulee tukea, mutta vanhoja tunnisteita saa myös käyttää [SDP-SP13],[SDP-SP14],[SDP-SP15]
  • IdP:den pitää tukea myös vanhoja palveluita, jotka hyväksyvät vain persistent tyyppisiä tunnisteita [SDP-IDP15], [SDP-IDP16], [SDP-IDP17]
  • Mikäli SP ei tue useampaa allekirjoitusvarmennetta, voi tämä aiheuttaa SP:lle käyttökatkoja. [SDP-SP37] [SDP-SP38]
  • Hakassa välitettävät attribuutit ovat kuvatut ja määritellyt FunetEduPerson-skeemassa.
  • Rajatut attribuutit (scoped attributes). FunetEduPerson skeemassa on kaksi rajattua attribuuttia: eduPersonPrincipalName ja eduPersonScopedAffiliation. Kotiorganisaatiot saavat populoida rajatut attribuutit vain omistamillaan rajauksilla (esim. ePPN eskoesimerkki@csc.fi vain CSC:n IdP:n toimesta).  Rajattua attribuuttia hyödyntävän tahon olisi suositeltavaa tarkistaa että rajaus on sallittu. Haka-operaattori julkaisee listan sallituista kotiorganisaatioiden rajauksista osana Haka-metadataa.


Aikataulu

  • 1.8.2025 Muutokset toteutettu Hakan testipalvelimille, soveltuvassa laajuudessa
  • 1.10.2025 Profiili voimaan Hakassa