ShibbolethAppIntegration

Referencia: https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPEnableApplication

Introducción:

There are many different ways to integrate the Shibboleth SP with an application. Some are very elegant, and some are really not elegant. Some are simple and fast, and others are complicated and will take a long time. The rule of thumb is to deliver the information Shibboleth supplies to the application in the manner the application expects it already, or to modify the application.

Consideraciones:

  • Ejemplo de consideracion: se puede hacer proteccion a nivel de infraestructura (apache) de toda la webapp o solo de una pagina de inicio de sesion.
  • ¿Que hago si en mi aplicacion tengo un acceso de un usuario autenticado por el IdP, pero que no esta registrado en la base de usuarios de la aplicación? Algunos comentarios: autorizacion previa, ejemplo de moodle, asignacion automatica a grupos basada en atributos informados por el IdP.

Ejemplos:

Ejemplos de script, que toman variables shibboleth: http://shib.kuleuven.be/download/sp/test_scripts/

Integración aplicaciones java

Integración aplicaciones java

Integración aplicaciones python

Integración aplicaciones python

Integración aplicaciones PHP

Se puede acceder a las variables de entorno cargadas por el SP, consultando el array $_SERVER.

Ejemplo:

Configurar apache para que proteja el directorio /var/www/secure, como se indica en ShibbolethSPInstall

En /var/www/secure crear test.php, con el siguiente contenido

 1 
 2 <html>
 3 <body>
 4 <?php
 5 echo "PRUEBA SHIB SP - VARIABLES DEL SERVIDOR: ";
 6 foreach($_SERVER as $key_name => $key_value) {
 7     print $key_name . " = " . $key_value . "<br/>";
 8 }
 9 ?>
10 </body>
11 </html>
12 
 

Escenario con reverse proxy:

En el caso de utilizar un reverse proxy apache (SP instalado en el reverse proxy), las variables se propagan como headers http (debe agregarse la directiva ShibUseHeaders On en el servidor web donde está instalado el SP). En este caso no se obtienen como variables del servidor, sino como headers.

Ejemplo de acceso al al array de headers:

1 $headers = apache_request_headers();
2 echo "PRUEBA SHIB SP - HEADERS HTTP RECIBIDOS: ";
3 foreach($headers as $key_name => $key_value) {
4         print $key_name . " = " . $key_value . "<br/>";
5 }

Integracion WordPress

En el caso de utilizar wordpress se puede hacer uso del plugin de shibboleth para la plataforma (https://es.wordpress.org/plugins/shibboleth/). El mismo permite la creación de usuarios en wordpress, con datos obtenidos del proveedor de identidad.

Para utilizar dicho plugin es necesario: 
1) Que el modulo de shibboleth este instalado en el mismo apache que el wordpress que lo utilizará
2) Que se agregue al archivo de configuracion de la pagina ó en un archivo de .htaccess (ubicado en la raiz) lo siguiente:
    <Location />
        AuthType shibboleth
        ShibRequestSetting requireSession false
        ShibRequestSetting applicationId app_id
        Require shibboleth
    </Location>
    Nota 1: Se debe reemplazar app_id con el identificador de la aplicacion, el cual debe coincidir con el declarado en el archivo shibboleth2.xml.
    Nota 2: En caso de crear un archivo .htaccess se deberá eliminar <Location /> y </Location>.

Una vez instalado el plugin de shibboleth se deberá configurar para que genere usuarios en wordpress. Esto se realiza navegando a "Mis sitios"->"Plugins". una vez que cargue la pagina ir a "Ajustes"->"Shibbolet".
Puede ser necesario utilizar un prefijo personalizado para acceder a los datos, dicho prefijo se puede configurar seleccionando la
opción "Custom Prefix" en la configuración de "Attribute Access", el prefijo se debe declarar en el campo "Custom Attribute Access Prefix".
Para configurar la creación de usuarios hay que ir a la pestaña "User". Hay puede mapear que atributos obtenidos del idp se corresponden con los datos del usuario de wordpress, se puede seleccionar para los atributos la opción "Managed", en caso de estar seleccionada la casilla el usuario no podrá editar ese dato.
Nótese que no se debe poner el prefijo de los mismos, de eso se encargara el mismo plugin.
Dependiendo de los datos enviados por el idp quizás sea necesario configurar las opciones bajo "Combine Local and Shibboleth Accounts"
en "Allow Manual Account Merging (Bypass Username Management)", esto se debe a que wordpress coloca restricciones sobre nombres
de usuario y puede llegar a suceder que ningún dato de los obtenidos del idp cumpla con las restricciones impuestas por wordpress.

Integración aplicaciones Genexus

TODO

Gestores de contenido

Moodle

Ver IntegracionMoodleShibboleth

DSpace

TODO

Logout

Hay varias cosas que considerar, y que pueden aplicar o no dependiendo del escenario:

  • cerrar sesión de la aplicación
  • cerrar sesión en el SP (sesion mantenida por el modulo shib SP en apache)
  • cerrar sesión en el IdP
  • cerrar sesión en otras aplicaciones en las que se haya iniciado sesión con el IdP

Lo que haremos en princpio, es que cuando el usuario cierre sesión en una aplicación, se cierre sesion en la aplicacion, en el SP y en el IDP. También se dará un mensaje (en logout de idp) diciendo que si quiere completar el cierre de sesión, cierre el browser.

Para implementar esa funcionalidad, la aplicacion, luego de destruir su sesión, debe redirigir al logout del SP, y el logout del SP estará configurado para redirigir luego al logout del IdP

Ejemplo de url para logout en el SP:
https://sp1.seciu.edu.uy/Shibboleth.sso/Logout

Refs:
https://wiki.cac.washington.edu/display/infra/Configure+Service+Provider+Logout
https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPServiceLogout
https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPLogoutInitiator

Shibboleth Enabled Applications and Services

https://wiki.shibboleth.net/confluence/display/SHIB2/ShibEnabled