...

...

Documentación relacionada

PROMO - Manual de Usuario 7.0

PROMO - Manual de Integración 7.0 - Motor

PROMO - Manual de Integración 7.0 - Servicios

PROMO 7.0 - Manual de Integración - Colas de Mensajes

PROMO - Manual de Usuario Principal 7.0

Ejecución del Instalador (Windows)

...

Como se mencionó en el punto anterior, el motor de promociones es el componente de PROMO encargado de recibir tickets directamente desde el punto de venta, luego procesarlos, y, finalmente, informar las promociones que participaron y los artículos afectados.
La instalación del motor de promociones se realiza conjuntamente con la instalación de la consola de Promo, al ejecutarse el instalador de la aplicación. La comunicación se establece a través de mensajes XML enviados mediante TCP/IP, REST o Pipes (IBM 4690).

Âncora
_Toc513638213 _Toc513638213

Pre-Requisitos del sistema

...

Se provee un archivo promo-gengine-installer-X.X.X.jar donde X.X.X es la versión del motor que se está instalando (67.40.0x).
Se deberá ejecutar como administrador, en modo comando el instalador del Motor de PROMO ( java –jar promo-gengine-installer-X7.X0.Xx.jar)

Al ejecutarse el instalador aparecerá la siguiente ventana:

Image Added

Image RemovedImage Added
Presionar "Siguiente" para continuar.

Se deberán aceptar los términos y condiciones para continuar con la instalación del motor de PROMO.

Presionar en "Aceptar" para continuar.

Luego de aceptados los términos y condiciones, se solicitara que se identifique el nombre del usuario y el e-mail de quien (empresa o persona) está realizando la instalación.

Image RemovedImage Added
Presionar "Siguiente" para continuar.

A continuación se deberá indicar la ruta de acceso a Java (JDK) y el directorio donde se realizara la instalación del motor de PROMO. Por default se propone "c:\synthesisnapse\gengine". 

Se podrá indicar aquí, por medio del check "Instalar Servidor REST (Default TCP/IP)", para que se instale el motor como SERVIDOR REST sino se instalara por default en modo TCP/IP.

...

Presionar "Siguiente" para continuar.

Si se desea instalar el motor como aplicación, se debe tildar el cheeckbox

Image Added

En el siguiente Pop-UP se deberá indicar la URL de acceso a "Director" para futuras actualización y el código de tienda que tomara el motor A continuación se deberá indicar

Image Removed
Presionar "Siguiente" para continuar.Image Added

Luego de presionar "Siguiente", debe completar los parámetros solicitados:

Image Added

Si se presiona "Siguiente"

Image Added

En la siguiente pantalla que se presente, habrá que presionar el botón "Instalar" a fin de dar comienzo al proceso de instalación del motor de PROMO y sus componentes.

Image RemovedImage Added

Finalizada la instalación se mostrara la siguiente ventana donde se informara la correcta instalación del motor de PROMO. Se solicitara dar Clic en "Aceptar" y luego en "Salir" para terminar con el proceso. 

Image RemovedImage Added

Terminado el proceso de instalación del motor de promociones podrá chequearse en los servicios del sistema la existencia de dos nuevos servicios correspondientes al motor de promociones y al agente Director que ya estarán ejecutándose de manera atomística, hecho que marcara la correcta instalación y puesta en funcionamiento del nuevo motor de PROMO.

...

1. En este ejemplo vamos a generar un almacén de claves de nombre keystore para un alias de nombre Jettycon validez del certificado de 365 días y los algoritmos detallados.  Pedirá información que llevará el certificado, al final darle si para terminar. La clave que pide al inicio es una nueva clave y debe tenerse en cuenta ya que se configurará la misma en el motor.  Según la página esto funciona sólo para pruebas porque el certificado no es de confianza para el cliente (navegador por ej.).

   keytool -keystore keystore.dat -alias jetty -genkey -keyalg RSA -sigalg SHA256withRSA -validity 365   
   
   

2. Se puede revisar el almacén de claves con;

   
   

   keytool -list -keystore keystore.dat -storetype jks -storepass THEPASSWORD -v
   
   

3. Se genera el archivo csr (solicitud de firma del certificado / certificate signing request - CSR).

   
   

   
   

   keytool -certreq -alias jetty -keystore keystore -file jetty.csr
   
   

4. En el config.xml del motor ingresar los siguientes valores:
   

    <useHttps>true</useHttps>

    <keyStore>C:\keystore.dat</keyStore>

    <keyStorePassword>THEPASSWORD</keyStorePassword>

...

Autenticación por usuarios y roles

...

• [promo.MIDDLEWARE.MESSAGING]- WARNING: INVALID TICKET: cvc-datatype-valid.1.2.1: 's250.0' is not a valid value for 'double'.
  Indica que se ha recibido una petición o ticket que posee un valor o tipo de dato inválido. En este caso, el motor dará un mensaje de respuesta con un código de error (ver "Manual de mensajería – Promo").

...

• .

...

Âncora
_Toc513638226 _Toc513638226

Información de Configuración

...

Configuraciones disponibles para el Usuario Principal:

Configuraciones disponibles para el Usuario Admin. de cada compañía:

...

El programa toma como ingreso a la clave a encriptar y devuelve la clave encriptada que se debe situar en el archivo promoplus.properties en una entrada llamada grails.mongodb.encryptedPassword (por ej. grails.mongodb.encriptedPasswordencryptedPassword=lYYBAfxLR40=).

En caso de utilizar grails.mongodb.encryptedPassword se debe considerar comentar o eliminar la anterior grails.mongodb.password ya que en caso de existir ambas siempre utilizará grails.mongodb.password. En caso de que el archivo promoplus.properties no exista, se tomará, como valor por defecto, a v9vbhV.

...

Para que promo utilice saml2, se deberá agregar, en el directorio donde permanecen los .properties\appserver\modules\system\layers\base\com\synthesis\configuration\main\ , los archivos properties correspondientes. Éstos Estos son:

1. saml.properties - Archivo principal de configuraciones.
2. saml-keymanager-passwords.properties
3. saml-metadata-providers.properties - Archivo correspondiente a la configuración del proveedor de identidad.
4. saml-metadata-sp-defaults.properties - Archivo correspondiente a la configuración que utilizará PROMO para generar su archivo xml de metadatos.

...

Consideraciones de la pruebas de Integración

Para realizar pruebas se utilizó https://capriza.github.io/samling/samling.html 

1. Alta de usuarios en la consola de PROMO por medio del servicio rest correspondiente (createOrUpdateUsers), También podrán darse de alta manualmente desde la consola. En ambos casos deberá de tenerse en cuenta que los usuarios no deberán tener asignadas ninguna restricción en cuanto a políticas de seguridad propias de PROMO.

2. Obtener

   su

   el xml de metadatos

   en el menú idp metadata (https://capriza.github.io/samling/samling.html#) y guardarlos en un archivo xml (preferiblemente idp.xml). Debe apuntarse al mismo desde la configuración por properties.

   del sistema saml proveedor de identidad, del cliente. La ruta donde estará este archivo deberá tener especificada en la configuración properties. Para simplificar se puede renombrar como idp.xml.

3. Guardar el archivo idp.xml en C:\synthesis\promo\idp.xml
4. Editar el archivo saml-metadata-providers.properties especificando allí la ruta absoluta donde se colocó el archivo idp.xml
5. Iniciar PROMO (Wildfly) con los cuatro properties correspondientes a saml.
6. Generar el xml de PROMO accediendo a http://localhost:8080/promo/saml/metadata, guardarlo en un xml (preferiblemente sp.xml).
7. Se guardó

   Guardar sp.xml

   en 

   en C:\synthesis\promo\sp.xml.

8. Editar el archivo saml.properties especificando allí la ruta absoluta donde se colocó el archivo sp.xml

9. Editar el archivo saml-metadata-sp-defaults.properties especificando la ruta de promo (por ej. http://localhost:8080/promo).

10. Detener PROMO (wildfly)
11. Borrar los directorios \temp y \data que se encuentran en el directorio \standalone de la instalacion de PROMO.
12. Iniciar PROMO(wildfy)
13. Al acceder a la consola de PROMO en lugar de la pantalla de inicio de sesión aparecerá la pantalla de samling. Esta pantalla permite configurar qué se desea enviar al proveedor de servicios, que en este caso es PROMO. Sólo modificar, dentro de "Saml Response Properties" el campo "Name Identifier" con el nombre de usuario con el que se desea acceder a PROMO.Presionar "NEXT"
    Image Removed
    En la siguiente pantalla que se presenta presionar "Post Response"
    Image Removed
    Se presentara inicio de sesión del proveedor de identidad.
14. Luego de ingresar usuario y clave en el proveedor de identidad, se presentará la consola de PROMO, logueada con el usuario ingresado:, en la página de inicio correspondiente al rol que tiene asignado.    
    
    

Si el usuario no corresponde a ningún usuario dado de alta en PROMO el login fallará, y se volverá a la pantalla del punto 13 para volver a intentar a ingresar un usuario valido y poder iniciar sesión en PROMO.

Si el usuario es uno existente iniciará sesión en PROMO sin problemas, presentándose la pantalla de Gestión de Promociones.

Propertis:

• saml.properties, debe mantener la ruta absoluta al archivo de metadatos del proveedor de servicios.

  Bloco de código
  language xml theme RDark
  # # Configuraciones para la utilización de SAML2 # Más info en https://sphoortia.github.io/grails-spring-security-saml/docs/guide/configuration.html # grails.plugin.springsecurity.saml.userGroupAttribute = memberOf grails.plugin.springsecurity.saml.metadata.sp.file = C:\\synthesis\\promo\\sp.xml grails.plugin.springsecurity.saml.metadata.sp.alias = promo_saml grails.plugin.springsecurity.saml.responseSkew = 60 grails.plugin.springsecurity.saml.idpSelectionPath = / grails.plugin.springsecurity.saml.loginFormUrl = /saml/login

  
  
  

• saml-metadata-providers.properties, clave ping, debe mantener la ruta absoluta al archivo de metadatos del proveedor de identidad.

  Bloco de código
  language xml theme RDark
  ping=C:\\synthesis\\promo\\idp.xml

  
  
  

• saml-metadata-sp-defaults.properties, clave entityBaseURL, debe mantener la ruta de promo.
  

  Bloco de código
  language xml theme RDark
  local=true alias=promo_saml entityBaseURL=http://localhost:8080/promo securityProfile=metaiop signingKey=ping encryptionKey=ping tlsKey=ping requireArtifactResolveSigned=false requireLogoutRequestSigned=false requireLogoutResponseSigned=false idpDiscoveryEnabled=false

  
  
  

• saml-keymanager-passwords.properties

  
  

  Bloco de código
  language xml theme RDark
  #apollo = nalle123

  
  

...