Guía del Módulo de Login Versión isum 5.1.0

Transcripción

1 Guía del Módulo de Login Versión isum 5.1.0

2

3 Características del Módulo de Login Introducción Funcionalidad Composición Este documento explica en qué consiste el entorno de ejecución del módulo de login: comenta las clases que lo componen, la funcionalidad que aporta a isum, así como la forma de utilizarlo. El módulo de login proporciona Autenticación de los usuarios mediante Login&Password o Certificado digital. El módulo de login está compuesto básicamente por cinco paquetes distintos todos ellos dentro de com/tissat/isum/security/authentication/. Dichos paquetes son: /authenticationmodules: contiene las clases que realizan propiamente la autenticación de los usuarios. Hoy en día existen solamente dos tipos de autenticación Login&Password y Certificado digital. Si hubiera que añadir otras nuevas debería hacerse aquí. /callbacks: contiene las clases para obtener la información necesaria para realizar cada tipo de autenticación. /manager: este paquete contiene el servlet que recoge la peticiones de autenticación provenientes de isum y la clase que se ocupa de leer el fichero de configuración LoginModule.xml. Aquí se inicializa Log4j. /principal: en ISUMPrincipal.java se guardan las conclusiones de la autenticación, el identificador del usuario(si la autenticación se realizó con éxito), el código que define el resultado de la autenticación y el portal dónde se encuentra el usuario. /persistence : en este paquete se encuentran todas las clases que realizan los accesos de persistencia. Debido a problemas con la configuración de jaas, todas estas clases se encuentran divididas en dos jars : manager.jar y loginmodule.jar. El primer jar irá en el servidor de aplicaciones dentro del contexto del módulo de login. El segundo contiene las clases utilizadas por jaas y deberá introducirse en JAVA_HOME/jre/lib/ext. También existen dos ficheros de configuración: LoginModule.xml : con las variables relativas a la seguridad, el serviceframework, log4j y el fichero de configuración de jaas. Log4jConfiguration.xml : fichero con la configuración del Log4j. Lm_jass.config : fichero con los tipos de autenticación soportados por el módulo de login. Configuración del Módulo de Login Debido al particular tipo de instanciación de las clases jaas, debemos introducir los siguientes jars dentro del directorio JAVAHOME/jre/lib/ext: loginmodule.jar, jaas.jar, classes12.jar, xalan.jar, jaxp11.jar, xerces.jar, serviceframework.jar, bitmechanic.jar. 1

4 Al desplegar (deploy) la aplicación manager.ear obtendremos los siguientes ficheros: manager-web/web-inf/classes: lm_jaas.config, LoginModule.xml, Log4Jconfiguration.xml,services.xml,bitmechanic.xml, pooldefinition.xml. manager-web/web-inf/lib : log4j-1.2beta3.jar, isum_security.jar, isum_lm.jar, serviceframework.jar, bitmechanic.jar, classes12.jar, abajce.jar. Cuando isum se ejecute en la misma máquina que el módulo de login, el serviceframework será instanciado por isum, así que los ficheros services.xml, pooldefinition.xml, y bitmechanic.xml no se utilizarán, pero si se utiliza Tomcat como servidor de aplicaciones es necesario añadir el fichero services.xml en la carpeta isum-web/web-inf/classes, ya que Tomcat utiliza el class loader de manera distinta a los demás.. El LoginModule.xml contiene los siguientes elementos: service_path: path del fichero de configuración del service framework, si isum se ejecuta en la misma máquina debe tener el mismo valor que el elemento service_path del isum.xml log4j_conf_file: nombre del fichero de configuración de Log4J. jaas_conf_file : path del fichero de configuración de jaas. security : este elemento contiene todo lo necesario para el cifrado y descifrado de la comunicación entre el módulo de login e isum. Puertos : en el fichero isum.xml se configura la dirección y los puertos en los que se ejecuta el módulo de login con los siguientes elementos : <login_module> <server>server.tissat.es</server> <context>manager</context> <entry_point>manager</entry_point> <ports> <http>8081</http> <https>4143</https> <https_cd>4043</https> </ports> </login_module> El módulo de login debe lanzarse en estos tres puertos(no seguro 8081, seguro sin certificado digital cliente 4143 y seguro con certificado digital cliente 4043), si se quisiera lanzar en otros puertos, habría que cambiar el valor de estos elementos (http, https y https_cd) en el fichero isum.xml. En el fichero Log4jConfiguration.xml está especificado el nivel de logs a partir del cual se lanzaran mensajes y el nombre de dichos ficheros de log, aquí(igual que se hace en isum) será necesario especificar la ruta correcta a dichos ficheros. Utilización del Módulo de Login Configuración desde isma Es necesario establecer los puertos en los que se ejecuta isum, para ello se utiliza el elemento servidores del isma. Se establecerá si los servidores isum seguro y no seguro están habilitados o no y también los puertos en los que escuchan. También hay que establecer la correspondencia entre los servidores isum de entrada los métodos de autenticación y el servidor de salida. Por ejemplo, si estamos en el servidor isum seguro y realizamos una autenticación mediante certificado digital, seguramente querremos que a partir de ese momento se ejecute isum en 2

5 modo seguro, eso lo estableceremos en la pestaña Reglas de gestión del elemento portal. Ficheros de Log Los ficheros de log generados se especifican en el fichero Log4jConfiguration.xml, así como su situación. Existen 6 ficheros de log que se generan con distintos tipos de prioridades : LoginModuleInfo.log, LoginModuleDebug.log, LoginModuleWarn.log, LoginModuleError.log, LoginModuleFatal.log, LoginModuleSql.log. Este último contiene los errores generados por las consultas realizadas a la base de datos. Cosas a revisar si existen fallos Revisar que se ha establecido la asociación entre los métodos de autenticación y los servidores en la pestaña Reglas de gestión en el elemento Portal. Revisar que los puertos en los que escucha isum(seguro y no seguro) son los mismos que los especificados en la parte de servidores del isma. Revisar que se han introducido dentro de JAVA_HOME/jre/lib/ext los jars necesarios para que funcione jaas y que el servidor se lanza con dicha máquina virtual. Revisar que tanto isum como el módulo de login se conectan a la misma base de datos. Si la conexión falla, revisar si el service framework funciona bien. Revisar los ficheros de log de prioridad fatal y error. 3