SSP EntityCategories - Laptörténet

19379(AT)wigner.mta.hu, 2017. szeptember 26., 18:55-n

2017-09-26T18:55:37Z

19379(AT)wigner.mta.hu: /* allowRequestedAttributes */

2017-08-30T12:17:49Z

‎allowRequestedAttributes

19379(AT)wigner.mta.hu: /* strict */

2017-08-30T12:16:07Z

‎strict

Bajnokk(AT)niif.hu: /* Működő példa */

2017-08-30T11:52:52Z

‎Működő példa

Bajnokk(AT)niif.hu: /* Működő példa */

2017-08-30T11:49:10Z

‎Működő példa

Bajnokk(AT)niif.hu: /* Működő példa */

2017-08-30T11:46:08Z

‎Működő példa

Bajnokk(AT)niif.hu: /* Működő példa */

2017-08-30T10:22:10Z

‎Működő példa

19379(AT)wigner.mta.hu, 2017. augusztus 25., 06:46-n

2017-08-25T06:46:03Z

19379(AT)wigner.mta.hu: /* Telepítés composeren keresztül */

2017-08-25T06:38:52Z

‎Telepítés composeren keresztül

19379(AT)wigner.mta.hu, 2017. augusztus 25., 06:23-n

2017-08-25T06:23:32Z

@@ 3. sor: / 3. sor: @@
 A modul forrása: https://github.com/sitya/simplesamlphp-module-entitycategories.git
-'''Fontos''', hogy a modul nem helyettesíti a core:AttributeLimit modult, azzal együtt használandó!
+'''Fontos''', hogy a modul nem helyettesíti a core:AttributeLimit, vagy a niif:AttributeLimit modult, valamelyikkel együtt használandó!
 ==Telepítés composeren keresztül==
@@ 18. sor: / 18. sor: @@
 ==Beállítás==
-Lévén egy AuthProc modullal van dolgunk, így a rendes authproc szekcióba kell elhelyeznünk valahol a sorban, a core:AttributeLimit előtt. Az alább részletezett alapbeállításokon túl (<code>default, strict, allowRequestedAttributes</code>) az egyes entityCategory-k URI-jait kell megadni, mint egy tömb kulcsát, és a hozzátartozó tömb értékeiként pedig a megengedett attribútumok URN-jeit. Tetszőleges számú entityCategory-t megadhatunk, a korábbi beállítások elsősorban azt szabályozzák, hogy mi történjen akkor, olyan entitással van dolgunk, akinek nincs a metadatájában megadva EntityCategory, vagy ha van, nem illeszkedik az általunk explicit beállított listában található EntityCategory-k valamelyikére.
+Lévén egy AuthProc modullal van dolgunk, így a rendes authproc szekcióba kell elhelyeznünk valahol a sorban, a core:AttributeLimit, vagy niif:AttrobuteLimit előtt. Az alább részletezett alapbeállításokon túl (<code>default, strict, allowRequestedAttributes</code>) az egyes entityCategory-k URI-jait kell megadni, mint egy tömb kulcsát, és a hozzátartozó tömb értékeiként pedig a megengedett attribútumok URN-jeit. Tetszőleges számú entityCategory-t megadhatunk, a korábbi beállítások elsősorban azt szabályozzák, hogy mi történjen akkor, olyan entitással van dolgunk, akinek nincs a metadatájában megadva EntityCategory, vagy ha van, nem illeszkedik az általunk explicit beállított listában található EntityCategory-k valamelyikére.
 === Működő példa ===

← Régebbi változat		A lap 2017. augusztus 30., 12:17-kori változata
67. sor:		67. sor:

	===='''<code>allowRequestedAttributes</code>'''====		===='''<code>allowRequestedAttributes</code>'''====
−	Logikai kapcsoló, <code>true/false</code> értékeket vehet fel. Amennyiben <code>true</code>, úgy megengedjük, hogy egy SP a hozzátartozó EntityCategory konfigurációjában megadott attribútumlistán túl kért attribútumot kiadásra <code>RequestedAttributes</code>-on keresztül, <code>false</code> esetén csak a listában szereplő attribútumok kiadását engedi a modul.	+	Logikai kapcsoló, <code>true/false</code> értékeket vehet fel. Amennyiben <code>true</code>, úgy megengedjük, hogy egy SP a hozzátartozó EntityCategory konfigurációjában megadott attribútumlistán túl kért attribútumot kiadásra <code>RequestedAttributes</code>-on keresztül, <code>false</code> esetén csak a listában szereplő attribútumok kiadását engedi a modul. Amennyiben az érték <code>true</code> és a <code>strict</code> értéke <code>false</code>, úgy az "ismeretlen" EntityCategory-val bíró SP-k számára is a <code>RequestedAttributes</code> alapján kerülnek kiadásra az attribútumok.

@@ 64. sor: / 64. sor: @@
 ===='''<code>strict</code>'''====
-Logikai kapcsoló, <code>true/false</code> értékeket vehet fel. Amennyiben <code>true</code>, úgy csak és kizárólag a modul konfigurációjában megadott EntityCategory-val érkező SP-k számára kerülnek attribútumok kiadásra, "ismeretlen" EntityCategory-val bíró SP-k számára nem kerül kiadásra semmi.
+Logikai kapcsoló, <code>true/false</code> értékeket vehet fel. Amennyiben <code>true</code>, úgy csak és kizárólag a modul konfigurációjában megadott EntityCategory-val érkező SP-k számára kerülnek attribútumok kiadásra, "ismeretlen" EntityCategory-val bíró, és EntityCategory nélküli SP-k számára nem kerül kiadásra semmi.
 ===='''<code>allowRequestedAttributes</code>'''====
 Logikai kapcsoló, <code>true/false</code> értékeket vehet fel. Amennyiben <code>true</code>, úgy megengedjük, hogy egy SP a hozzátartozó EntityCategory konfigurációjában megadott attribútumlistán túl kért attribútumot kiadásra <code>RequestedAttributes</code>-on keresztül, <code>false</code> esetén csak a listában szereplő attribútumok kiadását engedi a modul.

@@ 57. sor: / 57. sor: @@
 # a fenti kategóriáknak nem megfelelő SP-k közül kizárólag a ''bilateralSPs'' tömbben megadott entitásoknak adunk ki attribútumot.
+{{STOP|Az ''entitycategories:EntityCategory'' modul ''strict'' beállítása esetén a lokálisan felvett SP-k esetén nem lesz figyelembe véve az ''attributes'' tömbelem! Ez azt jelenti, hogy a nem a központi metaadatokból származó SP-ket fel kell venni az ''niif:AttributeLimit'' modul listájába. Ebből fakadóan ilyen esetben nem is használhatjuk a  ''core:AttributeLimit'' modult.}}
 === Opciók ===

@@ 57. sor: / 57. sor: @@
 # a fenti kategóriáknak nem megfelelő SP-k közül kizárólag a ''bilateralSPs'' tömbben megadott entitásoknak adunk ki attribútumot.
-{{STOP | Az <code>entitycategories:EntityCategory</code> modul <code>strict="true"</code> beállítása esetén a lokálisan felvett SP-k esetén nem lesz figyelembe véve az <code>attributes</code> tömbelem!<br/>Ez azt jelenti, hogy a nem a központi metaadatokból származó SP-ket fel kell venni az <code>niif:AttributeLimit</code> modul listájába. Ebből fakadóan ilyen esetben nem is használhatjuk a  <code>core:AttributeLimit</code> modult.}}
 === Opciók ===

@@ 40. sor: / 40. sor: @@
 => array(
-         'class' => 'core:AttributeLimit',
+         'class' => 'niif:AttributeLimit',
-         'default' => true
+         'default' => true,
    ),
 </source>
@@ 51. sor: / 55. sor: @@
 # a Research & Scholarship entitás kategóriájú eduGAIN-es SP-k számára kiadjuk a kategória által igényelt attribútumcsomagot
 #* az ilyen SP-k <code>RequestedAttributes</code> alapján módosíthatnak az attribútum igényeiken
-# a fenti kategóriák egyikébe sem tartozó SP-k számára semmit sem ad ki
+# a fenti kategóriáknak nem megfelelő SP-k közül kizárólag a ''bilateralSPs'' tömbben megadott entitásoknak adunk ki attribútumot.
 === Opciók ===

@@ 22. sor: / 22. sor: @@
 === Működő példa ===
 <source lang="php">
   => array(
-                'class' => 'entitycategories:EntityCategory',
+         'class' => 'entitycategories:EntityCategory',
-                'default' => true,
+         'default' => true,
-                'strict' => false,
+         'strict' => true,
-                'allowRequestedAttributes' => true,
+         'allowRequestedAttributes' => true,
-                'http://refeds.org/category/research-and-scholarship' => array(
+         'http://eduid.hu/category/registered-by-eduidhu' => array (),
-                    'urn:oid:2.16.840.1.113730.3.1.241', #displayName
+         'http://www.geant.net/uri/dataprotection-code-of-conduct/v1' => array (),
-                    'urn:oid:0.9.2342.19200300.100.1.3', #mail
+         'http://refeds.org/category/research-and-scholarship' => array(
-                    'urn:oid:1.3.6.1.4.1.5923.1.1.1.6', #eduPersonPrincipalName
+             'urn:oid:2.16.840.1.113730.3.1.241', #displayName
-                ),
+             'urn:oid:2.5.4.4', #sn
    ),
 => array(
-                'class' => 'core:AttributeLimit',
+        'class' => 'core:AttributeLimit',
-                'default' => true
+        'default' => true
    ),
-</source>
 === Opciók ===

@@ 8. sor: / 8. sor: @@
 <source lang="bash">
 cd /path/to/simplesamlphp
 composer require simplesamlphp/simplesamlphp-module-entitycategories:dev-master
 composer config repositories.simplesamlphp/simplesamlphp-module-entitycategories vcs https://github.com/sitya/simplesamlphp-module-entitycategories.git
 composer update
 </source>
@@ 20. sor: / 22. sor: @@
 === Működő példa ===
 <source lang="php">
   => array(
                  'class' => 'entitycategories:EntityCategory',
@@ 35. sor: / 38. sor: @@
                  'default' => true
    ),
 </source>
@@ 40. sor: / 44. sor: @@
 ===='''<code>default</code>'''====
 Logikai kapcsoló, <code>true/false</code> értékeket vehet fel. Amennyiben <code>true</code>, úgy a beállított EntityCategory-k alatt megadott attribútumkészletet akkor is kiadjuk az adott EntityCategory-val érkező SP-nek, ha az attribútumokat explicit, a <code>RequestedAttribute</code>-ok között nem kérte felsorolva. Ennek az R&S EntityCategorynál van különös jelentősége (a példában is ez szerepel), mert ott a specifikáció kimondja, hogy a meghatározott attributúmkészletet akkor is ki kell adni az R&S-t támogató IdP-nek, amennyiben nincsenek ezen attribútumok tételesen felsorolva, mint <code>RequestedAttributes</code>.