Configuración

Ficheros de configuración

El war de viafirma platform se entrega sin configuración, y por defecto, espera los ficheros de configuración en los siguientes paths:

Configuración de platform

/home/viafirma/viafirma_config/viafirmaConfig.properties

Configuración de EHCACHE

/home/viafirma/viafirma_config/ehcache.xml

Configuración de log4java

/home/viafirma/log4j.properties

Cambiar la ubicación de los ficheros de configuración

Para cambiar el path en el que war de viafirma espera los ficheros de configuración, los pasos a realizar son los siguientes:

Opción 1: antes del primer despliegue

• Descomprimir el empaquetado (.war o .ear).
• Modificar /WEB-INF/classes/viafirmaConfig.properties.

Opción 2: tras el primer despliegue

• Parar el contenedor de aplicaciones.
• Modificar /WEB-INF/classes/viafirmaConfig.properties.
• Arrancar el contenedor de aplicaciones.

Parámetros de Configuración

En el kit de instalación se hacen entrega de varios ficheros de configuración de ejemplo. Con configuración mínima de uso, y con la lista completa de parámetros disponibles para la versión distribuida.

• viafirmaConfig básica
• viafirmaConfig completa
• ehcache para v3.8.0
• log4j para v3.8.0

Descripción de parámetros

Configuración Básica

Configuración de Custodia

Configuración de Viafirma Manager

Esta configuración solo será necesaria en el caso que Viafirma Platforn haga uso de la aplicación Viafirma Manager.

Configuración de CA´s y Certificados

Configuración de Servicio de Sellado de Tiempo

Configuración Seguridad

Configuración HSM

Viafirma platform se puede configurar con HSM de los fabricantes Safenet y Thales. Si deseas configurar un HSM de otro fabricante, ponte en contacto con nosotros.

HSM Luna de Safenet

HSM Luna de WRAP

HSM nCipher de Thales

Globales

Configuración de Viafirma Identity

Esta configuración solo será necesaria en el caso que Viafirma Platforn haga uso de la aplicación Viafirma Identity.

Otras configuraciones

Configuración en clúster

En los casos en los que viafirma platform se encuentra en un sistema de alta disponibilidad, es necesario configurar EHCACHE en modo clúster para que las aplicaciones, o nodos, compartan la misma caché. El archivo encargado de configurar EHCACHE se llama ehcache.xml, el cual se encuentra disponible en la carpeta externa de configuración definida en la variable de configuración VIAFIRMA_CONFIGURATION_PATH.

La configuración de caché en modo clúster requiere que las aplicaciones, y/o nodos, se vean a través de la red mediante un puerto configurable. El sistema de EHCACHE para reconocer con qué otros nodos debe sincronizarse, utiliza dos tipos de descubrimiento de pares (en adelante, peeDiscovery), automático y manual. A continuación se describen estos dos tipos de peeDiscovery para poder configurar EHCACHE según el modo que más convenga al sistema (por defecto vendrán configurados con peerDiscovery=automatic):

1. peerDiscovery=automatic Los ficheros ehcache.xml se entregan normalmente configurados con el descubrimiento automático de otras caches con las que se debe poner en clúster. Un ejemplo de configuración de peerDiscovery=automatic es (igual para todos los pares): ```xml

Donde:
* **multicastGroupAddress**: Indica el puerto por el que se buscarán las distintas cachés.
* **multicastGroupPort**: Indica el puerto por el que se realizará el descubrimiento de cachés.
* **timeToLive**: Indica el rango de red en el que se buscarán cachés. Algo más adelante se describen todas las posibilidades.

2. peerDiscovery=manual En algunos casos, con infraestructuras de red más restrictivas, es necesario indicar en cada aplicación la configuración del lugar exacto donde se encuentran las otras caches con las que debe ponerse en clúster, para ello usaremos una configuración como la siguiente:

 #### EHCACHE de ejemplo de viafirma platform en modo manual nodo1 (hostname viafirma-01)
 ```xml
<!-- Se observa que peerDiscovery es manual y se le indica el host donde se encuentra la otra cache, el
puerto por el que se publica y el nombre de la cache concreta -->
<cacheManagerPeerProviderFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
properties="peerDiscovery=manual,
        rmiUrls=//viafirma-02:50002/CACHE_CERTIFICADOS|
                       //viafirma-02:50002/CACHE_DOCUMENTOS|
                       //viafirma-02:50002/CACHE_CUSTODIA|
                       //viafirma-02:50002/InEhCachePrivateHandleServerAssociations|
                       //viafirma-02:50002/InEhCacheSharedHandleServerAssociations|
                       //viafirma-02:50002/CACHE_APPS_HANDLERS|
                       //viafirma-02:50002/CACHE_APPLICATION
propertySeparator="," />

<!-- En este nodo se indica el puerto por el que se publicarán las caches de esta aplicación y el nombre de este host o ip-->
<cacheManagerPeerListenerFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"
properties="hostName=viafirma-01, port=50001"/>

EHCACHE de ejemplo de viafirma platform en modo manual nodo2 (hostname viafirma-02)

<!-- Se observa que peerDiscovery es manual y se le indica el host donde se encuentra la otra cache, el
puerto por el que se publica y el nombre de la cache concreta -->
<cacheManagerPeerProviderFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
properties="peerDiscovery=manual,
        rmiUrls=//viafirma-01:50001/CACHE_CERTIFICADOS|
                       //viafirma-01:50001/CACHE_DOCUMENTOS|
                       //viafirma-01:50001/CACHE_CUSTODIA|
                       //viafirma-01:50001/InEhCachePrivateHandleServerAssociations|
                       //viafirma-01:50001/InEhCacheSharedHandleServerAssociations|
                       //viafirma-01:50001/CACHE_APPS_HANDLERS|
                       //viafirma-01:50001/CACHE_APPLICATION
propertySeparator="," />

<!-- En este nodo se indica el puerto por el que se publicarán las caches de esta aplicación y el nombre de este host o ip-->
<cacheManagerPeerListenerFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"
properties="hostName=viafirma-02, port=50002"/>

Donde se debe tener en cuenta que existen dos nodos a configurar:

• cacheManagerPeerProviderFactory donde se configuran las urls donde se encuentran las distintas cachés con las que debe ponerse en clúster, la url se forma del modo //:/, los nombres de cache serán siempre los que se indican en el ejemplo a no ser que el equipo de viafirma indique algo diferente.
• cacheManagerPeerListenerFactory donde se indicar el nombre del host en el que se encuentra y el puerto por donde se publicarán sus cachés.

El resto de configuración de estos archivos no debe tocarse ya que se proporcionan preconfigurados.

Por otro lado, otro aspecto a tener en cuenta para la configuración en alta disponibilidad, es la configuración de un sistema de ficheros mediante NFS el cual sea accesible desde ambos nodos. Esto último es necesario siempre y cuando tengáis configurada la aplicación para que custodie los ficheros firmados en disco. Esto se puede comprobar desde el fichero de configuración de la aplicación, y ver si existe la variable de configuración PATH_CUSTODIA. Cuando se configure el NFS, habría que cambiar la ruta en esta variable de configuración apuntando a la carpeta montada con conexión al NFS

Si por el contrario, se tiene configurada la aplicación para que no custodie en disco, si no que por tiempo limitado estén los documentos firmados disponibles en caché, no habría que configurar nada en tema de custodia.

Una vez configurados los dos nodos en cluster, se deberá montar un balanceador que apunte a ambos nodos.