„HREF metadata specifikáció” változatai közötti eltérés

Innen: KIFÜ Wiki
a (→‎Metaadat kiterjesztések használata)
16. sor: 16. sor:
 
** minden szöveges mezőt legalább két nyelven: magyarul és angolul ki kell tölteni
 
** minden szöveges mezőt legalább két nyelven: magyarul és angolul ki kell tölteni
 
** kötelezően kitöltendőek az intézményi, adminisztratív információk (<code>Organization</code> illetve <code>ContactPerson</code> elemek)
 
** kötelezően kitöltendőek az intézményi, adminisztratív információk (<code>Organization</code> illetve <code>ContactPerson</code> elemek)
 +
** ajánlott megadni egy helpdesk URL-r, ahova hiba esetén a felhasználók fordulhatnak (<code>errorURL</code> attribútum)
 
** SP-k esetén további kötelező elemek
 
** SP-k esetén további kötelező elemek
−
*** <code>AttributeConsumingService</code>, ami megadja a kért attribútumokat (<code>RequestedAttributes</code> - itt az attribútum informális neve is szerepeljen) illetve a szolgáltatás nevét
+
*** <code>AttributeConsumingService</code>, ami megadja a kért attribútumokat
−
*** a szolgáltatás elérhetősége (egy URL, amin a szolgáltatás bemutatkozik)
+
**** <code>RequestedAttributes</code> - itt az attribútum informális neve is szerepeljen
−
*** adatkezelési szabályzatra mutató URL
+
**** <code>ServiceName</code>, <code>ServiceDescription</code> az SP szolgáltatás neve és leírása
 +
*** a szolgáltatás elérhetősége, amin a szolgáltatás bemutatkozik (extension)
 +
*** adatkezelési szabályzatra mutató URL (extension)
 
** IdP-k esetén
 
** IdP-k esetén
−
*** a scope csak az adott intézmény kezelésében levő domain név lehet
+
*** a scope csak az adott intézmény kezelésében levő domain név lehet (Shibboleth extension)
−
*** helpdesk URL, ahova hiba esetén a felhasználók fordulhatnak
+
** lehetőség van további adatok megadására is
−
** egyéb
+
*** logó
−
*** lehetőség van logó illetve gps koordináták tárolására is
+
*** gps koordináták, IP cím tartomány
  
 
== Metaadat kiterjesztések használata ==
 
== Metaadat kiterjesztések használata ==
 
A metaadatban tárolt egyéb információkat a http://docs.oasis-open.org/security/saml/Post2.0/sstc-metadata-attr-cd-01.html specifikáció ('entity attributes') alapján tároljuk. Ez a kiegészítő séma lehetőséget ad SAML attribútumok használatára.
 
A metaadatban tárolt egyéb információkat a http://docs.oasis-open.org/security/saml/Post2.0/sstc-metadata-attr-cd-01.html specifikáció ('entity attributes') alapján tároljuk. Ez a kiegészítő séma lehetőséget ad SAML attribútumok használatára.
 +
 +
A kiegészítő attribútumok discovery service-ben való használhatóságával kapcsolatban lásd a [https://spaces.internet2.edu/display/~lajoie@idp.protectnetwork.org/DSAttribs Shibboleth DS fejlesztők szabványtervezetét].
  
 
{| class="wikitable"
 
{| class="wikitable"
58. sor: 63. sor:
 
| logó
 
| logó
 
| :logo
 
| :logo
−
| Az IdP/SP logójának elérhetősége (URL)
+
| Az IdP/SP logójának elérhetősége
−
| Engedélyezett formátumok: GIF, JPEG, PNG. Minimális méret: 20x20 pixel. Maximális méret: 200x200 pixel.
+
| Formátummal kapcsolatban lásd [[#Logo]]
 
|-
 
|-
 
| ip cím tartomány
 
| ip cím tartomány
−
| :network-addresses
+
| :hint:ip
 
| (Csak az IdP-knél) az intézmény hálózati tartománya(i). IdP felderítés esetén előválasztás lehetséges ennek alapján.
 
| (Csak az IdP-knél) az intézmény hálózati tartománya(i). IdP felderítés esetén előválasztás lehetséges ennek alapján.
 
| CIDR, több érték is megadható
 
| CIDR, több érték is megadható
 
|}
 
|}
 +
 +
=== Logo ===
 +
* formátum: transzparens hátterű PNG, vagy transzparens hátterű GIF
 +
* oldalarány 1:1 vagy 16:9
 +
* ajánlott méret: 16x16 pixel, maximális méret 200x200 pixel
 +
* attribútumok
 +
** <code>source</code> (kötelező): URL
 +
** <code>link</code>: opcionális link
 +
** <code>height</code>: opcionális magasság érték pixelben
 +
** <code>width</code>: opcionális szélesség érték pixelben
  
 
== Egy IdP példa ==
 
== Egy IdP példa ==

A lap 2010. január 15., 15:28-kori változata

Metaadat specifikáció


Attention.png FIGYELEM!
A specifikáció kidolgozása folyamatban van, lényeges változások is belekerülhetnek figyelmeztetés nélkül. Amíg ez a figyelmeztetés itt szerepel, addig munkaverziónak tekintendő!

A föderációs metaadat specifikáció célja, hogy a föderációban részt vevő intézmények illetve entitások technikai, bizalmi és adminisztratív adatait egy helyre gyűjtse. A metaadatok formátuma megfelel a SAML2 metaadat szabványnak.

Metaadatban tárolt információk

  • Az entitások csoportosítása az őket üzemeltető szervezetek szerint történik. A föderációs metaadat tartalmaz egy 'partners' csoportot is, amiben a föderáció olyan SP-i szerepelnek, melyek nem köthetők konkrét intézményhez (ilyen lehet például egy üzleti céllal üzemeltetett SP).
  • Bizalom a metaadatban
    • a metaadat integritásvédelmét és hitelességét egy digitális aláírás biztosítja, aminek az aláíró tanúsítványa jelenleg a https://idp.niif.hu/href_signer.crt címen érhető el.
    • a metaadat visszavonhatóságát a lejárati idő (validUntil) biztosítja, ami jelenleg 3 nap.
    • az egyes rendszerek gyorstárazhatják a metaadatot, de maximum a benne megjelölt ideig (cacheDuration).
  • Tanúsítványok
    • az entitások által használt tanúsítvánnyal kapcsolatban a föderációs metaadat-specifikáció a lejárati időn kívül nem tesz különleges megkötést, sőt: ajánlott az ún. self-signed tanúsítvány használata
  • További információk
    • minden szöveges mezőt legalább két nyelven: magyarul és angolul ki kell tölteni
    • kötelezően kitöltendőek az intézményi, adminisztratív információk (Organization illetve ContactPerson elemek)
    • ajánlott megadni egy helpdesk URL-r, ahova hiba esetén a felhasználók fordulhatnak (errorURL attribútum)
    • SP-k esetén további kötelező elemek
      • AttributeConsumingService, ami megadja a kért attribútumokat
        • RequestedAttributes - itt az attribútum informális neve is szerepeljen
        • ServiceName, ServiceDescription az SP szolgáltatás neve és leírása
      • a szolgáltatás elérhetősége, amin a szolgáltatás bemutatkozik (extension)
      • adatkezelési szabályzatra mutató URL (extension)
    • IdP-k esetén
      • a scope csak az adott intézmény kezelésében levő domain név lehet (Shibboleth extension)
    • lehetőség van további adatok megadására is
      • logó
      • gps koordináták, IP cím tartomány

Metaadat kiterjesztések használata

A metaadatban tárolt egyéb információkat a http://docs.oasis-open.org/security/saml/Post2.0/sstc-metadata-attr-cd-01.html specifikáció ('entity attributes') alapján tároljuk. Ez a kiegészítő séma lehetőséget ad SAML attribútumok használatára.

A kiegészítő attribútumok discovery service-ben való használhatóságával kapcsolatban lásd a Shibboleth DS fejlesztők szabványtervezetét.

informális név urn szemantika értékekre vonatkozó megkötések
tagek  :tags néhány példa: edugain, public, for-profit, ...
geográfiai koordináták  :geographical-coordinates szélesség és hosszúság érték, a + előjel az északi szélességet illetve keleti hosszúságot jelöli 47.47359,19.052891
nyitóoldal url  :frontpage az SP szolgáltatásának nyitóoldala (URL)
adatvédelmi nyilatkozat  :privacy-policy Az SP adatvédelmi nyilatkozátnak elérhetősége (URL) Engedélyezett formátumok: HTML, PDF
logó  :logo Az IdP/SP logójának elérhetősége Formátummal kapcsolatban lásd #Logo
ip cím tartomány  :hint:ip (Csak az IdP-knél) az intézmény hálózati tartománya(i). IdP felderítés esetén előválasztás lehetséges ennek alapján. CIDR, több érték is megadható

  • formátum: transzparens hátterű PNG, vagy transzparens hátterű GIF
  • oldalarány 1:1 vagy 16:9
  • ajánlott méret: 16x16 pixel, maximális méret 200x200 pixel
  • attribútumok
    • source (kötelező): URL
    • link: opcionális link
    • height: opcionális magasság érték pixelben
    • width: opcionális szélesség érték pixelben

Egy IdP példa

<EntityDescriptor entityID="https://idp.niif.hu/shibboleth">
 <IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol urn:oasis:names:tc:SAML:1.1:protocol urn:mace:shibboleth:1.0">
  <Extensions>
   <shibmd:Scope>niif.hu</shibmd:Scope>
   <mdattr:EntityAttributes 
    xmlns:mdattr="urn:oasis:names:tc:SAML:metadata:attributes"
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
    <saml:Attribute Name="urn:geant:niif.hu:eduid.hu:entity-attributes:tags">
     <saml:AttributeValue>edugain</saml:AttributeValue>
    </saml:Attribute>
    <saml:Attribute Name="urn:geant:niif.hu:eduid.hu:entity-attributes:geographical-coordinates">
     <saml:AttributeValue>47.518356,19.055437</saml:AttributeValue>
    </saml:Attribute>
   </mdattr:EntityAttributes>
  </Extensions>
  <KeyDescriptor use="signing">
   <ds:KeyInfo>
    <ds:X509Data>
     <ds:X509Certificate>...</ds:X509Certificate>
    </ds:X509Data>
   </ds:KeyInfo>
  </KeyDescriptor>
  </IDPSSODescriptor>
 <AttributeAuthorityDescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
  <Extensions>
   <shibmd:Scope>niif.hu</shibmd:Scope>
  </Extensions>
  <KeyDescriptor use="signing">
   <ds:KeyInfo>
    <ds:X509Data>
     <ds:X509Certificate>...</ds:X509Certificate>
    </ds:X509Data>
   </ds:KeyInfo>
  </KeyDescriptor>
 </AttributeAuthorityDescriptor>
 <Organization>
  <OrganizationName xml:lang="hu">NIIF Intézet</OrganizationName>
  <OrganizationName xml:lang="en">NIIF Institute</OrganizationName>
  <OrganizationDisplayName xml:lang="hu">NIIF Intézet</OrganizationDisplayName>
  <OrganizationDisplayName xml:lang="en">NIIF Institute</OrganizationDisplayName>
  <OrganizationURL xml:lang="hu">http://www.niif.hu</OrganizationURL>
  <OrganizationURL xml:lang="en">http://www.niif.hu</OrganizationURL>
 </Organization>
 <ContactPerson contactType="technical">
  <SurName>NIIF AAI</SurName>
  <EmailAddress>aai@niif.hu</EmailAddress>
 </ContactPerson>
 <ContactPerson contactType="support">
  <SurName>NIIF AAI</SurName>
  <EmailAddress>aai@niif.hu</EmailAddress>
 </ContactPerson>
 <ContactPerson contactType="administrative">
  <SurName>NIIF AAI</SurName>
  <EmailAddress>aai@niif.hu</EmailAddress>
 </ContactPerson>
</EntityDescriptor>

Egy SP példa

<EntityDescriptor entityID="https://rr.aai.niif.hu/shibboleth">
<SPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol urn:oasis:names:tc:SAML:1.1:protocol">
 <Extensions>
  <mdattr:EntityAttributes 
   xmlns:mdattr="urn:oasis:names:tc:SAML:metadata:attribute"
   xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
   <saml:Attribute Name="urn:geant:niif.hu:eduid.hu:entity-attributes:tags">
    <saml:AttributeValue>administrative-use-only</saml:AttributeValue>
   </saml:Attribute>
   <saml:Attribute Name="urn:geant:niif.hu:eduid.hu:entity-attributes:geographical-coordinates">
    <saml:AttributeValue>47.47359,19.052891</saml:AttributeValue>
   </saml:Attribute>
   <saml:Attribute Name="urn:geant:niif.hu:eduid.hu:entity-attributes:privacy-policy">
    <saml:AttributeValue>https://rr.aai.niif.hu/privacy-policy</saml:AttributeValue>
   </saml:Attribute>
   <saml:Attribute Name="urn:geant:niif.hu:eduid.hu:entity-attributes:frontpage">
    <saml:AttributeValue>https://rr.aai.niif.hu</saml:AttributeValue>
   </saml:Attribute>
  </mdattr:EntityAttributes>
 </Extensions>
 <KeyDescriptor use="signing">
  <ds:KeyInfo>
   <ds:X509Data>
    <ds:X509Certificate>...</ds:X509Certificate>
   </ds:X509Data>
  </ds:KeyInfo>
 </KeyDescriptor>
 <KeyDescriptor use="encryption">
  <ds:KeyInfo>
   <ds:X509Data>
    <ds:X509Certificate>...</ds:X509Certificate>
   </ds:X509Data>
  </ds:KeyInfo>
 </KeyDescriptor>
 <AttributeConsumingService index="1">
  <ServiceName xml:lang="hu">HREF Resource Registry</ServiceName>
  <ServiceName xml:lang="en">HREF Resource Registry</ServiceName>
  <ServiceDescription xml:lang="hu">Resource Registry - a föderáció adminisztrációs alkalmazása http://rr.aai.niif.hu/</ServiceDescription>
  <ServiceDescription xml:lang="en">Resource Registry - federation administration tool http://rr.aai.niif.hu/</ServiceDescription>
  <RequestedAttribute FriendlyName="mail" Name="urn:oid:0.9.2342.19200300.100.1.3" isRequired="true"/>
  <RequestedAttribute FriendlyName="surname" Name="urn:oid:2.5.4.4" isRequired="true"/>
  <RequestedAttribute FriendlyName="givenName" Name="urn:oid:2.5.4.42" isRequired="true"/>
  <RequestedAttribute FriendlyName="eduPersonPrincipalName" Name="urn:oid:1.3.6.1.4.1.5923.1.1.1.6" isRequired="true"/>
  <RequestedAttribute FriendlyName="schacHomeOrganizationType" Name="urn:oid:1.3.6.1.4.1.25178.1.2.10" isRequired="true"/>
  <RequestedAttribute FriendlyName="eduPersonScopedAffiliation" Name="urn:oid:1.3.6.1.4.1.5923.1.1.1.9" isRequired="true"/>
 </AttributeConsumingService>
</SPSSODescriptor>
<Organization>
 <OrganizationName xml:lang="hu">NIIF - Nemzeti Információs Infrastruktúra Fejlesztési Intézet</OrganizationName>
 <OrganizationName xml:lang="en">NIIF Institute - National Information Infrastructure Development</OrganizationName>
 <OrganizationDisplayName xml:lang="hu">NIIF - Nemzeti Információs Infrastruktúra Fejlesztési Intézet</OrganizationDisplayName>
 <OrganizationDisplayName xml:lang="en">NIIF Institute - National Information Infrastructure Development</OrganizationDisplayName>
 <OrganizationURL xml:lang="hu">http://www.niif.hu</OrganizationURL>
 <OrganizationURL xml:lang="en">http://www.niif.hu/en</OrganizationURL>
</Organization>
<ContactPerson contactType="administrative">
 <SurName>NIIF AAI</SurName>
 <EmailAddress>aai@niif.hu</EmailAddress>
</ContactPerson>
<ContactPerson contactType="technical">
 <SurName>NIIF AAI</SurName>
 <EmailAddress>aai@niif.hu</EmailAddress>
</ContactPerson>
<ContactPerson contactType="support">
 <SurName>NIIF AAI</SurName>
 <EmailAddress>aai@niif.hu</EmailAddress>
</ContactPerson>
</EntityDescriptor>
A lap eredeti címe: „https://wiki.niif.hu/index.php?title=HREF_metadata_specifikáció&oldid=1502”