Subdirección de las Tecnologías de la Información y Comunicaciones

Área de Gobernanza y Calidad

Cumplimiento normativo

Histórico de cambios

Los cambios en la normativa vendrán acompañados de un registro de las modificaciones. De este modo se podrá realizar un seguimiento y consultar su evolución. Ordenándose de mas recientes a menos recientes, prestando especial cuidado a las cabezeras de la tablas dónde se indican las fechas de entrada en vigor y versión.

1. Introducción 

Para la integracion con dmsas recomendamos el uso de la siguiente libreria dmsasApiClient. Esta librería permitirá es desarrollada y mantenida por la STIC, permitiendo al usuario comunicarse con el servidor LDAP de DMSAS de forma fácil y sin necesidad de conocer los aspectos técnicos de dicha comunicación.

Actualmente la librería tiene las siguiente funcionalidades:

• Autentificación
  • Permite realizar la autentificación con dmsas.
• Busqueda
  • Permite realizar la busqueda de usuarios en dmsas.

De cara a priorizar futuras funcionalidades, si algún proveedor tiene la necesidad de alguna funcionalidad adicional se deberá de comunicar a l-arquitectura.stic.sspa@juntadeandalucia.es

2. Historial de Cambios

• 1.1.3.2:
  • Modificación para hacer serializables los beans expuestos por DmsasApiClient-cdi.
  • Modificación para hacer serializable DmsasUser.
• 1.1.3.1
  • Optimizada la busqueda evitando que realice busquedas en diferentes nodos
  • Limitado el numero de resultados por defecto a 20
• 1.1.2.1
  • Añadida posibilidad de establecer el dominio y compatibilidad con la libreria de sasconfiguration
• 1.1.1.1
  • Injeccion con CDI de los servicios.
• 1.1.0.1
  • Busqueda en DMSAS de usuarios
• 1.0.0.1
  • Versión inicial
  • Autenticación con DMSAS

3. Integración de la librería

Para incluir la librería en un proyecto maven es necesario realizar los siguientes pasos:

1. Agregar el repositorio de la Junta de Andalucía. Es posible realizarlo de dos formas diferentes.

   • Especificando el repositorio en la configuración global.

     <project>
         ...
           <repositories>
             <repository>
               <id>Repo_SAS</id>
               <name>Repo_SAS</name>
               <url>http://calidad.sas.junta-andalucia.es/artifactory/sas-internal</url>
             </repository>
           </repositories>
         ...
     </project>

   • Otra opción es especificar un perfil en concreto en ${user.home}/.m2/settings.xml

     <settings>
              ...
             <mirrors>
     		<mirror>
     		<id>Repo_SAS</id>
     		<name>Repo_SAS</name>
     		<url>http://snap.java.lib.repository.dev.alm.sas.junta-andalucia.es</url>
     		<mirrorOf>*</mirrorOf>
     		</mirror>
     		</mirrors>
     	<profiles>
         <profile>
             <activation>
                 <activeByDefault>true</activeByDefault>
             </activation>
             <repositories>
                 <repository>
                     <id>nexus-public</id>
                     <name>Nexus Public Repository</name>
                     <url>http://snap.java.lib.repository.alm.pre.sas.junta-andalucia.es</url>
                     <releases>
                         <enabled>true</enabled>
                     </releases>
                     <snapshots>
                         <enabled>true</enabled>
                         <updatePolicy>always</updatePolicy>
                     </snapshots>
                 </repository>
             </repositories>
         </profile>
     </profiles>
              ...
      </settings>

     Hay que tener en cuenta, que se deberá de tener activo el perfil.

2. Especificar la dependencia en el POM del proyecto que requiere la funcionalidad. Se especificara "-cdi" si se quiere hacer uso de CDI e inyecciones.

   ...
       <dependencies>
           <!--DMSAS-->
           <dependency>
               <groupId>es.ja.csalud.sas.componentescomunes.dmsasapiclient</groupId>
               <artifactId>dmsasApiClient[-cdi]</artifactId>
               <version>x.x.x.x</version>
       </dependency>
   ...

Configuracion

Puede ser usada mediante CDI o de forma tradicional creando los objetos requeridos por cada constructor. Con CDI es indispensable especificar como se producirán las inyecciones del objeto de configuración.

Actualmente existe un objeto de configuración:

• DmsasApiConfig, gestiona la configuración general de la libreria. Ejemplo:

  ...
     @Produces
     public DmsasApiConfig getDmsasApiConfig() {
          final DmsasApiConfig dmsasApiConfig = new DmsasApiConfig();
          dmsasApiConfig.setUrl("ldap://x.x.x.x:xxx/DC=dmsas,DC=sda,DC=sas,DC=junta-andalucia,DC=es");
          dmsasApiConfig.setSearchDN("OU=VirgenRocio,OU=AtencionEspecializada");
          dmsasApiConfig.setLdapDomain("dmsas-test")
          return dmsasApiConfig;
     }
  ... 

• Haciendo uso de la libreria de configuracion sasconfiguration:
  Ejemplo:

  @Inject
      SasConfigService sasConfigService;
  ...
     @Produces
     public DmsasApiConfig getDmsasApiConfig() {
          return new DmsasApiConfig(sasConfigService);
     }
  ...

  Los campos que se deberan de establecer en la configuracion seran:
  • es.ja.csalud.sas.componentescomunes.dmsasapiclient.config.url
  • es.ja.csalud.sas.componentescomunes.dmsasapiclient.config.searchDN
  • es.ja.csalud.sas.componentescomunes.dmsasapiclient.config.domain

Los parametros para los diferentes entornos son:

Este objeto serán usados por defecto en todas las inyecciones de la librería.

Si no se usa CDI para inyectar los servicios se podra hacer uso de la factoria DmsasFactory que facilita la creacion de los servicios.

4. Funcionalidades

Autenticación

Para poder realizar la autenticación y autorización con Dmsas se deberá de hacer uso del servicio `DmsasAuthentication` Mediante el uso del método `.loginAuthentication()` que devuelve un objeto `DmsasUser`, se podrá realizar la autenticación con Dmsas. Si la autenticación no se ha podido realizar con existo se lanzara una excepción de tipo `DmsasException`.

Ejemplo:

...
    @Inject
    DmsasAuthentication dmsasAuthentication;

    public DmsasUser login(String username, String password) {
        return dmsasAuthentication.loginAuthentication(username, password);
    }
...

Búsqueda

Para poder realizar la Busqueda en Dmsas se deberá de hacer uso del servicio `DmsasSearch` Mediante el uso del método `.userSearch()` o `.usersSearch()` que devuelve un objeto `DmsasUser` o una lista de estos, sera necesario pasarle como parametros el usuario que realizara la operacion de busqueda, y otro objeto de usuario con los parametros de búsqueda. Si la busqueda no se ha podido realizar con existo se lanzara una excepción de tipo `DmsasException`.

Ejemplo:

 ... //con cdi
    @Inject
    DmsasSearch dmsasSearch;
... //sin cdi
    DmsasFactory dmsasFactory = new DmsasFactory(apiConfig);
    DmsasSearch dmsasSearch=dmsasFactory.getDmsasSearch();
... //busqueda
    DmsasUser result=dmsasSearch.userSearch(petitioner, searchCriteria);
...