Middleware SPID basato su Shibboleth
Apri nuove issue e raggiungici sul canale Slack per contribuire.
Questo progetto contiene un setup dimostrativo composto dai seguenti:
- Shibboleth SP
- Discovery service sotto forma di pagina statica HTML
- Script per la creazione guidata dei metadata firmati
- Progetto PHP di esempio
- Configurazione di Apache2 con mod_shib
Per la installazione e la configurazione di Apache2 consigliamo di fare riferimento ad uno degli HowTo resi disponibili dalla comunità Idem GARR. Il tutorial IDEM GARR può essere considerato come utile fino alla sezione Configure Shibboleth SP:
Per rispondere ai test di conformità 16, 17 and 18 è necessaria la versione di Shibboleth 3.1 o superiore.
Per la configurazione di Shibboleth SP per SPID si dovranno invece compiere i seguenti passaggi:
-
creare dei certificati conformi all'avviso AgID SPID 29 v3
-
creare e firmare il metadata del servizio, in shibboleth/metadata sono presenti due script per la creazione del metadata, uno in ruby e un altro in python. Questi sono da intendersi solo come esempio, per la creazione e la firma dei metadata SPID esistono altre risorse già disponibili su github italia.
-
usare come esempio la configurazione shibboleth2.xml, sostituendo i recapiti email, i nomi dei file del certificato e della chiave privata, l'hostname del SP ({sp_fqdn} diventerà ad esempio sp.example.org)
-
E' necessario infine, ai fini della demo, abilitare PHP all'interno di Apache2 il virtualhost relativo a {sp_fqdn}, vedi il contenuto di Apache2 e di php-example-project. Visitare tramite web browser l'url https://{sp_fqdn}/disco/ per visualizzare il bottone 'login con SPID'.
-
copiare il metadata all'interno di un path pubblico della risorsa www del tuo {sp_fqdn}
I seguenti passaggi sono inoltre utili per svolgere una demo di test:
- eseguire spid-saml-check tramite Docker
- scaricare i metadata di spid-saml-check nella directory
/etc/shibboleth/metadata/spid-saml-check.xml, come definito in shibboleth2.xml
Aprire una issue per discutere degli scopi e delle modifiche, proporre una Pull Request sul branch dev.