Manual: como sindicar una aplicación

Transcripción

1 Manual: como sindicar una aplicación Repositorio horizontal de usuarios Versión 1.4 Fecha de versión 23/02/2016 Madrid, 23 de Febrero de 2016 Elaborado por la Dirección General de Modernización Administrativa, Procedimientos e Impulso de la Administración Electrónica Ministerio de Hacienda y Administraciones Públicas NIPO: Pendiente de asignación. AutenticA Acceso como aplicación Aplicación Página 1 de 10

2 ÍNDICE 1. OBJETO DESCRIPCIÓN Autenticación Sin servicio de SSO Single Sign On Alta de la aplicación URL de acceso URL de respuesta XML de respuesta Elemento de puestos... 8 AutenticA Acceso como aplicación Aplicación Página 2 de 10

3 1. OBJETO El presente documento servirá de guía técnica para aquellas aplicaciones que vayan a consumir los servicios que el repositorio único presta llevando a cabo las indicaciones pertinentes para su integración. AutenticA Acceso como aplicación Aplicación Página 3 de 10

4 2. DESCRIPCIÓN En principio cualquier aplicación podría ser susceptible de integrarse con el repositorio único para tener acceso a los servicios que ofrece. Es necesario dar una serie de pasos técnicos y a nivel de gestión. Los dos grandes servicios a los que una aplicación podría tener acceso son: 2.1. Autenticación Para tener acceso a la autenticación a través de certificado electrónico o usuario y contraseña es necesario dar de alta la aplicación a través del módulo de aprovisionamiento de usuarios, teniendo los usuarios que van a intentar acceder existir en el LDAP del repositorio único Sin servicio de SSO Para aquellas aplicaciones que deseen usar el servicio de autenticación para el registro de sus usuarios y no el servicio de SSO, será necesario que en el proceso de alta o modificación de dicha aplicación no se marque la opción correspondiente para disponer de SSO Single Sign On Para tener acceso (independientemente del servicio de autenticación) al servicio de Single Sign On, la aplicación ha de estar federada en el CAS del repositorio. Para ello se deberá dar de alta a través del gestor de aplicaciones y por tanto debe existir petición previa para ello, como parte de la gestión Alta de la aplicación Será necesario que se ponga en contacto con el MINHAP-SEAP con objeto de que sus administradores puedan llevar a cabo el alta de la aplicación en el repositorio. De esta manera la aplicación pasará a formar parte del CAS. Los valores que son obligatorios trasladar son: Nombre: nombre la aplicación URL de respuesta: URL sobre la que será redireccionada la petición cuando se haya llevado a cabo la validación de de forma satisfactoria. IP: Hay que introducir la IP (o IPs) que se resuelve por DNS de la URL de la aplicación. Cuando se reciba la petición de autenticación de un usuario, se comprobará la IP proveniente y se comparará con la almacenada en este campo. Si no coinciden no se permitirá la comunicación. Correo electrónico: correo electrónico del administrador de la aplicación. Este dato es importante dado que en esta cuenta de correo electrónico el administrador recibirá AutenticA Acceso como aplicación Aplicación Página 4 de 10

5 las instrucciones necesarias para formalizar la adscripción de la aplicación al repositorio URL de acceso Una vez que la aplicación se ha dado de alta en el sistema, éste enviará a través de correo electrónico el identificador de la aplicación para la composición de la URL a la que será necesario realizar la llamada para el acceso a la página de usuario y contraseña que provee AutenticA. Dicha URL se deberá ubicar en la sección de la aplicación encargada de la autenticación de usuarios. =[IDENTIFICADOR_APLICACIÓN] URL de respuesta En el caso de que AutenticA valide correctamente el usuario, redireccionará el flujo de la información a la URL de respuesta que se informa en la configuración de la aplicación. En este momento es cuando será posible por parte de la aplicación recuperar la información que se encuentra en el LDAP de AutenticA del usuario que se validó, recogiendo el parámetro AUTENTICA_USER_XML. Ejemplo: String xml_user_autentica = req.getparameter("autentica_user_xml"); De esta forma, la aplicación invocante ya dispone de la información del usuario para poder manejarla, la cual viene en formato XML XML de respuesta A continuación se muestran el XML de respuesta con los datos del usuario recibidos desde AutenticA y que deberá gestionar la aplicación invocante: <?xml version='1.0' encoding='iso '?> <respuesta> <resultado>ok</resultado> <usuario> <id>6</id> <username>1r</username> <iscitizen>false</iscitizen> AutenticA Acceso como aplicación Aplicación Página 5 de 10

6 <dir4documentid>1r</dir4documentid> <dir4documenttype>01</dir4documenttype> <cn>nombre Ape1 Ape2</cn> <givenname>nombre</givenname> <sn>ape1</sn> <dir4lastname>ap2</dir4lastname> <dir4userdateofbirth>11/06/1986</dir4userdateofbirth> <dir4userlocalitycode>1301</dir4userlocalitycode> <dir4userlocality>jaca</dir4userlocality> <dir4userlocalityentity>01</dir4userlocalityentity> <dir4usercountrycode>724</dir4usercountrycode> <dir4usercountry>españa</dir4usercountry> <dir4userprovincecode>22</dir4userprovincecode> <dir4userprovince>huesca</dir4userprovince> <dir4userccaacode>02</dir4userccaacode> <dir4userccaa>aragón</dir4userccaa> <dir4administrationlevel>2</dir4administrationlevel> <dir4organizationcode>a </dir4organizationcode> <dir4organizationdesc>comunidad AUTONOMA DE MURCIA</dir4OrganizationDesc> <dir4dircencode>a </dir4dircencode> <dir4dircendesc>consejerí A DE AGRICULTURA Y AGUA</dir4DirCenDesc> <dir4jobcentrecode>a </dir4jobcentrecode> <dir4jobcentredesc>direccion GENERAL DE MEDIO AMBIENTE</dir4JobCentreDesc> <dir4organicalunitcodedir3>a </dir4organicalunitcodedir3> <dir4organicalunitccaa>región de Murcia</dir4OrganicalUnitCCAA> <st>murcia</st> <l>murcia</l> <postalcode>30071</postalcode> <street>calle Catedrático Eugenio Úbeda 3</street> <employeetype>personal EXTERNO</employeeType> <title>servicio INTERIOR DE VIGILANCIA</title> AutenticA Acceso como aplicación Aplicación Página 6 de 10

7 <dir4usercompany>empresaexterna (España)</dir4UserCompany> <uid>6</uid> <dir4username>1r</dir4username> <dir4ldapbranch>aapp</dir4ldapbranch> <dir4originsource>autoregistro</dir4originsource> <dir4systemregisterdate>05/02/ :24:31</dir4SystemRegisterDate> <dir4lastentrydate>17/09/ :33:44</dir4LastEntryDate> <dir4observations>observaciones</dir4observations> <puestos> <puesto> <dir4administrationlevel>2</dir4administrationlevel> <dir4organicalunitcodedir3>a </dir4organicalunitcodedir3> <dir4organizationcode>a </dir4organizationcode> <dir4organizationdesc>gobierno EXTREMADURA</dir4OrganizationDesc ><dir4dircencode>a </dir4dircencode> <dir4dircendesc>consejería DE AGRICULTURA, DESARROLLO RURAL, MEDIO AMBIENTE Y ENERGÍ A</dir4DirCenDesc> <dir4jobcentrecode>a </dir4jobcentrecode> <dir4jobcentredesc>dirección GENERAL DE AGRICULTURA Y GANADERIA</dir4JobCentreDesc> DE <dir4organicalunitccaa>extremadura</dir4organicalunitccaa> <st>badajoz</st> <l>mérida</l> <postalcode>06800</postalcode> <street>avenida LUIS RAMALLO S/N</street> <title>personal DOCENTE</title> </puesto> <puesto> <dir4administrationlevel>1</dir4administrationlevel> <dir4organicalunitcodedir3>e </dir4organicalunitcodedir3> <dir4organizationcode>e </dir4organizationcode> AutenticA Acceso como aplicación Aplicación Página 7 de 10

8 <dir4organizationdesc>ministerio FOMENTO</dir4OrganizationDesc> <title>jefe / JEFA DE NEGOCIADO 2 RED LOCAL</title> </puesto> </puestos> <aplicacion> <id>261</id> <nombre>asistente</nombre> <perfiles>si</perfiles> <perfil> <id>21</id> <desc>formación</desc> <rol> <id>21</id> <desc>alumno</desc> </rol> <rol> <id>22</id> <desc>profesor</desc> </rol> </perfil> </aplicacion> </usuario> </respuesta> DE Elemento de puestos A continuación se explican con más detalle los campos descriptivos de los puestos. En primer lugar, aunque se distinga entre primer puesto y restantes según la posición en donde se encuentren del XML de respuesta, no significa que haya un puesto principal del usuario y otros secundarios, ya que todos están al mismo nivel de importancia. AutenticA Acceso como aplicación Aplicación Página 8 de 10

9 Primer puesto del usuario Contiene los siguientes campos obligatorios: dir4administrationlevel: indica el tipo de unidad orgánica o 1 AGE o 2 CCAA o 3 EELL o 4 Universidades o 5 Otras instituciones Nivel 1 de la unidad orgánica dir4organizationcode: Código del organismo dir4organizationdesc: Descripción del organismo dir4organicalunitcodedir3: Código de DIR3 del último nivel guardado de un usuario dir4organicalunitccaa: CCAA de la unidad orgánica A continuación se indican los campos no obligatorios: Nivel 2 de la unidad orgánica dir4dircencode: Código del centro directivo dir4dircendesc: Centro directivo Nivel 3 de la unidad orgánica dir4jobcentrecode: Código del centro de destino dir4jobcentredesc: Centro de destino Los siguientes elementos del XML indican la dirección del último nivel guardado de un usuario. stateorprovincename: Provincia de la unidad orgánica localityname: Localidad de la unidad orgánica postalcode: Código postal de la unidad orgánica street: Dirección de la unidad orgánica Indica el puesto o cargo del usuario dentro de la unidad orgánica a la que pertenece. Title: Puesto o cargo Resto de puestos Si el usuario tiene más puestos vienen en el XML bajo el elemento puestos, cada uno de ellos dentro del elemento puesto. Los elementos serían los mismos que en el primer puesto y con el mismo tipo de obligatoriedad. AutenticA Acceso como aplicación Aplicación Página 9 de 10

10 AutenticA Acceso como aplicación Aplicación Página 10 de 10