VTOL CD CL - Guía de implementación 3.8.0.X

Guía de Implementación

VTOL Crédito Débito Chile

Cambio por Revisiones

Fecha Versión Cambios – Motivo

24/09/2013 1.0 Creación del documento

05/05/2014 1.1 Actualización propiedades de configuración. Agregado comando para anular entorno grafico cuando el sistema es LINUX

17/06/2016 1.2 Modificación de títulos

19/05/2017 1.3 Actualización formato del manual. Actualización de Pre-requisitos para la versión 3.8. Agregado de escenarios de instalación

13/10/2017 1.4 Revisión del documento y actualización del formato en el manual

28/08/2018 1.5 Agregado de apartado "4.3 Flujo de implementación"

Índice

1. Objetivo2. Alcance3. Referencias4. Introducción

4.1 Qué es RS-VTOL CR/DB?4.1.1 VTOL Server4.1.2 VTOL Client

4.2 Acerca de este manual4.3 Flujo de implementación

5. Pre-requisitos del Sistema5.1 VTOL Server

5.1.1 Plataformas Soportadas5.1.2 Requerimientos de Hardware5.1.3 Requerimientos de Software

5.2 VTOL Client5.2.1 Plataformas Soportadas5.2.2 Requerimientos de Hardware5.2.3 Requerimientos de Software

6. Instalación de VTOL Server6.1 Escenarios de instalación

6.1.1 Instalación de cero de VTOL 3.86.1.1.1 Instalación completa6.1.1.2 Reinstalación

6.1.2 Migración de VTOL 3.7 Productivo a VTOL 3.8 Productivo6.1.3 Actualización de VTOL 3.8 Productivo

6.2 Componentes instalados7. Configuración de la Base de Datos

7.1 Creación7.2 Actualización

8. Instalación de certificado para protocolo HTTPS8.1 Definición y Norma8.2 Uso de certificados8.3 Instalación de certificado

9. Inicio de la aplicación10. Configuración

10.1 Configuración de variables del Sistema10.2 Administración de usuarios para acceso administrativo WEB

11. Recomendaciones11.1 Auditoria

1. Objetivo

El objetivo de este documento es ofrecer una guía completa del proceso de instalación del producto RS-VTOL CR/DB CL.Se explicarán los pasos de la implementación, los requerimientos de hardware y software como así también las propiedades a ser configuradas.

2. AlcanceRS VTOL Crédito Débito Chile.

3. ReferenciasSe menciona la serie de documentos que acompañan al producto:

VTOLCR-DB- Guía de implementación

Este manual.

RS-VTOL-Credito Debito Chile - Manual de Usuario

El manual del usuario tiene como finalidad capacitar a los usuarios en el uso de la consola de administración del producto VTOL CR/DB CL.

4. Introducción

4.1 Qué es RS-VTOL CR/DB?

RS-VTOL CR/DB es un validador de transacciones en línea, especializado en la industria del retail y sus operaciones financieras.Funciona como un gateway multipropósito que conduce transacciones electrónicas desde y hacia diferentes participantes (tiendas físicas y virtuales, banca, proveedores) a través de redes heterogéneas en forma rápida, segura y eficiente.El producto VTOL está formado por dos componentes:

VTOL ServerVTOL Client

4.1.1 VTOL Server

VTOL Server es una aplicación desarrollada íntegramente en el lenguaje de programación Java, que la hace independiente del sistema operativo a emplearse.Posee una capa de persistencia que permite abstraerse del motor de base de datos a utilizar.Hay diversos componentes de comunicación que permiten comunicar a la aplicación bajo diferentes protocolos de comunicación.A su vez, existe una capa de interpretación que se encarga de interpretar los mensajes entrantes y salientes de la aplicación. Esta característica permite manejar diferentes protocolos, algunos operando bajo ciertos estándares y otros del carácter propietarios.Una vez pasada la capa de interpretación, existe un módulo denominado VTOL Core. Este componente se encarga de realizar la auditoría de transacciones bajo lo que denominamos "tercer mensaje". Este protocolo permite tener sincronizado el punto de venta con VTOL de forma tal de evitar la pérdida de transacciones o la duplicidad de las mismas.Por último, cada transacción es derivada por el VTOL Core al módulo crédito débito, el cual envía las autorizaciones financieras al centro autorizador para su aprobación.Las transacciones son persistidas en la base de datos, respetando las normas de seguridad de la norma PCI para su posterior explotación, como ser reportes, cierres de lotes, conciliación de transacciones, monitoreos, etc.El producto cuenta con una consola WEB de administración centralizada a través de la cual se puede: configurar la aplicación, obtener diversos reportes, monitorear el sistema, definir alertas, administrar la seguridad, acceder a la auditoría, etc. Esta consola de administración presenta un nivel de seguridad de acceso por usuario y contraseña.A nivel de arquitectura, la aplicación está soportada sobre el servidor de aplicaciones JBOSS, el cual brinda diferentes servicios que son utilizados por VTOL, como ser por ejemplo la configuración de datasources.

4.1.2 VTOL Client

VTOL Client es el componente encargado de capturar los datos de las tarjetas a través del pinpad e iniciar el proceso de autorización contra VTOL Server. Es una aplicación Java del tipo Stand Alone; es decir, no requiere de ningún servidor de aplicación para poder ejecutarse ni tampoco tiene una interfaz gráfica de usuario, que se encontrará configurada en cada máquina donde se ejecuta la aplicación de punto de venta.Este componente expone una API de integración del tipo TCPIP bajo el protocolo llamado "protocolo VTOL". A través de esta API, las aplicaciones de punto de venta pueden iniciar una transacción de: venta, anulación, etc.

Arquitectura de VTOL Client

4.2 Acerca de este manual

En este manual encontrará toda la información necesaria para instalar el producto RS-VTOL CR/DB.Se explicarán cada uno de los pasos de instalación, los requerimientos de hardware y software, las propiedades a ser configuradas.

1.

2.

3.

4.

5.

6.

7.

4.3 Flujo de implementación

En este apartado se explicará la secuencia o los pasos para instalar de cero, configurar e iniciar VTOL Server:

Verificar y cumplir con los pre-requisitos del sistema, tanto de software como de hardware (apartado  )5. Pre-requisitos del sistema

Efectuar la instalación completa mediante el asistente gráfico de instalación (apartado )6.1.1 Instalación de cero de VTOL 3.8

Crear la base de datos y ejecutar los script de base de datos (apartado  )7.1 Creación de la base de datos

Iniciar VTOL Server (apartado  )9. Inicio de la aplicación VTOL Server

Acceder e iniciar sesión en la consola web de administración (apartado 10. Configuración)

Configurar las propiedades y las variables iniciales que utilizará VTOL, como por ejemplo "VTOL Core Habilitado" (apartado  )10.1 Configuración de variables del Sistema

Administrar la seguridad del usuario (apartado  )10.2 Administración de usuarios para acceso administrativo WEB

Una vez efectuado el flujo de implementación, dirigirse al documento "VTOL CD CL - Manual de usuario" para conocer cómo operar con el producto VTOL.

5. Pre-requisitos del Sistema

5.1 VTOL Server

A continuación, se detallarán los pre-requisitos para realizar la instalación de VTOL Server en el sistema.

5.1.1 Plataformas Soportadas

Windows 32/64 bitsWindows 7 o superiorWindows Server 2012 R2 o superior

Linux 32/64 bitsCent OS v7

AIX

5.1.2 Requerimientos de Hardware

Memoria RAM: 2GB como mínimo disponible para la aplicaciónCPU: cuádruple procesador de al menos 2.6 GHZCapacidad de almacenamiento en Disco Rígido: 20GB o superior1 placa de red de 100Mb o 2 placas de red de 100Mbits para instalación en clúster

5.1.3 Requerimientos de Software

Java Virtual Machine (JDK) jdk1.8Link de descarga: http://www.oracle.com/technetwork/java/javase/downloads/index.html

Servidor de aplicaciones WildFly 10.1.0 compatible con JBoss 7 EAP Motor de base de batos:

MS SQL Server 2012 Service Pack 3 o superiorOracle 11.2 o superior

5.2 VTOL Client

A continuación, se detallarán los pre-requisitos para realizar la instalación de VTOL Client en el sistema.

5.2.1 Plataformas Soportadas

Windows 32/64 bitsLinux 32/64 bits

5.2.2 Requerimientos de Hardware

Memoria RAM: 64MB disponiblesCPU: 2 núcleos de 1.6 GHZ o superiorCapacidad de almacenamiento en Disco Rígido: 150MB o superior

Advertencia: Es requerido que NAPSE efectúe un correcto dimensionamiento de los requerimientos del hardware en base a la cantidad de transacciones a procesar y la cantidad de usuarios concurrentes en la aplicación.

Advertencia: Es requerido que NAPSE efectúe un correcto dimensionamiento de los requerimientos del software en base a la cantidad de transacciones a procesar y la cantidad de usuarios concurrentes en la aplicación.

El software de base debe tener instalados todos los parches de seguridad que el fabricante haya liberado hasta el momento.

1.

2.

3.

1.

2.

3.

5.2.3 Requerimientos de Software

Java Virtual Machine (JDK) 1.6.x (32/64 bits acorde al SO) o superiorConexión a VTOL Server por red TCP/IP

6. Instalación de VTOL ServerExisten diferentes escenarios al momento de instalar VTOL.A continuación, se listan los distintos escenarios y posteriormente se explica en detalle cómo es cada uno de ellos.Escenarios posibles:

Instalación de cero de VTOL 3.8Es el caso cuando se quiere instalar por primera vez VTOL y no existe ninguna instalación del mismo en el sistema

Migración de VTOL 3.7 Productivo a VTOL 3.8 ProductivoEs el caso cuando se encuentra instalada la versión 3.7 de VTOL en un entorno de producción y se desea cambiar a la versión 3.8

Actualización de VTOL 3.8 ProductivoEs el caso cuando se encuentra instalada la versión 3.8 de VTOL en un entorno de producción y se desea ejecutar una actualización

6.1 Escenarios de instalación

6.1.1 Instalación de cero de VTOL 3.8

La instalación de cero se refiere a instalar VTOL por primera vez en el sistema. Dado que no existe una instalación previa, no existe información sensible de tarjetas en logs o en base de datos. Por lo tanto, este procedimiento, no constituye un riesgo de seguridad sobre la información sensible de las tarjetas que puede estar almacenada. Se ofrecen dos escenarios para instalar de cero VTOL:

la forma completa y recomendada (explicada en el punto )"6.1.1.1 Instalación completa"reinstalación – solo componentes de VTOL (indicada en el punto )"6.1.1.2 Reinstalación"

6.1.1.1 Instalación completa

La instalación completa de VTOL se realiza gracias al uso de un asistente gráfico de configuración. Esta forma de instalar VTOL es la recomendada por su facilidad.Para ello se deben seguir los siguientes pasos:

Verificar la existencia de la base de datos que usará la aplicación VTOL.

Iniciar sesión en el sistema operativo donde se instalará la aplicación VTOL con un usuario con permisos de administrador.

Iniciar el instalador de la aplicación VTOL ejecutando la siguiente sentencia en la línea de comandos:

java –jar INSTALADOR.jar

Por ejemplo:

java –jar rs-vtol-cd-ha-cl-installer-3.8.0.0-rc10-08-2017.jar

4. Se presentará la pantalla de bienvenida del instalador. Para pasar a la siguiente pantalla presionar el botón ."Próxima"

Nota: Verificar tener correctamente configurada la variable JAVA_HOME. En caso de no tenerla, configurarla con la ruta de la carpeta de instalación de la JVM. Para esto verificar la carpeta de instalación, ejemplo: C:\Java\jdk1.8.0_77".

Importante: En caso de que el sistema operativo sea LINUX y no cuente con entorno gráfico, se debe ejecutar la siguiente sentencia por línea de comando: export DISPLAY=:0.0

5. Al pasar a la siguiente pantalla se mostrarán los términos de servicio y condiciones de uso de la aplicación para ser leídos. Oprimir el botón ."Aceptar"

6. Se deberán aceptar los términos y condiciones y completar con el nombre completo y el correo electrónico para poder continuar con la instalación. Oprimir el botón " ".Próxima

7. En la siguiente pantalla se deja seleccionada la opción " " y se pasa a la pantalla siguiente presionando el botón " ".Complete Installation Próxima

8. A continuación, se deberá seleccionar el directorio de instalación de Wildfly. El mismo puede realizarse escribiendo manualmente la ruta o a través del botón "Seleccionar carpeta" que permitirá navegar la estructura de directorios.

Además, deberá ingresar el nombre del directorio en el cual se copiara la configuración de VTOL dentro de Wildfly (path " utilizando como plantilla la configuración provista por Wildfly WILDFLY_HOME/")en la carpeta " ".WILDFLY_HOME/default

El sistema validará:

                              i.    que exista el directorio “ ”WILDFLY_HOME/default

                              ii.   que el directorio “ ” posea una estructura válidaWILDFLY_HOME/default

Presionar para continuar los pasos de instalación."Próxima"

1. 2.

9. Indicar el motor de base de datos que se utilizara y oprimir " ".Próxima

10. Ingresar los datos vinculados con la base de datos a emplearse.

Versión del motor de base de datos.

2. 3. 4. 5.

Host de la base de datos.Nombre de la base de datos.Nombre de usuario para acceso a la base.Password del usuario.

Una vez completados los datos anteriores, presionar "Próxima".

11. Configuración de datos extras y cluster.

En este paso se configuran los datos para que VTOL pueda funcionar en la modalidad alta disponibilidad o cluster.Si no desea utilizar la modalidad cluster, solo configure las siguientes propiedades y haga clic en " ".Próxima

Propiedad Descripción

Cluster Partition Name Nombre de la partición del cluster. El mismo debe ser único y distinto a otro cluster que esté en la red empresarial de lo contrario podrían entrar en conflicto llevando a un funcionamiento erróneo. Se recomienda utilizar el nombre lógico del server y la palabra partición. Por ejemplo: "MyServerPartition"

Time Zone Zona horaria en la cual se instalará la aplicación. Por ejemplo " "GMT-03:00

Si desea utilizar la modalidad cluster, configure las siguientes propiedades y haga clic en " ".Próxima

Propiedad Descripción

Cluster Node Identificador del nodo dentro del cluster. Este no se tiene que repetir entre los integrantes del mismo cluster

Cluster Node Description Descripción del nodo del cluster. Esta descripción se visualizará en la consola de administración.

Cluster Partition Name Nombre de la partición del cluster. Mediante este valor se confecciona el cluster, por lo tanto, debe coincidir con aquellos nodos que conforman el cluster.

: El mismo debe ser distinto a otro cluster que esté en la red empresarial y no se desee Notaintegrar, de lo contrario podrían entrar en conflicto llevando a un funcionamiento erróneo.

Cluster Interface IP Address IP que tiene asignada la placa de red que servirá como interface entre los nodos del cluster.

Time Zone Zona horaria en la cual se instalará la aplicación. Por ejemplo " "GMT-03:00

12. Presionar para ejecutar el proceso de instalación."Install"

13. La finalización de la instalación se informa mediante un mensaje de "Terminado". Oprimir " ".Aceptar

Se podrá observar información detallada de la instalación presionando el botón "Enseñar detalles". Al hacer esto se mostrarán dos solapas:

En la solapa "Salida" podrá observar el progreso de la instalación visualizando las tareas ejecutadas por el instaladorEn la solapa "Errores" se presentan las fallas que tuvieron lugar durante la instalación

14. Presionar el botón " " para salir del instalador.Salir

1. 2.

15. Dentro del directorio wildfly-10.1.0.Final se creó la carpeta con la nueva versión instalada de VTOL.

A continuación, lo que se debe realizar es ejecutar los scripts en la base de datos. Ver el apartado 7.1 Creación

6.1.1.2 Reinstalación

Esta instalación está pensada para reinstalaciones de VTOL Server donde no se quiere perder la configuración realizada previamente sobre el servidor de aplicaciones.RS-VTOL CR/DB cuenta con un instalador gráfico que guía a través del proceso de reinstalación de la aplicación. Primero solicita al usuario el ingreso de los parámetros de configuración requeridos y luego efectúa la reinstalación del producto, la cual consiste en el armado de una estructura de directorios que contiene los componentes de la aplicación, como ser los scripts de base de datos, archivos de configuración, etc.A continuación, se describen los pasos para realizar la reinstalación de la aplicación:

Iniciar sesión en el sistema operativo donde se reinstalará la aplicación VTOL con un usuario con permisos de administrador.Iniciar el instalador de la aplicación VTOL ejecutando la siguiente sentencia en la línea de comandos:

java –jar INSTALADOR.jar

por ejemplo: java –jar rs-vtol-cd-ha-cl-installer-3.8.0.0- rc10-08-2017.jar

3. Se presentará la pantalla de bienvenida del instalador. Para pasar a la siguiente pantalla presionar el botón ."Próxima"

Nota: Verificar tener correctamente seteada la variable JAVA_HOME. En caso de no tenerla, setearla a la carpeta de instalación de la JVM. Para esto verificar la carpeta de instalación, ejemplo: C:\Java\jdk1.8.0_77".

Importante: En caso de que el sistema operativo sea LINUX y no cuente con entorno gráfico, se debe ejecutar la siguiente sentencia por línea de comando: export DISPLAY=:0.0

4. Al pasar a la siguiente pantalla se mostrarán los términos de servicio y condiciones de uso de la aplicación para ser leídos. Oprimir el botón ."Aceptar"

5. Se deberán aceptar los términos y condiciones y completar con el nombre completo y el correo electrónico para poder continuar con la instalación. Oprimir el botón " ".Próxima

6. En la siguiente pantalla debe seleccionar la opción "Only VTOL Components" y presionar el botón " ".Próxima

7. A continuación, se deberá seleccionar el directorio de instalación de Wildfly. El mismo puede realizarse escribiendo manualmente la ruta o a través del botón "Seleccionar carpeta" que permitirá navegar la estructura de directorios.

Además, en "'rsvtol' Server Configuration" deberá ingresar el nombre de la carpeta que aparece en la configuración del server Standalone.Presionar para continuar los pasos de instalación."Próxima"

8. Indicar el motor de base de datos que se utilizara y oprimir " ".Próxima

1. 2. 3. 4.

9. Configuración de datos extras y cluster.

Si no desea utilizar la modalidad Clúster, haga clic en " ", de lo contrario configure el resto de las propiedades:Próxima

El identificador del nodo dentro del clústerLa descripción del nodo del clúster. Esta descripción se visualizará en la consola de administraciónLa dirección IP de la interfaz. IP que tiene asignada la placa de red que servirá como interface entre los nodos del clústerLa zona horaria en la cual se está instalando la aplicación

10. Presionar para ejecutar el proceso de instalación."Install"

11. La finalización de la instalación se informa mediante un mensaje de "Terminado". Oprimir " ".Aceptar

Se podrá observar información detallada de la instalación presionando el botón "Enseñar detalles". Al hacer esto se mostrarán dos solapas:

En la solapa "Salida" podrá observar el progreso de la instalación visualizando las tareas ejecutadas por el instaladorEn la solapa "Errores" se presentan las fallas que tuvieron lugar durante la instalación

12. Presionar el botón " " para salir del instalador.Salir

1. 2.

1. 2.

1. 2.

1. 2.

3.

13. Dentro del directorio wildfly-10.1.0.Final se creó la carpeta con la nueva versión instalada de VTOL.

6.1.2 Migración de VTOL 3.7 Productivo a VTOL 3.8 Productivo

Cuando la instalación de VTOL 3.8 se haga sobre una instalación de VTOL 3.7, se deberán seguir los siguientes pasos:

Detener la aplicación o servicio de VTOLSe debe verificar que se borre de forma segura los logs de VTOL 3.7Realizar una copia de seguridad de la base de datos utilizada por la aplicación VTOL. Es importante tener en cuenta que no se almacenan datos en texto plano. Los mismos son almacenados encriptados dentro de la misma base de datosInstalar VTOL 3.8 siguiendo los pasos indicados en ésta guía

Iniciar en el paso "6.1.1 Instalación de cero de VTOL 3.8"Dado que la base de datos ya existe, no ejecutar el paso de creación de base de datos " " dentro de " ". En cambio, sí se debe ejecutar la 7.1 Creación 7 Configuración de la Base de Datosactualización de la base de datos detallado en el paso " "7.2 Actualización

Si la instalación fue exitosa:Realizar el borrado seguro de la instalación de VTOL 3.7Se deberá borrar el contenido entero de la copia de seguridad del punto 3, asegurándose la eliminación segura de cualquier dato sensible almacenado en el sistema de archivos

Si la instalación no fue exitosa (rollback de la versión):Realizar el borrado seguro de la instalación de VTOL 3.8 recién instalada.Restaurar la base de datos con la copia de seguridad generada en el punto 3. La operatoria corresponde a una restauración general en MSSQL Server u Oracle, según corresponda. Luego, eliminar la copia de seguridad de forma segura

6.1.3 Actualización de VTOL 3.8 Productivo

Cuando la instalación de VTOL 3.8 se realice sobre una instalación anterior a VTOL 3.8 se deberán seguir los siguientes pasos:

Detener la aplicación o servicio de VTOLBorrar de forma segura los logs de VTOL 3.8.

Importante: La actualización de versión trae consigo un cambio de seguridad con respecto a la registración de las contraseñas de usuarios de consola Web. Luego de la migración se debe tener en cuenta que:

Los usuarios utilizados en la consola de administración serán bloqueados.La clave del Administrador de sistema será reiniciada a "suser123"El administrador del sistema deberá luego habilitar y cambiar la clave para que los demás usuarios puedan volver a loguearse. En ese instante el sistema solicitará el cambio de clave del usuario la cual deberá ser compatible con los requerimientos de PCI.

3. 1.

4. 5.

1.

6. 1.

7. 1. 2. 3.

Realizar una copia de seguridad de la instalación actual de VTOL 3.8Hacer una copia de seguridad de la siguiente carpeta:{WILDFLY_HOME}/rsvtol

Realizar una copia de seguridad de la base de datos de VTOLInstalar VTOL 3.8 siguiendo los pasos indicados en esta guía:

Comenzar en el paso " ". Dado que la base de datos ya existe, no ejecutar el paso de creación de base de datos sino que se debe ejecutar la actualización detallada en el 6.2 Re-instalaciónpaso " ".n7.2 Actualizació

Si la instalación fue exitosa: realizar el borrado seguro de la copia de seguridad de la instalación de VTOL 3.8Se deberá borrar el contenido entero de las copias de seguridad de los puntos 3 y 4, asegurándose la eliminación segura de cualquier dato sensible almacenado en el sistema de archivos

Si la instalación no fue exitosa (rollback de la versión):Realizar el borrado seguro de la instalación de VTOL 3.8 recién instaladaRestaurar el contenido de la copia de seguridad y borrar tal copia de forma seguraRestaurar la base de datos con la copia de seguridad generada en el punto 4. La operatoria corresponde a una restauración general en MSSQL Server u Oracle, según corresponda. Luego, eliminar la copia de seguridad de forma segura.

6.2 Componentes instalados

Finalizada la reinstalación se visualizarán los componentes dentro de la carpeta 'rsvtol' de la siguiente forma:

Carpeta Descripción

bin Contiene los archivos de inicio y de detención de la aplicación como proceso de Windows y de Linux

configuration Esta carpeta contiene toda la configuración del Application Server adaptada para que la aplicación VTOL funcione correctamente

1. 1. 2. 3.

1. 1. 2.

deployments En esta carpeta se encuentra el EAR de la aplicación

dist Posee dos carpetas importantes en su interior:

config: contiene toda la configuración propia de VTOLscripts: contiene los scripts de base de datos que permiten su creación y populación

lib Reservado para uso futuro para que puedan almacenarse librerías

tmp Carpeta de temporales del servidor de aplicaciones

7. Configuración de la Base de Datos

7.1 Creación

Los scripts para creación e inicialización de la base de datos empleada por la aplicación se encuentran en la carpeta "scripts" dentro del directorio de instalación del producto. Los scripts se encuentran separados en carpetas "core" y "cd-cl" según el motor de base de datos al que corresponden y deberán ser ejecutados en la secuencia que se indica a continuación.

Cada archivo contiene, como inicio de su nombre, un número que indica la secuencia en que debe ser corrido.

Primero se deben ejecutar los script de VTOL CORE, ubicados en:

core{WILDFLY_HOME}\rsvtol\dist\scripts\ \nombreMotorBD

Ejecutar los scripts:1-CONSOLE-SCHEMA2-CORE-SCHEMA3-CORE-POPULATE

Por último se deben ejecutar los scripts del módulo Crédito Débito Chile, ubicados en

\rsvtol\dist\scripts\cd-cl{WILDFLY_HOME} \nombreMotorBD

Ejecutar los scripts :1-CD-CL-SCHEMA.SQL2-CD-CL-POPULATE.SQL

Donde:

{WILDFLY_HOME}es el directorio donde se instaló el Wildfly 10.1.0

nombreMotorBDcorresponde al nombre del motor de base de datos

mssql – Motor de base de datos MS SQL Serveroracle – Motor de base de datos Oracle

Cuando el motor de base de datos sea MSSQL, tiene que estar activo el isolation level “READ_COMMITTED_SNAPSHOT”. Para activarlo se debe ejecutar el siguiente comando:

ALTER DATABASE [nombre_bbdd] SET READ_COMMITTED_SNAPSHOT On;

Donde nombre_bbdd es el nombre de la base de datos.

 Para que el cambio surja efecto, no debe haber conexiones activas salvo la indicada anteriormente.Nota:

7.2 Actualización

Cuando la instalación se trate de una actualización de versión y no una instalación de cero, es posible que se deba actualizar la base de datos pre-existente. Para este caso existen scripts de actualización de la base de datos. Estos se identifican por el comienzo con INC en su nombre (Incremental). Por ejemplo: ."INC-3.6.1.0-TO-3.6.1.1.sql"Los mismos se encuentran en los siguientes directorios:

Scripts correspondientes a VTOL CORE

core\n{WILDFLY_HOME}\rsvtol\dist\scripts\ ombreMotorBD

Scripts correspondientes a Módulo Crédito Débito Chile

\rsvtol\dist\scripts\cd-cl{WILDFLY_HOME} \nombreMotorBD

8. Instalación de certificado para protocolo HTTPSEl monitoreo y la administración de la aplicación VTOL se hace por medio de una consola WEB. Por cuestiones de seguridad, el acceso a esta se hace por medio del protocolo seguro HTTPS (protocolo HTTP sobre canal encriptado). Para que este protocolo funcione correctamente hay que instalar un certificado válido.A continuación se explica qué es un certificado digital, cómo se gestiona y cómo se instala.

8.1 Definición y Norma

HTTPS es la implementación segura de HTTP. Si bien existen varios protocolos y versiones solo algunos son seguros (no se ha podido demostrar lo contrario):

SSLv3 (recomendado y por defecto en la aplicación)TLSv1

Por lo tanto se aconseja usar SSLv3.Además es requerido como norma de seguridad la utilización de:

Algoritmos de encriptación AES o RSA

Algoritmos de Hashing: SHA-512Clave de encriptación mayor a 512 bits

8.2 Uso de certificados

La utilización de HTTPS implica el uso de certificados digitales.

Ilustración de un certificado digital

Un certificado digital está compuesto por:

Datos del propietario del certificadoClave públicaClave privadaDatos del certificado

La aplicación VTOL hace uso de los certificados Los   son documentos   que dan fe de la vinculación entre una clave pública y un individuo o entidad.mediante la utilización de un "keystore" certificados digitalesde java. Un "keystore" es un almacén o base de datos de java, que almacena claves y certificados.Los certificados pueden estar certificados por una entidad CA Autoridad Certificadora o Certification Authority. Ejemplo: Verisign, Trustwave habilitada o bien pueden estar auto-firmados, es decir, tener un CA propio.Si se usa un certificado auto-firmado, el cliente WEB emitirá una alerta ya que no puede validar el certificado con una entidad CA válida.

8.3 Instalación de certificado

Nota: Se recomienda utilizar un certificado emitido por una entidad habilitada.

A continuación se detalla cual es la secuencia para instalar un certificado digital emitido por una CA en la aplicación VTOL.En caso de instalar el certificado auto-firmado, ejecutar el "Paso 1" y luego continuar con el "Paso 4".

Paso 1En este paso se creará un nuevo KeyStore con su clave privada y su certificado auto-firmado. El comando a utilizar es el siguiente:keytool -genkey -alias vtol -keyalg RSA -sigalg "SHA1withRSA" -keystore synthesis.keystore -validity 90 -storepass -keysize 1024changeit

Este comando pedirá información para poder generar el certificado.

Finalizado este paso se habrá creado un archivo "synthesis.keystore" que corresponde al nuevo KeyStore que se usará en la aplicación.

Paso 2Una vez creado el KeyStore hay que crear un CSR (Certificate Signing Request o Requerimiento de forma del certificado) para enviar al CA.keytool -certreq -keyalg RSA -alias vtol -file certreq.csr -keystore synthesis.keystore -storepass changeitEste comando generará un archivo llamado " " que será requerido por la CA.certreq.csr

Paso 3Una vez que la CA generó el certificado digital hay que incorporarlo al KeyStore previamente creado.Para ello ejecutar el siguiente comando:

Nota: Cambiar la clave "changeit" del KeyStore

1. 2. 3.

keytool -import -alias vtol -keystore synthesis.keystore -storepass -trustcacerts -file changeit certificado.cerDonde "certificado.cer" corresponde al nombre del certificado otorgado por la CA.

Paso 4Ubicar el archivo "synthesis.keystore", correspondiente al nuevo KeyStore, dentro de:{WILDFLY_HOME}/rsvtol/configurationLuego abrir el archivo:Jboss/rsvtol/configuration/standalone.xmlY configurar:<security-realm name="ApplicationRealm"><server-identities><ssl><keystore path="synthesis.keystore" relative-to="jboss.server.config.dir" keystore-password=" " key-password=" " generate-self-signed-certificate-host="localhost"/>changeit changeit</ssl></server-identities><authentication><local default-user="$local" allowed-users="*" skip-group-loading="true"/><properties path="application-users.properties" relative-to="jboss.server.config.dir"/></authentication><authorization><properties path="application-roles.properties" relative-to="jboss.server.config.dir"/></authorization></security-realm>donde:

changeit – corresponde a la contraseña utilizada en el paso 1

9. Inicio de la aplicaciónPara iniciar RS VTOL CR/DB como :proceso, se deben seguir los siguientes pasos

Iniciar sesión en el sistema operativoIngresar a la carpeta WILDFLY_HOME\rsvtol\binEjecutar uno de los siguientes archivos según el sistema operativo:

start.cmd (Windows)start.sh (Linux)

Donde WILDFLY_HOME corresponde a la ruta de instalación de Wildfly.

10. Configuración

En esta sección se presentan todas las variables de configuración de RS-VTOL CR/DB CL. Por cada variable se indica:

Su nombreTipoDescripciónSi el sistema debe o no ser reiniciado para que la modificación tenga efecto.

Estas variables son configurables a través de la página de configuración presente en la consola de administración WEB del producto. Para lograr el logueo en la consola de administración, se deberá utilizar el usuario por default que viene precargado en el sistema. Los datos de logueo son los siguientes:

Nombre de usuario: suserClave de acceso: suser123

Para acceder a la consola WEB referirse al " " o bien acceder utilizando el siguiente enlace:VTOLCR-DB-Manual de usuario

:// :PORT/rs-consolehttp IP-SERVER

Donde:

IP-SERVER: corresponde a la dirección IP o nombre del server donde se está ejecutando el servidor VTOLPORT: corresponde al puerto del servidor web utilizado por VTOL

Al ingresar por primera vez a la consola de administración, se solicitara el cambio de la clave del usuario suser para que ya sea parametrizada por el administrador del sistema.Una vez logueado en el sistema, se deberá ingresar en "Configuración" dentro del menú "Herramientas Administrativas", tal como se muestra en la siguiente figura:

10.1 Configuración de variables del Sistema

La primera variable a configurar es la que se lista a continuación. La misma permite continuar la carga del sistema en su totalidad. De encontrarse en False, algunos de los componentes del sistema no podrán operar.

Nombre variable o propiedad Tipo Descripción ¿Requiere reiniciar?

VTOL Core habilitado True / false De encontrarse en false, al iniciarse VTOL CR / DB no se levantarán las reglas de negocio pero sí la consola. Se emplea en los casos de actualización del sistema, cuando se incorporan nuevas propiedades de configuración a la aplicación. En este escenario la propiedad se encuentra en false y una vez que se terminaron de configurar las nuevas propiedades, se cambia su valor a true para que VTOL CR / DB levante por completo.

SI

A continuación, se listan más propiedades disponibles para configurar en el sistema. Para más información de configuración referirse al " " de la aplicación.Manual de usuario

Nombre propiedad Tipo Descripción ¿Requiere reiniciar?

Dialecto de hibernate Cadena de caracteres. Idioma de SQL usado por hibernate para comunicarse a la base de datos.

SI

Ruta del log de negocio de VTOL CR/DB Cadena de caracteres Ruta del archivo log en el cual se registran las acciones de negocio ejecutadas por el módulo VTOL CR/DB

NO

Adiciona contenido en log de negocio de VTOL CR/DB True / false Si se encuentra en false (desactivado), al reiniciarse VTOL se sobrescribirá el archivo log activo. Si se encuentra en true (activado), se continuará la escritura en el archivo log activo sin sobrescribir los contenidos previos. Esta configuración aplica al archivo log que registra las acciones de negocio del módulo VTOL CR/DB.

NO

Tamaño máximo del log de negocio de VTOL CR/DB Entero Tamaño máximo del archivo de logueo. Superado este tamaño se crea un nuevo archivo. Esta configuración aplica al archivo log que registra las acciones de negocio del módulo VTOL CR/DB.

NO

Tamaño máximo de índice del log de negocio de VTOL CR/DB

Entero Cantidad de archivos de logueo que se mantienen. Superada esta cantidad, el nuevo archivo generado sobrescribirá al más antiguo. Esta configuración aplica al archivo log que registra las acciones de negocio del módulo VTOL CR/DB.

NO

Ruta del log de la consola Cadena de caracteres NO

Ruta del archivo log en el cual se registran las acciones vinculadas a la consola del producto.

Adiciona contenido en log de la consola True / false Si se encuentra en false (desactivado), al reiniciarse VTOL se sobrescribirá el archivo log activo. Si se encuentra en true (activado), se continuará la escritura en el archivo log activo sin sobrescribir los contenidos previos. Esta configuración aplica al archivo log de la consola de VTOL.

NO

Tamaño máximo del log de la consola Entero Tamaño máximo del archivo de logueo. Superado este tamaño se crea un nuevo archivo. Esta configuración aplica al archivo log de la consola de VTOL.

NO

Tamaño máximo de índice del log de la consola Entero Cantidad de archivos de logueo que se mantienen. Superada esta cantidad, el nuevo archivo generado sobrescribirá al más antiguo. Esta configuración aplica al archivo log de la consola de VTOL.

NO

Timeout para eco Entero Tiempo de espera máximo en milisegundos para la recepción de la respuesta de un mensaje de eco.

NO

Timeout para autorización Entero Tiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización.

NO

Depuración información de operación de VTOL CR/DB habilitada

True / false Habilita  (true)/ Deshabilita (false) la depuración de las transacciones de las tablas de operación de la aplicación.

NO

Días conservación de información de operación de VTOL CR/DB

Entero Cantidad de días que se desea mantener la información de transacciones en las tablas de operaciones antes de ser depuradas.

NO

IP del CA XX[1] Cadena de caracteres Dirección IP del centro autorizador. SI

Puerto de comunicación CA XXX Entero Puerto del centro autorizador por el cual se establecerá la comunicación.

SI

Generación de interfaz por fecha habilitada True / false Indica si las interfaces se generan o no por fecha. NO

VTOL Core habilitado True / false De encontrarse en false, al iniciarse VTOL CR / DB no se levantarán las reglas de negocio pero sí la consola. Se emplea en los casos de actualización del sistema, cuando se incorporan nuevas propiedades de configuración a la aplicación. En este escenario la propiedad se encuentra en false y una vez que se terminaron de configurar las nuevas propiedades, se cambia su valor a true para que VTOL CR / DB levante por completo.

SI

Puerto de comunicación no encriptada POS - VTOL Entero Puerto para la comunicación sin encriptar entre el POS y VTOL CR / DB.

SI

Comunicación no encriptada  POS - VTOL habilitada True / false Indica si se encuentra habilitada la comunicación no encriptada entre el POS y VTOL CR / DB.

SI

Puerto de comunicación encriptada POS - VTOL Entero Puerto para la comunicación encriptada entre el POS y VTOL CR / DB

SI

Comunicación encriptada POS-VTOL habilitada True / false Indica si se encuentra habilitada la comunicación encriptada entre el POS y VTOL CR / DB.

SI

Ruta del log del sistema Cadena de caracteres Ruta del archivo log en el cual se registra el estado del sistema.

NO

Adiciona contenido en log del sistema True / false Si se encuentra en false (desactivado), al reiniciarse VTOL se sobrescribirá el archivo log activo. Si se encuentra en true (activado), se continuará la escritura en el archivo log activo sin sobrescribir los contenidos previos. Esta configuración aplica al archivo log del sistema.

NO

Tamaño máximo del log del sistema Entero Tamaño máximo del archivo de logueo. Superado este tamaño se crea un nuevo archivo. Esta configuración aplica al archivo log del sistema.

NO

Tamaño máximo de índice del log del sistema Entero Cantidad de archivos de logueo que se mantienen. Superada esta cantidad, el nuevo archivo generado sobrescribirá al más antiguo. Esta configuración aplica al archivo log del sistema.

NO

Timeout de respuesta de transacción Entero Tiempo de espera máximo en milisegundos para la recepción de la respuesta de la transacción. Se refiere a la respuesta que envía el módulo al componente Core de VTOL.

NO

Largo del código de caja Entero Longitud del código que identifica a una caja (punto de venta) en VTOL CR / DB. Tener en cuenta que si el valor de esta propiedad se modifica existiendo ya cajas cargadas en la base de datos nodos, VTOL CR / DB no será capaz de identificar a las mismas. Una vez definida no se recomienda cambiarla.

NO

Largo del código de local Entero Longitud del código que identifica a un local en VTOL CR / DB. Tener en cuenta que si el valor de esta propiedad se modifica existiendo ya locales cargados en la base de datos nodos, VTOL CR / DB no será capaz de identificar a los mismos. Una vez definida no se recomienda cambiarla.

NO

Código de local es numérico True / false Indica si el código de local es numérico (true) o alfanumérico (false)

NO

Código de caja es numérico True/ false Indica si el código de caja es numérico (true) o alfanumérico (false)

NO

Algoritmo de encriptación de la comunicación Cadena de caracteres con los valores DES / DESede Algoritmo de encriptación empleado en la comunicación POS - VTOL. Las dos opciones posibles son: DES y DESede

NO

Clave algoritmo de encriptación de la comunicación Cadena de caracteres. Clave empleada para el algoritmo de encriptación de la comunicación POS - VTOL

NO

Algoritmo de desencriptación de la comunicación Cadena de caracteres con los valores DES / DESede Algoritmo de desencriptación empleado en la comunicación POS - VTOL. Las dos opciones posibles son: DES y DESede

NO

Clave algoritmo de desencriptación de comunicación Cadena de caracteres. Clave empleada para el algoritmo de desencriptación de la comunicación POS -VTOL

NO

Umbral de inactividad de local Numérico Umbral, expresado en milisegundos, que indica el tiempo máximo tolerable sin que VTOL reciba transacciones de un local. Superado este umbral el local se considera inactivo.

NO

Todos los números de comercio son requeridos True/False De encontrarse activado (true) indica que se requiere ingresar todos los números de comercio para cada local dado de alta.

NO

MailManager Servidor SMTP Cadena de caracteres Dirección IP o nombre del servidor SMTP para envío de mails.

NO

Tiempo entre envíos de Echos Numérico Tiempo que indica cada cuantos segundos se debe enviar un Echo.

NO

Terminal Id. para el envío de Echos Cadena de caracteres. Identificador de Terminal asignado a VTOL para el envio de Echos.

NO

Tiempo máximo de espera para la respuesta a un mensaje de Echo

Numérico Tiempo máximo de espera en segundos para la respuesta a un mensaje de Echo.

NO

Tiempo máximo de espera para la respuesta a un mensaje SPDH Financiero

Numérico Tiempo máximo de espera en segundos para la respuesta a un mensaje SPDH Financiero.

NO

Código de Transbank en el campo TPDU Numérico Código de origen/destino de Transbank en el campo TPDU.

NO

SSL: Puerto de comunicación SSL/TLS POS-VTOL Entero Puerto para la comunicación SSL/TLS entre el POS  y VTOL

SI

SSL: Comunicación SSL/TLS POS – VTOL habilitada True/False Indica si se encuentra habilitada la comunicación SSL/TLS  entre el POS y VTOL

SI

SSL: Almacén de certificados del servidor Cadena de caracteres Ruta del archivo que contiene los certificados del servidor para la comunicación segura SSL/TLS entre el POS  y VTOL. REQUERIDO

SI

SSL: Contraseña del almacén de certificados del servidor

Cadena de caracteres Contraseña de acceso al archivo que contiene los certificados del servidor para la comunicación segura SSL/TLS entre el POS y VTOL. REQUERIDO

SI

SSL: Tipo de almacén de certificados del servidor Cadena de caracteres Indica el tipo  de almacén de certificados del servidor. Por ejemplo: JKS. REQUERIDO

SI

SSL: Algoritmo del manejador del almacén de certificados del servidor

Cadena de caracteres Algoritmo del manejador del almacén de certificados del servidor. Por ejemplo: SunX509. REQUERIDO

SI

SSL: Almacén de confianza del servidor Cadena de caracteres Ruta del archivo que contiene los certificados de confianza del servidor para la comunicación segura SSL/TLS entre POS y VTOL. Requerido si esta activa la validación cliente

 

SSL: Contraseña del almacén de confianza del servidor

Cadena de caracteres Contraseña de acceso al archivo que contiene los certificados de confianza del servidor para la comunicación segura SSL/TLS entre POS y VTOL. Requerido si esta activa la validación cliente.

SI

SSL: Tipo de almacén de confianza del servidor Cadena de caracteres Indica el tipo de almacén de certificados de confianza del servidor. Por ejemplo: JKS. Requerido si esta activa la validación cliente.

SI

Cadena de caracteres SI

1. 1.

1. 2. 3.

2. 2. 3.

1.

SSL: Algoritmo del manejador del almacén de  confianza del servidor

Algoritmo del manejador del almacén de certificados de confianza del servidor. Por ejemplo: SunX509.

SSL: Protocolo SSL/TLS Cadena de caracteres Implementación de protocolo SSL/TLS. Nota: la versión la define el cliente (handshake). El server solo indica la máxima soportada. JAVA 8[TLSv1.2,TLSv1.1,TLSv1,SSLv3] JAVA 7[TLSv1.2,TLSv1.1,TLSv1,SSLv3] JAVA 6[TLS v1.1(from 111),TLSv1,SSLv3]

SI

SSL: Paquetes de cifrados habilitados Cadena de caracteres Lista de paquetes de cifrados que estarán habilitados en la comunicación SSL/TLS. Vacío toma los soportados por la JVM. Lista separada por coma y espacio

SI

SSL: Requiere autenticación del cliente True/False Indica si obliga al cliente a autenticarse/validarse con un certificado. De ser verdadero, el cliente deberá tener un certificado validado por una entidad certificante reconocida y cargada en el almacén de certificados (trustStore) del server

SI

 XX hace referencia al nombre del centro autorizador.

10.2 Administración de usuarios para acceso administrativo WEB

Para el acceso a la consola de administración vía WEB, se debe poseer un usuario y una contraseña válidos y otorgados por el administrador del sistema.Entonces para poder crear cuentas del sistema se debe:

Iniciar sesión en la consola de administración web.El usuario debe tener los siguientes permisos

"Acceso a la aplicación""Acceso a la consola de Administración de Usuarios, grupos y roles""Creación, modificación y eliminación de usuarios, grupos y permisos"

Referirse al capítulo 10. Acceso administrativo a VTOLIr a la sección "Seguridad > Usuarios"Administrar las cuentas de usuarios

A continuación se muestra una figura de la pantalla de administración de cuentas

Para más información sobre cómo realizar esta tarea, verificar los capítulos " " y " " del documento " ". usuarios GRUPOS VTOL-CORE-Manual de usuario.pdf

Nota: El sistema por defecto está configurado siguiendo las mejoras prácticas de la normas PCI.

11. Recomendaciones

11.1 Auditoria

VTOL CR / DB, por razones de seguridad, provee auditoría de todas las acciones que se efectúan a través de la consola del producto. Por medio de esta funcionalidad es posible conocer qué operaciones fueron efectuadas, fecha y hora de su realización, así como también los usuarios que las realizaron.Se sugiere a los correspondientes administradores activar la funcionalidad de logueo adecuada en el motor de base de datos / sistema operativo que permita conocer las acciones significativas que se realicen por medio de los mismos, con la finalidad de reforzar la seguridad de los datos manejados por VTOL.