Image Removed Image Added

VTOL CD AR - Guía de

...

implementación 3.8.0.

...

X 

...

Âncora
_Ref402522277 _Ref402522277

Âncora
_Ref402522280 _Ref402522280

Âncora
_Ref402522282 _Ref402522282

Âncora
_Ref402522285 _Ref402522285

Âncora
_Ref402522287 _Ref402522287

Âncora
_Ref402522290 _Ref402522290

Âncora
_Ref402522296 _Ref402522296

Âncora
_Ref402522302 _Ref402522302

Âncora
_Toc492667791 _Toc492667791

1. Objetivo

...

El producto VTOL está formado por dos componentes:

• VTOL ServerVTOL Client
• EMV Kit

Âncora
_Toc492667797 _Toc492667797

4.1.1 VTOL Server

...

Arquitectura de VTOL Server

Âncora
_Toc492667798 _Toc492667798

4.1.2

...

EMV KIT

EMV KIT 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. Los datos que captura son los siguientes:

...

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, devolución, anulación, etc.

Arquitectura de VTOL ClientEMV KIT

Âncora
_Toc165205630 _Toc165205630

Âncora
_Toc492667799 _Toc492667799

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 implementación, los requerimientos de hardware y software, las propiedades a ser configuradas como así también todos los aspectos necesarios para cumplir con el estándar de seguridad PA-DSS.
En caso de que sólo desee instalar VTOL Server, omitir los apartados que hacen referencia a VTOL ClientEMV KIT.

Âncora
_Toc492667800 _Toc492667800

4.3 Recomendaciones

Se recomienda recomienda una lectura inicial de todo el documento antes de comenzar con el procedimiento de implementación de la aplicación.
Además es recomendable tener los conocimientos mínimos del software de base requerido por VTOL para una mejor comprensión de los temas tratados en este documento.

...

...

4.4 Flujo de implementación

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

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

...

1. requisitos del sistema

...

1. )
   
   
2. Efectuar la instalación completa mediante el asistente gráfico de instalación (apartado 7.1.1 Instalación de cero de VTOL 3.8)
   
   
3. Crear la base de datos y ejecutar los script de base de datos (apartado 7.3.1 Creación de la base de datos)
   
   
4. Iniciar VTOL Server como proceso o servicio (apartado 9.1 Iniciar / detener la aplicación VTOL Server)
   
   
5. Acceder a la consola web de administración (apartado 10. Acceso administrativo a VTOL)
   
   
6. Iniciar sesión en la consola web de administración (apartado 11.1 Primer inicio de sesión)
   
   
7. Configurar las propiedades y las variables iniciales que utilizará VTOL, como por ejemplo "VTOL Core Habilitado" (apartado 11.2 Configuración de la aplicación VTOL)
   
   
8. Administrar la seguridad del usuario (apartado 12.1 Administración de usuarios para acceso administrativo WEB)

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

Âncora
_Pre-Requisitos_del_sistema _Pre-Requisitos_del_sistema

Âncora
_Toc492667801 _Toc492667801

5. Pre-Requisitos del sistema

Âncora
_Toc492667802 _Toc492667802

5.1 VTOL Server

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

...

• Windows 32/64 bits
  • Windows 7 o superior
  • Windows Server 2012 R2 o superior
• Linux 32/64 bits
  • Cent OS v7 o superior

Âncora
_Toc492667804 _Toc492667804

5.1.2 Requerimientos de Hardware

• Memoria RAM
  • VTOL Engine: 2GB (mínimo disponible para la aplicación)
  • VTOL Admin: 2GB (mínimo disponible para la aplicación)
• CPU: cuádruple procesador de al menos 2.6 GHZ
• Capacidad de almacenamiento en Disco Rígido: 20GB o superior
• 1 placa de red de 100Mb o 2 placas de red de 100Mbits para instalación en clúster

Âncora
_Toc146017792 _Toc146017792

Âncora
_Toc165205634 _Toc165205634

Âncora
_Toc492667805 _Toc492667805

5.1.3 Requerimientos de Software

• Java Virtual Machine (JDK) 1.8.x (32/64bits acorde al SO)
  • Link de descarga: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
• Servidor de aplicaciones: J2EE Compliant. Debe encontrarse instalado JBoss Wildfly 1018.0.1.0
• Motor de base de datos:
  • MS SQL Server 2012 Service Pack 3 o superior
  • Oracle 11.2 o superior
  • DB2 9.5 o superior

...

Âncora
_Toc492667806 _Toc492667806

5.2

...

EMV KIT

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

Âncora
_Toc492667807 _Toc492667807

5.2.1 Plataformas Soportadas

• Windows 32/64 bitsLinux 32/64 bits
• Linux CentOS 7

Âncora
_Toc492667808 _Toc492667808

5.2.2 Requerimientos de Hardware

• Memoria RAM: 64MB disponibles
• CPU: 2 núcleos de 1.6 GHZ o superiornúcleos de 1.6 GHZ o superior (sujeto a pruebas ya que hay dependencias de arquitecturas de hardware, por ejemplo, pudiera funcionar con 1 núcleo pero más potente)
• Capacidad de almacenamiento en Disco Rígido: 150MB o superior

...

• Java Virtual Machine (JDK) 1.6.x/1.7.x/ 1.8.x (32/64 bits acorde con el sistema operativo)
• Conexión a VTOL Server por red TCP/IP

...

Los indicadores del tipo señalan un componente determinado dentro del diagrama.
Los indicadores del tipo señalan la secuencia de una autorización normal de una transacción de venta que involucra datos de tarjeta de crédito/débito.
Como se observa en la figura, VTOL está instalado de forma centralizada dentro de la red DMZ. Los puntos de venta están instalados en las sucursales de la empresa comunicándose con VTOL mediante el protocolo TCPIP, en cada punto de venta se encuentra VTOL ClientEMV KIT. Éste luego se comunica con los centros autorizadores o Cas mediante una red MPLS (ésta podrá variar según normativa de los mismos).
A continuación se explica en forma de caso de uso los flujos de datos que suceden en el esquema general de red, el mismo sirve para todos los tipos de transacciones: venta, devolución, anulación, etc.

...

Hay otros datos que se transmiten (como ser el monto, las cuotas, etc) pero no son sensibles.
Como se observa, los datos requieren si o si ser trasmitidos de forma segura y encriptados, sobre todo, en caso de estar posicionados en una red pública.
La aplicación predeterminada utiliza la comunicación SSL para el intercambio de información entre EMV KIT y VTOL Client y VTOL Server. Es necesario configurar el keystore durante la instalación. Visite la sección "7.4 Instalación de certificados para el protocolo HTTPS".

...

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

Âncora
_Base_de_datos_1 _Base_de_datos_1

Âncora
_Configuración_de_la _Configuración_de_la

Âncora
_Toc492667833 _Toc492667833

Âncora
_Toc165205640 _Toc165205640

7.3 Configuración de la base de datos

Los scripts, para crear e inicializar la base de datos que emplea la aplicación, se encuentran en la carpeta "scripts" dentro del directorio de instalación del producto. Los scripts se encuentran separados en carpetas según el motor de base de datos al que corresponden y se deben ejecutar en una secuencia determinada según sea necesario crear o actualizar una base de datos de VTOL.
En las siguientes secciones se explica con mayor detalle cada una de las posibilidades.

Âncora
_Creación _Creación

Âncora
_Toc492667834 _Toc492667834

7.3.1 Creación

Los scripts de base de datos existentes deberán ser ejecutados, con el usuario administrador de base de datos.
Cada archivo contiene, como inicio de su nombre, un número que indica la secuencia en que debe ser corrido.
Los scripts se encuentran ubicados en la ruta Jboss/rsvtol/dist/scripts.
Primero se deben ejecutar los script de VTOL CORE, ubicados en:
Jboss/rsvtol/dist/scripts/core/nombreMotorBD
, en el siguiente orden:

1. "1-CONSOLE-SCHEMA.sql"
2. "2-CORE-SCHEMA.sql"
3. "3-CORE-POPULATE.sql"

Por último, se deben ejecutar los scripts del módulo Crédito Débito, ubicados en
Jboss/rsvtol/dist/scripts/cd-ar/nombreMotorBD
, en el siguiente orden:

1. "1-CD-AR-SCHEMA.SQL"
2. "2-CD-AR-POPULATE.SQL"

Dónde:

• rsvtol
  • es el directorio dentro del Jboss donde se instalaron los componentes de VTOL.
• nombreMotorBD
  • corresponde al nombre del motor de base de datos
    • mssql – Motor de base de datos MS SQL Server
    • oracle – Motor de base de datos Oracle
    • db2 – Motor de base de datos DB2

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.

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

Âncora
_Actualización _Actualización

Âncora
_Toc492667835 _Toc492667835

7.3.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-1.1.0-TO-1.1.1.sql"
Los mismos se encuentran en los siguientes directorios:
Scripts correspondientes a VTOL CORE
{VTOL_Server}/dist/scripts/core/nombreMotorBD
Scripts correspondientes a Módulo Crédito Débito
{VTOL_Server}/dist/scripts/cd-ar/nombreMotorBD
Dónde:

• {VTOL_Server}
  • es el directorio donde se instalaron los componentes de VTOL
• nombreMotorBD
  • corresponde al nombre del motor de base de datos
    • mssql – Motor de base de datos MS SQL Server
    • oracle – Motor de base de datos Oracle
    • db2 – Motor de base de datos DB2

La secuencia de ejecución estará asociada a la versión actual de VTOL (para saber que versión está instalada ver apartado 17.3 Obtención de la versión de VTOL instalada).
Es decir se deberán correr los scripts incrementales comprendidos entre el número de versión instalada y la que deseamos instalar. A continuación se muestra un ejemplo:
INC-3.7.3.3-TO-3.7.3.5.sql
INC-3.7.3.5-TO-3.7.3.6.sql
INC-3.7.3.6-TO-3.7.3.7.sql
INC-3.7.3.7-TO-3.8.0.0.sql
Los script enumerados anteriormente deben ejecutarse para actualizar la versión 3.7.3.3 a la 3.8.0.0.

Âncora
_Instalación_de_certificado _Instalación_de_certificado

Âncora
_Toc492667836 _Toc492667836

7.4 Instalación de certificado para protocolo HTTPS

El 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.

Âncora
_Toc492667837 _Toc492667837

7.4.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):

• TLSv1.1
• TLSv1.2 (recomendado y por defecto en la aplicación)

Por lo tanto se aconseja usar TLSv1.2.

Âncora
_Toc492667838 _Toc492667838

7.4.2 Uso de certificados

...

Se mencionan los números de puertos que se utilizan en un entorno VTOL:

• POS - VTOL ClientEMV KIT: 3500 (VTOL Client EMV KIT escucha ese puerto)
• VTOL Client EMV KIT - VTOL Server: 3000 (VTOL server escucha ese puerto con conexión SSL)
• VTOL Server - Base de datos: 1433
• VTOL Server - Autorizador / Procesador de pago: Los puertos son dinámicos y el Autorizador puede cambiarlo. Por defecto son:
  • AMEX: 7894
  • POSNET: 8888
  • Visa: 7777
  • Shopping: 5555
  • General Electric: 5979
• Consola VTOL - Base de datos: 1433 (Es el mismo de VTOL Server - Base de datos)
• Consola VTOL - Usuario: 8443 (https) puerto de acceso a la consola web

Âncora
_Toc492667845 _Toc492667845

8. Instalación de

...

EMV KIT

EMV KIT posee la siguiente estructura de directorios:

...

Âncora
_Toc492667846 _Toc492667846

8.1 Configuración de

...

EMV KIT

Para que VTOL Client EMV KIT funcione correctamente se deben configurar los siguientes archivos:

...

Âncora
_Toc492667851 _Toc492667851

9.2

...

EMV KIT

Una vez configurado VTOL ClientEMV KIT, se debe iniciar. Este componente puede ser iniciado de dos maneras:

• Como proceso
• Como servicio (recomendado)

Âncora
_Toc492667852 _Toc492667852

9.2.1 Iniciar

...

EMV KIT como proceso

Para iniciar VTOL Client como EMV KIT como proceso, ejecutar uno de los archivos start.cmd (Windows) o start.sh (Linux).

Âncora
_Toc492667853 _Toc492667853

9.2.2 Iniciar

...

EMV KIT como servicio

Para realizar esta instalación se utiliza una herramienta llamada WRAPPER. La misma se obtiene desde aquí:
http://wrapper.tanukisoftware.com/doc/english/download.jsp
Su configuración es símil a lo descrito en el apartado "9.1.2 Iniciar/Detener VTOL Server como servicio".

...

11.3.2 Depuración de datos a través de un SP en Base de Datos

Funcionalidad que realiza una actualización de la depuración de VTOL Crédito Debito que permite invocar un Procedimiento Almacenado en la Base de Datos.

Se ha detectado que bajo ciertas condiciones de carga, el proceso de depuración no se ejecuta según lo esperado, demorando mayor cantidad de tiempo de lo permitido y generando entonces que culmine con una excepción que implica no confirmar los datos depurados.

Esta funcionalidad modifica el proceso de depuración para que se ejecute realizando "n" ciclos, dónde cada uno depura y confirma una cantidad de transacciones predefinidas, permitiendo incluso generar la depuración total en sucesivas ejecuciones del proceso.

Para acceder al detalle de la configuración del proceso de depuración por SP, ingresar a las notas del release 3.8.0.2

Âncora
_Toc492667861 _Toc492667861

12. Administración de usuarios y claves de la aplicación

...

2014-10-10 13:44:16,351
DEBUG vtol Vtol
ReverseSenderProcess #Reverse: 0 Excluded terminals in process: []
2014-10-10
13:44:17,126 INFO communication RSFMK.AsyncCommWorker-4 CrDb
Thread: RSFMK.AsyncCommWorker-4: MONITOR: DISCONNECTED
2014-10-10
13:44:17,205 INFO communication RSFMK.AsyncCommWorker-2 CrDb
Thread: RSFMK.AsyncCommWorker-2: MONITOR: DISCONNECTED
2014-10-10
13:44:17,220 INFO communication RSFMK.AsyncCommWorker-1 CrDb
Thread: RSFMK.AsyncCommWorker-1: MONITOR: DISCONNECTED
2014-10-10
13:44:17,266 INFO communication Temp_RSFMK.AsyncCommWorker-2 CrDb
Thread: Temp_RSFMK.AsyncCommWorker-2: MONITOR: DISCONNECTED
2014-10-10
13:44:17,266 INFO communication RSFMK.AsyncCommWorker-3 CrDb
Thread: RSFMK.AsyncCommWorker-3: MONITOR: DISCONNECTED
2014-10-10
13:44:17,376 INFO communication Temp_RSFMK.AsyncCommWorker-1 CrDb
Thread: Temp_RSFMK.AsyncCommWorker-1: MONITOR: DISCONNECTED
2014-10-10
13:44:17,376 INFO communication
RSFMK.AsyncCommWorker-5 CrDb Thread: RSFMK.AsyncCommWorker-5: MONITOR:
DISCONNECTED
2014-10-10
13:44:18,139 ERROR communication
RSFMK.AsyncCommWorker-4 Connect failed:
ProvencredClientCommunication(127.0.0.1:66660). Retry is set forever. Error
Message: Connection refused: connect

...

...

Quien inicia el flujo es el punto de venta o POS cuando una venta se decide pagar con tarjeta de crédito o débito. En tal caso, la aplicación de punto de venta, inicia una transacción (venta, anulación, devolución) en VTOL ClientEMV KIT.
VTOL ClientEMV KIT, a través del Pinpad, captura los datos de la tarjeta de crédito/débito. El ingreso de los datos se podrá hacer por chip, banda magnética o manual.
Dependiendo el modo de ingreso de la tarjeta, se solicitarán ingresar uno u otros datos propios de la tarjeta, como ser el código de seguridad, la fecha de vencimiento, etc.
Una vez que VTOL Client EMV KIT haya capturado todos los datos del tarjetahabiente, se procede a enviar la transacción de autorización a VTOL Server. La transacción de autorización tendrá asociado un tipo de transacción (venta, devolución, anulación) el cual dependerá del tipo de acción que se realice en el punto de venta.
VTOL Server, al recibir los datos, valida que los mismos sean correctos para el tipo de transacción seleccionada por el POS. Si algún dato es inválido, VTOL Server finaliza la transacción y devuelve el control al POS indicando el error.
Si los datos son correctos, se procede a la ejecución de las reglas de negocio asociadas al tipo de transacción y posterior autorización de la transacción con el centro autorizador correspondiente (Visa, Amex, etc.).
Entre las reglas de negocio que se ejecutan se encuentran las siguientes:

...

Si las reglas de negocio son correctas, entonces se envía la autorización al centro autorizador correspondiente.
Una vez que se recibe la autorización, la misma junto con los datos originales se graban en la base de datos de VTOL Server. Es importante mencionar que el único dato que se conserva es el PAN del tarjetahabiente y que este es almacenado de manera cifrada, utilizando algoritmos de encriptación sólidos.
Finalizada la misma, se responde a VTOL Client los EMV KIT los datos de autorización.
El POS procede a imprimir el voucher de la tarjeta quién da por finalizada la transacción, lo que implica enviar un mensaje adicional a VTOL Server indicando que la transacción ha finalizado (tercer mensaje: commit).
Si por una cuestión particular la transacción falla, por ejemplo no se puede imprimir voucher, entonces el POS envía un mensaje adicional a VTOL Server indicando que la transacción ha fallado y se debe deshacer (tercer mensaje: rollback). En este caso VTOL Server inicia un proceso donde deshace la transacción realizada anteriormente.

...