KIOSCOS

Scotiabank Costa Rica

MANUAL DE INSTALACION
Junio 2017

Preparado por:

Gerencia de Plataforma Local

El Salvador
a) CREACIÓN Y CONFIGURACIÓN DE COLAS EN SERVIDOR DE AUTORIZADOR:

Crear y configurar las colas de mensajes KIOSCOS_REQUESTCR,

KIOSCOS_RESPONSECR y MTKIOSCOS_LOGCR

Pasos a seguir:

1. Ingresar a la opcion Computer Management.

Figura 1. Interfaz de administración del servidor.

2. Dar clic derecho en Message Queuing y luego en Properties.

Figura 2. Opción para configuración de cola de mensajes.

3. Luego en la pestaña Server Security marca las opciones que se muestra en la
siguiente imagen y luego dar clic en OK.

Figura 3. Propiedades de configuración de la cola de mensajes.

4. Para la creación de una cola dar clic derecho sobre en Private Queues, luego
seleccionar New y posteriormente dar clic en Private Queue.

Figura 4. Configuración de cola privada de mensajes

5. Luego ingresamos el nombre de la cola (en mayúsculas) y damos clic en el botón
OK.

Figura 5. Especificación del nombre de cola privada.

6. Posteriormente dar clic derecho a la cola (KIOSCOS_REQUESTCR) y damos clic

en Properties.

Figura 6. Selección de opción Properties para configuración de cola privada de mensajes.

7. Procedemos a dar permisos de Full Controll al usuario “Everyone”.

Figura 7. Asignación de permiso sobre cola de mensaje a grupo de usuarios Everyone.

8. Luego damos permisos de Full Controll al usuario “ANONYMOUS LOGON”.

Figura 8. Especificación de permisos sobre grupo de usuarios Anonymous Logon.

9. Repetir los pasos 4 -8 para crear las siguientes colas:
 KIOSCOS_REQUESTCR – Nombre de la cola de requerimientos.
 KIOSCOS_RESPONSECR – Nombre de la cola de respuestas.
 MTKIOSCOS_LOGCR – Nombre de cola para registro de log.
b) CONFIGURACION DE BASE DE DATOS
1. Descargar del TP físico T00544000CR-EJECUTABLES_S3 de Aldon LM el archivo
Scripts_Kioscos_CR.exe y ejecutarlo.
2. En la especificación de la Carpeta Destino de la pantalla emergente, introducir
C:\ScriptsKioscosCR.

Figura 1. Extracción de archivos considerados para la configuración de la base de datos

de KioscosCR.
3. Una vez descomprimidos los archivos, abrir el archivo comando.cmd y configurar
las variables siguientes acordes al ambiente de instalación:
Variables Descripción
servidor Servidor de base de datos donde se configurara la base de datos.
usrBd Usuario de base de datos con privilegios administrativos.
pwdBd Contraseña del usuario de base de datos arriba especificado
rutaMdf Ruta del archivo MDF de la base de datos. Ejemplo: C:\Program
Files\Microsoft SQL Server\MSSQL11.SQL_SALVADOR\MSSQL\DATA
rutaLdf Ruta del archivo LDF de la base de datos. Ejemplo: C:\Program
Files\Microsoft SQL Server\MSSQL11.SQL_SALVADOR\MSSQL\DATA

4. Guardar el archivo comando.cmd y abrir la ventana de comandos DOS con usuario

administrador.
5. Ejecutar el archivo comando.cmd, al finalizar solicitará presione una tecla para
salir. Luego borrar el directorio C:\ScriptsKioscosCR.

Figura 2. Ventana de comandos con la secuencia para creación de esquema de base de

datos
c) INSTALACIÓN DE APLICACIÓN WEB
1. Crear carpeta Kioscos.NET-CR en el directorio F:\, (o según país a implementar).
Dentro de esta, crear directorio app_data. En caso de existir dichas carpetas favor
obviar el presente paso.
2. Descargar del TP físico T00544000CR-EJECUTABLES_S3 de Aldon LM el archivo
Piezas_web.exe y ejecutarlo; introducir el directorio especificado en el paso anterior,
luego dar clic en el botón Extraer.

Figura 1. Especificación de ruta de destino de objetos de aplicación web

3. Ingresar al directorio arriba mencionado (Kioskos.NET-CR) y modificar las siguientes

variables de la sección appSettings del archivo web.config con base a la siguiente
información:
Variable Descripción Valor Sugerido
PeriodoInactividad Tiempo que el kioscos puede estar 180
inactivo antes de solicitar al cliente que
indique si necesita más tiempo.
PeriodoInactividadC Tiempo que tendrá el cliente para 10
onfirmar indicar que necesita más tiempo para
continuar usando el kiosco.
PeriodoInactividadP Tiempo que puede durar el Kiosco en la 30
ublicidad página de ingreso de usuarios antes de
irse a mostrar publicidad.
DuracionImagenPub Tiempo que estará la imagen de 8
licidad publicidad en la pantalla antes de pasar
a la siguiente.
kioWriteLogPath Carpeta en la cual se grabará el log de F:/Kioscos.NET-CR/app_data/
páginas. Debe incluir slash o back slash (o según ambiente de instalación)
al final
KIOSCOS_REQUE Nombre de la cola de requerimientos. "FORMATNAME:DIRECT=TCP:N
ST ombre_server\PRIVATE$\KIOSC
OS_REQUESTCR"
KIOSCOS_RESPO Nombre de la col de respuestas. "FORMATNAME:DIRECT=TCP:N
NSE ombre_server\PRIVATE$\
KIOSCOS_RESPONSECR"
TelefonoPais No. del teléfono del país que se esté Por definir
configurando.
 Y en el campo value de la sección <param name=”File”> en la línea 55, sustituir el
valor contenido por el siguiente: App_Data/KioscosCR.

Figura 2. Sección appSettings del archivo web.config.

4. Guardar los cambios y cerrar el archivo web.config.

5. Descargar del TP físico T00544000CR-EJECUTABLES_S3 de Aldon LM el archivo
comando_web.cmd. El archivo puede ser descargado en cualquier ruta del
computador.
6. Abrir con un editor de texto el archivo arriba especificado y configurar la variable
puerto conforme al ambiente de configuración (por defecto es 80) y el valor del atributo
/physicalPath por la ruta completa del directorio especificado en el paso 1 de la
presente sección.

Figura 3. Configuración de variable puerto y physicalPath del archivo comando_web.cmd. Por

defecto es el 80.
7. Iniciar la ventana de comandos DOS (comando CMD) con usuario administrador y
ejecutar el archivo comando_web.cmd para configurar la aplicación web en el IIS.

Figura 4. Configuración de sitio web de Kioscos en el IIS.

8. Al finalizar la ejecución, presionar cualquier tecla y cerrar la ventana de comandos.

d) INSTALACIÓN DE AUTORIZADOR DE KIOSKOS

1. Crear la carpeta \ServerKioscosCR y \logsKioscosCR en el directorio F: (o según
ambiente de instalación).
2. Descargar del TP físico T00544000CR-EJECUTABLES_S3 de Aldon LM el archivo
Piezas_autorizador.exe y ejecutarlo; en la pantalla emergente, especificar en el
campo Carpeta de destino la ruta de la carpeta \ServerKioscosCR arriba creada,
posteriormente dar clic en el botón Extraer.

Figura 1. Especificación de ruta de destino de objetos de archivo ejecutable de Kioscos.

3. Ingresar al directorio ServerKioscosCR y modificar el archivo

KioscosServer.exe.config:
 En la sección <appSettings> las variables que se detallan continuación:
Variable Descripción Valor
MTKIOSCOS_REQUEST Nombre de la “.\PRIVATE$\KIOSCOS_REQUESTCR”
cola de
requerimientos.
MTKIOSCOS_RESPONSE Nombre de la “.\PRIVATE$\KIOSCOS_RESPONSECR”
cola de
respuestas.
kioWriteLogPath Carpeta en la F:\logsKioscosCR\
cual se grabará (o según ambiente de instalación)
el log de
páginas.
AplicacionHost Nombre de la 10.235.28.146
aplicación que
se enviará en
los mensajes al
AS400.
UsuarioHost Usuario que se Usuario de conexión al AS400 del
enviará en los servidor arriba especificado
mensajes al
AS400.
TimeoutHost Tiempo que se 60
 Variable Descripción Valor
esperará por la
respuesta del
AS400.
AS400CriptografiaIP Dirección IP 10.235.28.146
del AS400 en
donde se
validará el PIN
y donde se
obtendrán las
llaves de
trabajo de los
kioscos.
AS400CriptografiaPuerto Puerto TCP/IP. 4339
AS400CriptografiaTimeout Tiempo que se 60
esperará por la
respuesta.
AS400ValidarTarjetaIP Dirección IP 10.235.28.146
del AS400
donde estará
corriendo el
programa que
regresa los
datos de la
tarjeta de
débito.
AS400ValidarTarjetaPuerto Puerto TCP/IP. 12095
AS400ValidarTarjertaTimeout Tiempo que se 30
esperará por la
respuesta.
Figura 2. Sección appSettings del archivo KioscosServer.exe.config.

Variable Descripción Valor

CountryCode Código de país Asignar según
país de
instalación de
acuerdo con el
listado siguiente:
PA=Panamá
CR=Costa Rica
LanguageCode Código del lenguaje Asignar “S” (de
Spanish)
[NOMBRE_SERVICIO]_Hdr_UsrId Id de usuario KIOUSR
[NOMBRE_SERVICIO]_Hdr_TrxId Id de transacción En blanco
[NOMBRE_SERVICIO]_Hdr_SrcApp Aplicación fuente KIOSCOSCR
[NOMBRE_SERVICIO]_Hdr_SrcServer Servidor fuente IP del servidor
donde se instala
la aplicación
web.
Figura 3. Variables relacionadas con configuración de parámetros de servicios web.
  Adicionar el siguiente fragmento antes de la etiqueta </appSettings>
<!-- Transferencia de fondos - ATR -->
<add key="FundTransfer_GlosaDebito" value="AL"/>
<add key="FundTransfer_GlosaCredito" value="AL"/>

<!-- Pago de tarjeta de credito - Abono tarjeta -->

<add key="CardPayment_Hdr_UsrId" value="CMS"/>
<add key="CardPayment_Hdr_TrxId" value="30020000000194075"/>
<add key="CardPayment_Hdr_SrcApp" value="ITB"/>
<add key="CardPayment_Hdr_SrcServer" value="wm42051"/>

<add key="CardPayment_transacctionCodeTsys" value="156590"/>

<add key="CardPayment_reasonTsys" value="1"/>
<add key="CardPayment_transactionCodeItp" value="1403"/>
<add key="CardPayment_codBranch" value="153"/>

<!-- Pago de tarjeta de credito - Cargo cuenta -->

<add key="CardPayment_CuentaContableCRC" value="1849910000000500"/>
<add key="CardPayment_CuentaContableUSD" value="1849920000000500"/>
<add key="CardPayment_GlosaDebito" value="AL"/>
<add key="CardPayment_GlosaCredito" value="AL"/>

<!-- Pago de prestamos -->

<add key="PagoPrestamo_GlosaDebito" value="AL"/>
<add key="PagoPrestamo_GlosaCredito" value="AL"/>

Y configurar los valores de dichas variables acordes a la siguiente

información:

Variable Descripción Valor

FundTransfer_GlosaDebito Código para “TK”
descripción de la
transacción
transferencia entre
cuentas
FundTransfer_GlosaCredito Código para “TK”
descripción de la
transacción
transferencia entre
cuentas
CardPayment_Hdr_UsrId Id del usuario KIOUSR
CardPayment_Hdr_TrxId Id de la transacción. En blanco
CardPayment_Hdr_SrcApp Aplicación fuente KIOSCOSCR
CardPayment_Hdr_SrcServer Servidor fuente IP del servidor donde
se instala la
aplicación web.
CardPayment_transacctionCodeTsys Código transacción PAYMT
tsys
CardPayment_reasonTsys En blanco
CardPayment_transactionCodeItp Código itp 0
CardPayment_codBranch Código de agencia 001
 Variable Descripción Valor
CardPayment_CuentaContableCRC Cuenta contable para 1849910000000500
abono de tarjeta de
crédito en CRC
CardPayment_CuentaContableUSD Cuenta contable para 1849920000000500
abono de tarjeta de
crédito en USD
CardPayment_GlosaDebito Código para 0S
descripción del pago
de tarjeta
CardPayment_GlosaCredito Código para 0S
descripción del pago
de tarjeta
PagoPrestamo_GlosaDebito Código para J9
descripción del pago
de préstamos.
PagoPrestamo_GlosaCredito Código para J9
descripción del pago
de préstamos.
Figura 4. Variables relacionadas con la configuración para conectividad con ATR

 Buscar la etiqueta xml <client> (dentro del archivo

KioscosServer.exe.config) y modificar los valores del atributo address, asi
como también el atributo name con el nombre del puerto correcto.
…
<endpoint address="http://localhost:8080/refdata/party/custprofile/newproductlistpaginationinq/v1.0"
binding="basicHttpBinding" bindingConfiguration="NewProductListPaginationInquiryBinding"
contract="NewProductListPagination.NewProductListPaginationInquiryPortType"
name="NewProductListPaginationInquiryPort" />
…

Para ello, buscar el binding asociado en el atributo bindingConfiguration y

mapear los valores name con el valor del nombre del puerto y el atributo
address con la URL del endpoint correspondiente, esto según cuadro abajo
especificado.

 Ambiente UAT

Binding PortName EndPoint URL

NewProductListInquiryBind NewProductListInquiryPo http://172.25.6.61:5007/refdata/party/custprofile/NewProductListI
ing rt nquiry/v1.0
NewProductListPaginationI NewProductListPaginatio http://172.25.6.61:5007/refdata/party/custprofile/NewProductListP
nquiryBinding nInquiryPort aginationInquiry/v1.0
RetailAccountDetailsInquir RetailAccountDetailsInqu http://172.25.6.61:5005/opsandexec/prodspecfullfmnt/loanandde
yBinding iryPort pos/curacct/RetailAccountDetailsInquiry/v1.0
DepositAccountTransactio DepositAccountTransacti http://172.25.6.61:5010/opsandexec/crossprodops/acctmgmt/pos
nHistoryInquiryBinding onHistoryInquiryPort keep/DepositAccountTransactionHistoryInquiry/v1.0
http://172.25.6.61:5005/opsandexec/prodspecfullfmnt/loanandde
TransferFundsBinding TransferFundsPort pos/curacct/TransferFunds/v1.0
TermDepositAccountDetail TermDepositAccountDet http://172.25.6.61:5005/opsandexec/prodspecfullfmnt/loanandde
sAndHistoryInquiryBinding ailsAndHistoryInquiryPort pos/curacct/TermDepositAccountDetailsAndHistoryInquiry/v1.0
LoanAccountDetailsAndHis LoanAccountDetailsAnd http://172.25.6.61:5010/opsandexec/crossprodops/acctmgmt/pos
toryInquiryBinding HistoryInquiryPort keep/LoanAccountDetailsAndHistoryInquiry/v1.0
 Binding PortName EndPoint URL
BalanceCardDataInquiryBi BalanceCardDataInquiry http://172.25.6.61:5001/opsandexec/prodspecfullfmnt/cards/card
nding Port billingandpmt/BalanceCardDataInquiry/v1.0
DayBalanceCardDataInqui DayBalanceCardDataInq http://172.25.6.61:5001/opsandexec/prodspecfullfmnt/cards/card
ryBinding uiryPort billingandpmt/DayBalanceCardDataInquiry/v1.0
GlobalTCMovementsInquir GlobalTCMovementsInqu http://172.25.6.61:5001/opsandexec/prodspecfullfmnt/cards/card
yBinding iryPort billingandpmt/GlobalTCMovementsInquiry/v1.0
ForeignExchangeRateInqui ForeignExchangeRateInq http://172.25.6.61:5006/opsandexec/prodspecfullfmnt/consmrervi
ryBinding uiryPort ces/curexc/ForeignExchangeRateInquiry/v1.0

 Modificar los valores de las propiedades Data Source, User Id y Password

de la sección connectiongStrings con base a los siguientes valores según
el ambiente de instalación y de acuerdo a solicitud de creación de usuario
especificada en documento BOM.
Propiedad Valor según ambiente
UAT PROD
Data Source 10.235.27.133 No definido al momento de
elaborar el presente documento.
Initial Catalog KioscosCR KioscosCR
User Id UsrKioscosCR UsrKioscosCR
Password [contraseña bd UAT] [contraseña bd PROD]

4. Incorporar la IP del servidor autorizador, según ambiente de instalación, y el canal

o nombre lógico que utilizará la aplicación en el AS/400:
 TBLAPLIC
 TBLIPADD
Es necesario subir y bajar el subsistema xxBNSON

Editar el archivo de configuración “services” que se encuentra ubicado en la carpeta

\ServerKioscosCR del servidor de autorizadores y sustituir el texto “ipsrv” por la ip de
AS/400 (Scotia Pro), según ambiente de instalación.

#** SERVICIOS RESUELTOS POR ATR-AS400. **

PAGOS ipsrv 49291 EDL519001 30 6 2

TRANSFER ipsrv 49291 ETF500001 30 6 2

Para el caso de UAT, sustituir el valor de ipsrv por el de 10.235.28.146.

5. Guardar el archivo KioscosServer.exe.config y el archivo services y cerrar el editor

de texto.
6. Ubicarse en la carpeta \ServerKioscosCR y crear el acceso directo en el escritorio
para el archivo: KioscosServer.exe
7. Crear la carpeta \ServidorLogKioscosCR en el directorio F:
8. Descargar del TP físico T00544000CR-EJECUTABLES_S3 de Aldon LM el
archivo Servidor_logs_kioscos.exe y ejecutarlo, en el campo Carpeta de destino
especificar el directorio arriba creado, posteriormente dar clic en el botón Extraer.
9. Ubicarse en la carpeta \ServidorLogKioscosCR y crear el acceso directo para el
archivo ServidorLogKioscos.exe con los siguientes valores:
En el target adicionar el parámetro –c
Target: ..\ServidorLogKioscosCR\ServidorLogKioscos.exe –c

Figura 5. Creación de acceso directo a autorizador de Kioscos Costa Rica.

El nombre a asignar a dicho acceso directo será ServidorLogKioscosCR

10. Ingresar al directorio \ServidorLogKioscosCR y modificar el archivo
ServidorLogKioscos.exe.config
 En la sección <appSettings> las variables que se detallan continuación:
Variable Descripción Valor
MTKIOSCOS_LOG Nombre de la cola de ".\PRIVATE$\MTKIOSCOS_LOGCR"
registro de log.
MaximosReintentos Cantidad de reintentos de 5
inserción de registros
 Modificar las propiedades del parámetro ConnectiongString con base a la
siguiente información:
Propiedad Valor según ambiente
UAT PROD
Data Source 10.235.27.133 No definido al momento de
elaborar el presente documento.
Initial Catalog KioscosCR KioscosCR
User Id UsrKioscosCR UsrKioscosCR
Password [contraseña bd UAT] [contraseña bd PROD]

11. Guardar el archivo ServidorLogKioscos.exe.config y cerrar el editor de texto.