SSP2 - Laptörténet

Mohacsi(AT)niif.hu, 2025. október 1., 16:56-n

2025-10-01T16:56:54Z

Matteo(AT)niif.hu, 2024. augusztus 13., 09:49-n

2024-08-13T09:49:53Z

Változtatások megtekintése

Matteo(AT)niif.hu, 2024. augusztus 13., 09:27-n

2024-08-13T09:27:24Z

Matteo(AT)niif.hu, 2024. augusztus 13., 09:15-n

2024-08-13T09:15:13Z

Változtatások megtekintése

Matteo(AT)niif.hu, 2024. augusztus 13., 08:44-n

2024-08-13T08:44:52Z

Matteo(AT)niif.hu, 2024. augusztus 13., 08:44-n

2024-08-13T08:44:00Z

Matteo(AT)niif.hu, 2024. augusztus 13., 08:36-n

2024-08-13T08:36:27Z

Matteo(AT)niif.hu, 2024. augusztus 13., 08:23-n

2024-08-13T08:23:31Z

Változtatások megtekintése

Matteo(AT)niif.hu: /* SSP2 leírás */

2024-08-06T08:59:45Z

‎SSP2 leírás

Mohacsi(AT)niif.hu: Új oldal, tartalma: „== SSP2 leírás ==”

2024-08-06T08:39:40Z

Új oldal, tartalma: „== SSP2 leírás ==”

Új lap

== SSP2 leírás ==

← Régebbi változat		A lap 2025. október 1., 16:56-kori változata
1. sor:		1. sor:
−	Az alábbi lapon megkíséreljük összefoglalni a legfontosabb lépéseket, melyek általános esetben elegendőek ahhoz, hogy működő SimpleSAMLphp (SSP) alkalmazást állítsunk üzembe.	+	Az alábbi lapon megkíséreljük összefoglalni a legfontosabb lépéseket, melyek általános esetben elegendőek ahhoz, hogy működő SimpleSAMLphp (SSP) 2.x alkalmazást állítsunk üzembe.

	==Telepítés==		==Telepítés==

@@ 136. sor: / 136. sor: @@
   'enable.saml20-idp' => true,
-===metadata/saml20-idp-hosted.php===
+===Metaadat alapok===
+A beállítandó IdP alapvető paraméterei a <code>metadata/saml20-idp-hosted.php</code> fájlban állíthatók. Az alábbi kódrészlet egy minimális, de már működő példát mutat.
-<?php
+<source lang="php">
+ <?php
   $metadata['https://example.org/saml-idp'] = [
      /*
@@ 147. sor: / 147. sor: @@
       */
      'host' => '__DEFAULT__',
      /*
       * The private key and certificate to use when signing responses.
@@ 155. sor: / 154. sor: @@
      'privatekey' => 'example.org.pem',
      'certificate' => 'example.org.crt',
      /*
       * The authentication source which should be used to authenticate the
@@ 162. sor: / 160. sor: @@
      'auth' => 'example-ldap',
   ];
 A fentebb hivatkozott certeket korábban létrehoztuk, de az example-ldap auth forrást még nem:
@@ 300. sor: / 299. sor: @@
 </source>
-===Metaadat alapok===
+Megfelelő beállítások után a dinamikusan generált metadata a <code>/saml2/idp/metadata.php</code> útvonalon érhető el.
-A beállítandó IdP alapvető paraméterei a <code>metadata/saml20-idp-hosted.php</code> fájlban állíthatók. Az alábbi kódrészlet egy minimális, de már működő példát mutat.
 <source lang="php">
- $metadata['__DYNAMIC:1__'] = array(
+<?php
-    /*
-     * The hostname for this IdP. This makes it possible to run multiple
+$metadata['https://sp.example.org/simplesaml/module.php/saml/sp/metadata.php/default-sp'] = [
-     * IdPs from the same configuration. '__DEFAULT__' means that this one
+     'AssertionConsumerService' => 'https://sp.example.org/simplesaml/module.php/saml/sp/saml2-acs.php/default-sp',
-     * should be used by default.
+     'SingleLogoutService' => 'https://sp.example.org/simplesaml/module.php/saml/sp/saml2-logout.php/default-sp',
-     */
+];
 </source>
-Megfelelő beállítások után a dinamikusan generált metadata a <code>/saml2/idp/metadata.php</code> útvonalon érhető el.
+A másik (SP) oldalon amennyiben szintén simplesamlphp van, az idp metaadatokat hasonlóképp hasonlóképp érjük el majd illesszük be a   metadata/saml20-idp-remote.php
-===Tesztelés===
+A certet a config php-ban beállított certdir-ben keresi (alapértelmezetten /cert)
-Legegyszerűbben a telepített SSP felületén tudjuk ellenőrizni, hogy a beállított autentikációs forrás működik-e. A felületen az Authentication fül alatt található egy 'Test authentication sources' link, amelyre kattintva látható minden beállított autentikációs forrás is, így a két alapértelmezett, teszt célokat szolgáló alatt a most beállított example-ldap névre hallgatónak is meg kell jelenni. (A közvetlen url erre az oldalra: simplesaml/module.php/core/authenticate.php) Ez utóbbira kattintva a beállított LDAP-ból autentikálva be kell tudnunk jelentkeznünk; siker esetén az LDAP-ból kinyerhető attribútumokat láthatjuk.
+Amennyiben más SP-t használunk az idp XML metadatájára lesz szükség amely szintén föderáció fül alatt érhető el ([https://idp.example/simplesaml/module.php/admin/federation](https://idp.niif.hu/simplesaml/module.php/admin/federation)), és az SPn-nek releváns dokumentációt kell követni.
 ==Service Provider (SP) beállítás==

@@ 28. sor: / 28. sor: @@
 <code>composer create-project simplesamlphp/simplesamlphp:2.1.3</code>
 Mappaszerkezet módosítása:
-<code>
-mv simplesamlphp simplesamlphp-prod #Tetszőleges átnevezés
+ mv simplesamlphp simplesamlphp-prod #Tetszőleges átnevezés
-mkdir -p simplesamlphp-prod/cert
+ mkdir -p simplesamlphp-prod/cert
-mkdir -p /var/simplesamlphp-prod/log/stats/
+ mkdir -p /var/simplesamlphp-prod/log/stats/
-mkdir -p /var/simplesamlphp-prod/mdx-cache/
+ mkdir -p /var/simplesamlphp-prod/mdx-cache/
-chown -R www-data:www-data /var/simplesamlphp-prod/mdx-cache/
+ chown -R www-data:www-data /var/simplesamlphp-prod/mdx-cache/
-chown -R www-data:www-data /var/simplesamlphp-prod/log/
+ chown -R www-data:www-data /var/simplesamlphp-prod/log/
-chown -R www-data:www-data /var/simplesamlphp-prod/metadata/
+ chown -R www-data:www-data /var/simplesamlphp-prod/metadata/
-</code>
 Composerrel a szükséges modulok telepítése (például LDAP, REDIS, vagy consent):
-<code>
-composer require simplesamlphp/simplesamlphp-module-ldap:v2.3.2
+ composer require simplesamlphp/simplesamlphp-module-ldap:v2.3.2
-composer require predis/predis:2.2.2
+ composer require predis/predis:2.2.2
-composer require simplesamlphp/simplesamlphp-module-consent:1.3.2
+ composer require simplesamlphp/simplesamlphp-module-consent:1.3.2
-</code>
 Ezzel a telepítés, és a szükséges kiegészítők telepítése megtörtént.

@@ 9. sor: / 9. sor: @@
 * PHP környezet (>=8.0)
 * A következő PHP kiterjesztéseket engedélyezni kell
-** <code>posix, date , dom , fileinfo , filter , hash , json , libxml , mbstring , openssl , pcre , session , simplexml , sodium , SPL, zlib, ldap, </code>
+** <code>posix, date , dom , fileinfo , filter , hash , json , libxml , mbstring , openssl , pcre , session , simplexml , sodium , SPL, zlib, ldap</code>
 ** Adatbázisból történő autentikáció esetén a megfelelő adatbázis-csatolót <code>mysqli, pdo, pdo_mysql</code>
 ** RADIUS szerveren keresztül történő autentikáció esetén: <code>radius</code>
@@ 17. sor: / 17. sor: @@
 *** Az adatbázis szerkezetének kialakítása a használt moduloktól függ, a leggyakoribb a consent modul, ott van is dokumentáció az adatbázis inicializálásáról.
-** Kell 2 certpár, az egyik az apachenak a másik az SSP-nek ezutóbbi lehet önalárírt, és nem ajánlott ugyan azt használni.
+** Szükséges 2 certpár, az egyik az apachenak a másik az SSP-nek ezutóbbi lehet önalárírt, és nem ajánlott ugyan azt használni.
 ====Composer====
@@ 23. sor: / 23. sor: @@
 A '''[https://getcomposer.org composer]''' PHP csomagkezelőt is telepíteni kell (akár forrásból, akár csomagból), hogy telepíteni lehessen a SimpleSAMLphp futásához szükséges PHP library-ket.
-===Letöltés===
+===Telepítés===
-A GitHubról történő telepítés előnye, hogy a simplesamlphp könnyen frissíthető marad, csak a third party modulokat kell újratelepíteni. Az utolsó stabil verzió számát a https://simplesamlphp.org/download oldalról tudhatjuk meg.
+Elvégezhető composerrel például a <code>/var/</code> mappában:
 ===Apache konfigurálás===
-A webről csak a <code>/var/simplesamlphp/www</code> könyvtárat kell elérni. '''Tilos''' a teljes simplesamlphp könyvtárat a DocumentRoot alá tenni!
+A webről csak a <code>/var/simplesamlphp-prod/public</code> könyvtárat kell elérni. '''Tilos''' a teljes simplesamlphp könyvtárat a DocumentRoot alá tenni!
-  Alias /simplesaml /var/simplesamlphp/www
+  Alias /simplesaml /var/simplesamlphp-prod/public
-  <Directory /var/simplesamlphp/www>
+  <Directory /var/simplesamlphp-prod/public>
     Require all granted
   </Directory>

@@ 5. sor: / 5. sor: @@
 ===Előkészületek===
 Ahhoz, hogy problémamentesen telepíthessük SSP alkalmazásunkat, az alábbi szoftverkomponenseknek kell működniük szerverünkön.
 * PHP futtatására alkalmas webszerver
-* PHP környezet (>=5.4)
+* PHP környezet (>=8.0)
 * A következő PHP kiterjesztéseket engedélyezni kell
-** <code>date</code>, <code>dom</code>, <code>hash</code>, <code>libxml</code>, <code>openssl</code>, <code>pcre</code>, <code>SPL</code>, <code>zlib</code>
+** <code>posix, date , dom , fileinfo , filter , hash , json , libxml , mbstring , openssl , pcre , session , simplexml , sodium , SPL, zlib, ldap, </code>
-** LDAP-ból történő autentikáció esetén: <code>ldap</code>
+** Adatbázisból történő autentikáció esetén a megfelelő adatbázis-csatolót <code>mysqli, pdo, pdo_mysql</code>
 ** RADIUS szerveren keresztül történő autentikáció esetén: <code>radius</code>
-** Assertion-ök titkosítása esetén: <code>mcrypt</code>
+* Információk, certek:
-** Memcache használata esetén: <code>memcache</code>
+** Bár a szoftver képes futni mariadb, és redis nélkül, ezek vagy hasonló megoldások használata éles környezetben ajánlott.
-** HEXAA integrációhoz (SP): <code>soap</code>
+*** Amennyiben ezeket szándékozunk használni database connection stringgel kell rendelkezni, redis elérhetőséggel és jelszóval rendelkezni.
-====Debian 9 / Ubuntu 16.04 LTS csomagok====
+** Kell 2 certpár, az egyik az apachenak a másik az SSP-nek ezutóbbi lehet önalárírt, és nem ajánlott ugyan azt használni.
 ====Composer====

← Régebbi változat		A lap 2024. augusztus 6., 08:59-kori változata
1. sor:		1. sor:
	== SSP2 leírás ==		== SSP2 leírás ==
		+
		+	Nagyjából leírni:
		+
		+	Rendszer Előkészítése
		+	Apache Telepítése
		+	PHP és Composer Telepítése
		+	További szoftverkönyvtárak és kiterjesztések telepítése
		+
		+	Bővebben / konkrétabban leírni:
		+	SimpleSAMLphp Telepítése
		+	Tanúsítvány Telepítése
		+	Adatbázis Konfiguráció
		+	Redis Konfiguráció
		+	LDAP Integráció
		+	Konfiguráció és modulok Beállítása
		+
		+	Egyebek?
		+	Naplózás, Monitorozás
		+
		+	EDDIGI DOKSI
		+
		+	Ez egy simplesamlphp install útmutató, először is nagyvonalakban leírásra kerülnek az előkészületek ezt követően pedig maga a szoftver telepítése és beállítása.
		+
		+
		+	Előkészületek:
		+	Rendszer:
		+	APACHE telepítése
		+	PHP 8 vagy nagyobb telepítése
		+	COMPOSER telepítése
		+	Könyvtárak, kiegészítők amiket telepíteni kell:
		+	wget openssl unzip build-essential libldap2-dev libldap-common
		+	PHP kiegészítők: ldap, mysqli, pdo, pdo_mysql
		+	Információk, certek:
		+	Bár a szoftver képes futni mariadb, és redis nélkül, ezek vagy hasonló megoldások használata ajánlott.
		+	Database connection stringgel rendelkezni, redis elérhetőséggel és jelszóval rendelkezni.
		+	Az adatbázis szerkezetének kialakítása a használt moduloktól függ, a leggyakoribb a consent modul, ott van is dokumentáció az adatbázis inicializálásáról.
		+	Kell 2 certpár, az egyik az apachenak a másik az SSP-nek ezutóbbi lehet önalárírt.
		+
		+
		+
		+	Telepítés: