Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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

...

  • Guardar en dicha carpeta el archivo instalador del motor de la versión que se desea instalar.

Image RemovedImage Added

  • Abrir en modo Administrador una ventana de comandos

  • Se abre la ventana cmd.

Image RemovedImage Added

  • Ir a la carpeta donde tenemos guardo el instalador, y copiar la ruta.

...

  • Obtendremos la siguiente respuesta:

Image RemovedImage Added

Y veremos esta imagen:

...

  • Luego se debe seleccionar Enter para ver la licencia.

Image Added


  • Se muestra la Licencia y se nos consulta si deseamos aceptar la licencia, como el valor por defecto es si (yes), presionamos Enter.

...

  • A continuación, nos pide indicar la ruta donde se encuentra instalado el jdk.

Buscamos la carpeta donde tenemos instalado java, seleccionamos la ruta y la copiamos.

Image Added


  • Paso siguiente, nos pide que ingresemos el directorio donde queremos hacer la instalación.

Image Modified

Para ello primero creamos una carpeta para la versión 7.y dentro de ella una carpeta engine para el motor.

...

  • En el siguiente paso debemos ingresar el puerto SOCKET, como vamos a dejar el valor por defecto de 3000, presionamos Enter.

Image Modified

  • Luego nos pide ingresar el puerto REST, como vamos a dejar el valor por defecto 8888 presionamos Enter.

...

ModuloClaveValorDescripción
CuponesbarcodePathC:/napse/promo72/images/barcode/Directorio imágenes de códigos de barra
CuponesbarcodeUrlhttp://localhost:8080/promo/assets/barcode/Url imágenes de códigos de barra
CuponesrabbitMQ.couponHistory.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos de tipo CouponHistory
CuponesCODE128PPPSSSTTTnnnnnnnnnnnnnnnnnnFormato de código de barras CODE128. Más detalle ver en:   _Formato_de_Código
CuponesEAN13PPPSSSTTTnnncFormato de código de barras EAN13. Más detalle ver en:   _Formato_de_Código
CuponesUPCAPPPSSSTTTnncFormato de código de barras UPCA. Más detalle ver en:_Formato_de_Código
Cuponesmax.qty999Cantidad máxima de generación Masiva de Cupones por transacción
Cuponesprefix.activetrueUtilizar prefijo numérico incremental para tipos de cupón
CuponesisEditableCouponTypeDistributedfalseHabilita la edición de tipos de cupones en estado "Distribuidos"
CuponesvisibleDigits
Cantidad de dígitos visibles del código de cliente que se verán en los cupones
CuponesamountFormat%.02fFormato en el que se imprimen los montos de los cupones
CuponesnameInfoPos0IndistintoDescripción de las opciones para el POS
CuponesnameInfoPos1Campo 1Descripción de las opciones para el POS
CuponesnameInfoPos2Campo 2Descripción de las opciones para el POS
CuponesexternalAmountAttributeCodeOfitemAddcalCouponValAtributo que se utilizará en la etiqueta item-add para indicar el monto externo del cupón
Cuponesdefault.from[email protected]Email por defecto con el que se enviaran los correos
Cuponesdefault.insertImagesfalseIndica si acepta o no barcodes
Cuponesdefault.subjectPromo Test MailAsunto por default
Cuponeshostsmtp.gmail.comHost del proveedor de email
Cuponespassword**************Contraseña de la cuenta de email
Cuponesport
Puerto de conexión
Cuponessmtp.authtrueHabilitar Auth SMTP
Cuponessmtp.port587Puerto SMTP
Cuponessmtp.socketFactory.classjavax.net.ssl.SSLSocketFactorynombre de la clase SSLSocketFactory
Cuponessmtp.socketFactory.fallbackfalseFallback de socketFactory
Cuponessmtp.socketFactory.port465Puerto SMTP de socketFactory
Cuponessmtp.starttls.enabletrueHabilitar Start TLS
Cuponessmtp.ssl.trust*Nombre de host de certif de confianza (* todos)
Cuponesusername[email protected]Usuario o nombre de la cuenta de email
Elementos de fidelidadmax.qty999Cantidad máxima de elementos de fidelidad a generar por cada operación de alta masiva.
Elementos de fidelidadisEditableAfterCardsGenerationfalsePermitir la edición del tipo de elemento de fidelidad luego de haber generado una tarjeta activa
Elementos de fidelidadprefix.activefalseUtilizar prefijo numérico incremental para tipos de elementos de fidelidad.
Elementos de fidelidadcode.activefalse

Utilizar código numérico incremental para tipos de elemento de fidelidad.

Elementos de fidelidadcard.nominated.default.optionNo

Tipo de elementos de fidelidad: Crear por defecto nominadas (default: false = no)

Elementos de fidelidadcontinueOnErrortruePermitir continuar la importación de catálogo de elementos de fidelidad ante un error
Elementos de fidelidadinsertionOptionINSERT_OR_UPDATEDescribe la opción de inserción para la importación del catálogo de elementos de fidelidad
Elementos de fidelidadchangeAmount.limit(por default vacío) ej. con valor: 500Limita el monto a ser ingresado por pantalla desde "Modificar saldo" (a partir de Promo 7.2.9)
Lista de preciospriceList.distribution.force.offlinefalse

Habilita la acción descargar contingencia en todo momento

Lista de preciospriceList.job.cleanPriceListSchedule.time90Cantidad de días a mantener los ítems en la lista de precios pendientes de impresión
Lista de preciospriceList.lockForUpate15Minutos para poder desbloquear Lista cero en el proceso rest
Lista de preciospriceList.mongo.bulk.insertOrUpdate200Cantidad de registros a insertar por lote en el proceso rest
Lista de preciospriceList.distribution.print.beforetrue

Requiere Impresión previa para poder distribuir Precios.

Lista de preciospriceList.requiresActivationfalseParámetro para configurar si requiere activación de listas de precios
NegociomoneySymbol$Símbolo de moneda
Negociocompetitors.images.pathC:\synthesis\promo\images\custom\competitors\Directorio para almacenamiento de imágenes de competidores
NegociocompetitorsPricesItems.images.pathC:\synthesis\promo\images\custom\competitorsPricesItems\Directorio para almacenamiento de imagenes de precios publicados de competidores
NegociocharsMaximumAlphabetical 20Cantidad máxima de caracteres alfabéticos
NegociocharsMaximumNumerical 20Cantidad máxima de caracteres numéricos
NegociocharsMaximumQuantity 20Cantidad máxima de caracteres totales
NegociocharsMaximumSpecial 20Cantidad máxima de caracteres especiales
NegociocharsMinimumQuantity 7Cantidad mínima de caracteres totales
NegociocharsMinimumUser 3Cantidad mínima de caracteres en el nombre de usuario
NegociomaximumLoginFailedCount 3Cantidad máxima de reintentos de login fallidos sucesivos
NegocionumberQuantity 1Cantidad mínima de caracteres numéricos
NegociopasswordExpirationDays 30Días de expiración de la contraseña del usuario
NegociopublishedDays 7Cantidad de días de antigüedad de precios publicados de competidores
NegociospecialCharsQuantity 0Cantidad mínima de caracteres especiales
NegociostringQuantity 1Cantidad mínima de caracteres alfabéticos
NegociouserBlockDays 90Bloqueo de usuario - días de inactividad
NegociouserLockTime 30Periodo de bloqueo de la cuenta de usuario (en minutos)
PromofileDirectoryC:/napse/promo72/catalogs/2\Importación de catálogo: directorio donde estarán los archivos
PromodecimalSeparator.Separador de decimales, solo para Lista de precios y para PromoLite. Para el resto lo toma de la configuración de la máquina.

Promo


groupingSeparator

,

Separador de miles, solo para Lista de precios y para PromoLite. Para el resto lo toma de la configuración de la máquina.

Promo

mapFunctionMaxDiscount

false

Agrupar promociones en el mapa dentro de una funcion con Maximo Descuento para PromoLite.

Promo

storesLimit

4

Límite de tiendas activas disponibles para PromoLite

Promo

userLimit

4

Límite de usuarios activos disponibles para PromoLite

Promo

additionalProvider1FieldName


Sobreescribe el nombre del campo del proveedor adicional 1 del beneficio

Promo

additionalProvider2FieldName


Sobreescribe el nombre del campo del proveedor adicional 2 del beneficio.
PromoapplicationMethodresumePromociones: valor por defecto en el método de aplicación
PromodivisionMethodproportionalPromociones: valor por defecto en el método de división
PromodivisionPricebenefited-pricePromociones: valor por defecto el tipo de precio beneficiado
PromorequiredBothSupplierstruePromociones: valor por defecto si requiere ambos proveedores del beneficio
PromofileList.txt.Separator,Importación de catálogo: separador
PromofileList.xls.ColStart0Importación de catálogo: columna de comienzo de la importación de catálogo
PromofileList.xls.DirectionverticalImportación de catálogo: forma de importación
PromofileList.xls.RowStart0Importación de catálogo: fila de comienzo de la importación de catálogo
Promoseparator|Importación de catálogo: separador de columnas
PromoupdateSize100Importación de catálogo: tamaño de subida
Promovalidate.autocomplete.existing falseValida que los campos autocomplete de catálogos SOLO permita valores existentes
PromovalidateRelatedEntitiestrueValidar catálogos relacionados al catálogo de clientes
Promoattribute.relationship.validation.requiredfalseRequiere validación de datos de atributos de ítem en la condición de promociones
Promocustomer.requiredfalse

La promoción requiere condición de Cliente para considerarse completa

PromodateTime.requiredfalse

La promoción requiere condición de Fecha con hora para considerarse completa

Promotransaction.requiredfalseLa promoción requiere condición de Transacción para considerarse completa
Promovalid.date.couponTypefalseValida si la vigencia de la promoción esta contemplada dentro de la vigencia del cupón
PromodistributionThreadPool

10

Cantidad de hilos creados para la distribución simultánea
Promopromocache.enabled

false

Habilita la generación de cache de ítems participantes en promociones
Promopromocache.engineHost

localhost

Servidor en el que corre el motor de cache de promociones
Promopromocache.enginePort

3002

Puerto en el que corre el motor de cache de promociones
Promopromocache.engineRetries

2

Reintentos de conexión al motor de cache de promociones
Promopromocache.engineTimeout8000Timeout de conexión al motor de cache de promociones
Promopromocache.imagesURL

http://localhost:8080/promo/assets/images/

PromoCache: URL Imágenes Promociones
Promopromocache.salesPath

C:/napse/promo72/cache/sales/

Directorio de mapas del motor de cache de promociones
Promopromocache.tasksQuantity

10

Cantidad de hilos de ejecución del cache de promociones
Promoscheduled.enabledfalseGeneración y distribución programada de mapas
Promoscheduled.filter.enablefalse

Filtrar promociones por tienda para la distribución programada

Promoscheduled.mapVersiontrue

Incrementar la versión del mapa para la distribución programada

Promodate.UTC.enabledtruePropiedad que indica si están habilitadas las conversiones de fecha al formato UTC en las interfaces de exportación.
Promomicrosoft.crm.clientId
Identificador del cliente de Microsoft Dynamics CRM
Promomicrosoft.crm.clientSecret
Client Secret de Microsoft Dynamics CRM
Promomicrosoft.crm.coupon.batch.size1000Cantidad de Cupones a enviar por lote a Microsoft Dynamics CRM (Máximo 1000)
Promomicrosoft.crm.coupon.endpoint
Endpoint de cupones de Microsoft Dynamics CRM
Promomicrosoft.crm.enabledfalseHabilita la funcionalidad de exportación a Microsoft Dynamics CRM
Promomicrosoft.crm.host
Url de host de Microsoft Dynamics CRM
Promomicrosoft.crm.tentantId
TenantId de Microsoft Dynamics CRM
Promomicrosoft.crm.urlAuth
Url de autenticación de Microsoft Dynamics CRM
PromopathC:/napse/promo72/import/Directorio para la importación de Mapas de Promociones.
Promobenefit.activefalseUtilizar campo numérico incremental para beneficios
Promopromotion.code.activefalseUtilizar campo numérico incremental para promociones
PromoredeemedPoints0

Determina el mínimo de puntos para beneficios de redención

Promouse.item.catalogtrueMapas: algoritmo de cálculo de colisiones
PromocleanEngineStatusHistory7Tiempo en días que la consola mantendrá el historial de estados del motor
PromodateEditableIfActivetrueHabilita la edición de la fecha de inicio de vigencia de la promoción
PromodefeatedEditable.enabled
true

Habilita la edición de promociones vencidas

PromodeployedEditable.enabledfalseHabilita la edición de promoción con el estado Deployed.
PromoengineLog.FileDirectory
Engine Log: Directorio donde estarán los archivos.
Promofile.xls.header.rowStart1Alta masiva de promociones: número de fila donde se va a ubicar la cabecera de la plantilla de promoción.
Promomessage.printer.maxLength
Recortar mensaje para la impresora.
Promopromo.name.codefalseIndica si el código de una promoción, debe ser concatenado al nombre de la misma.
Promopromotion.codeKeyfalseCampo código de promoción clave.
Promopromotion.enginestatus.communication600Tiempo que transcurre desde el último informe de estatus del motor o consola, para considerarlo offline. Si en ese tiempo no informó se lo considera offline.
Promopromotion.images.height250Promociones: alto default de las imagenes
Promopromotion.images.pathC:/napse/promo72/images/promotion/Promociones: directorio para almacenamiento de imágenes
Promopromotion.images.width250Promociones: ancho default de las imagenes
PromorabbitMQ.SSL.enabledtrueActivar SSL
PromorabbitMQ.cardhistory.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos de tipo CardHistory
PromorabbitMQ.enabledfalsePropiedad que indica si está habilitado rabbitMQ
PromorabbitMQ.endpointName
Nombre de la cola de rabbitMQ
PromorabbitMQ.enginestatus.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos de tipo EngineStatus
PromorabbitMQ.host
Dirección (host) del RabbitMQ server
PromorabbitMQ.limitstatus.endpointName

Nombre de la cola de RabbitMQ para el posteo de datos de tipo LimitStatus

PromorabbitMQ.loyaltyType.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos para el tipo de cupones/Elementos de Fidelidad
PromorabbitMQ.password

Password para acceder al rabbitMQ

PromorabbitMQ.port

Puerto del server rabbitMQ

PromorabbitMQ.producer.SSL.enabledtrue

Activar SSL para el posteo de datos

PromorabbitMQ.producer.enabledfalse

Propiedad que indica si esta habilitado rabbitMQ para el posteo de datos.

PromorabbitMQ.producer.host
Dirección (host) de RabbitMQ server para el posteo de datos.
PromorabbitMQ.producer.manual.promotion.enabledfalseHabilitar el posteo manual de datos desde la promoción.
PromorabbitMQ.producer.password
Password para acceder al RabbitMQ server para el posteo de datos.
PromorabbitMQ.producer.port
Puerto del RabbitMQ server para el posteo de datos
PromorabbitMQ.producer.uri

URI de conexión completa RabbitMQ server para el posteo de datos

PromorabbitMQ.producer.username

Usuario para acceder a RabbitMQ server para el posteo de datos

PromorabbitMQ.producer.virtualHost

Virtual Host RabbitMQ server para el posteo de datos

PromorabbitMQ.promotion.endpointName

Nombre de la cola de RabbitMQ para el posteo de datos de tipo Promotion

PromorabbitMQ.promotionsCache.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos de tipo PromotionsCache
PromorabbitMQ.segments.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos de segmentos
PromorabbitMQ.transaction.endpointName
Nombre de la cola de RabbitMQ para el posteo de datos de transacciones
PromorabbitMQ.uri

URI de conexión completa rabbitMQ

PromorabbitMQ.username

Usuario para acceder al rabbitMQ

PromorabbitMQ.virtualHost

virtual Host al rabbitMQ

PromoreportParticipantsfalsePromociones: valor global que determina si la promoción informa participantes
PromoreportParticipantsVisibletrueDetermina si se visualiza o no, la opción reportar participantes
Promovtol.url
Url para obtener los planes de pago de Vtol
PromobankRefundBenefit.method.of.payment

NOTHING= No calcular promociones por medio de pagos.

ON_ITEMS_PAID= Calcular promociones sobre ítems pagados

ON_PAYMENT_MADE=Calcular promociones sobre pago realizado

Reintegro bancario: Opciones de cálculo de reintegro
PromobankRefundBenefit.method.of.payment.onItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.BankRefundPartialPaymentGSPromotion

Reintegro bancario: Clase de la promoción basada en ítems.

PromobankRefundBenefit.method.of.payment.onItemsPaid.namePromociones basadas en ítems - Reintegro bancario

Reintegro bancario: Nombre de la promoción basada en ítems.

PromobankRefundBenefit.method.of.payment.onItemsPaid.tenderMethodPropertyKey

promo.configuration.tenderMethod.itemMethod

Reintegro bancario: Propiedad basada en ítems a utilizar.

PromobankRefundBenefit.method.of.payment.onPaymentMade.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.BankRefundPartialPaymentSSPromotion

Reintegro bancario: Clase de la promoción basada en pagos.

PromobankRefundBenefit.method.of.payment.onPaymentMade.namePromociones basadas en pagos - Reintegro bancario

Reintegro bancario: Nombre de la promoción basada en pagos

PromobankRefundBenefit.method.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethod

Reintegro bancario: Propiedad basada en pagos a utilizar.

Promomethod.of.payment

NOTHING= No calcular promociones por medios de pago.

ON_ITEMS_PAID = calcular promociones sobre ítems pagados.

ON_PAYMENT_MADE = Calcular promociones sobre pago realizado.

Promoción Codificada: NOTHING, ON_ITEMS_PAID, ON_PAYMENT_MADE.
Promomethod.of.payment.onItemsPaid.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotionPromoción Codificada: nombre de la promoción por medio de pago basada en ítems.
Promomethod.of.payment.onItemsPaid.namePromociones basadas en ítems

Promoción Codificada: nombre de la promoción por medio de pago basada en ítems.

Promomethod.of.payment.onItemsPaid.tenderMethodPropertyKeypromo.configuration.tenderMethod.itemMethod

Promoción Codificada: nombre de la promoción por medio de pago basada en ítems.

Promomethod.of.payment.onPaymentMade.classcom.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsSSPromotion

Promoción Codificada: nombre de la promoción por medio de pago basada en ítems.

Promomethod.of.payment.onPaymentMade.namePromociones basadas en pagos

Promoción Codificada: nombre de la promoción por medio de pago basada en ítems.

Promomethod.of.payment.onPaymentMade.tenderMethodPropertyKeypromo.configuration.tenderMethod.paymentMethod

Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.

PromoldapAuthenticationfalse

Determina si se autentica contra un Directory Service.

PromoldapAuthentication.autheticationModeDIGEST-MD5Es el modo de seguridad que se autentica, usar "DIGEST-MD5" como valor default dado que este modo encripta la información contra el Directory Service.
PromoldapAuthentication.urlServer
URL del server contra el que se autentica.
PromotestEngineADDRlocalhost

Simulación: Dirección del motor para simulación.

PromotestEnginePORT3001Simulación: puerto en el que corre el motor para simulación
PromotestEngineRetries2

Simulación: reintentos de conexión al motor

PromotestEngineSalesPathC:/napse/promo72/engine/sales/

Simulación: ruta del motor.

PromotestEngineTimeout8000Simulación: timeout de conexión al motor.
PromocontinueOnErrortruePermitir continuar la importación de catálogo de marcas ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de categorías ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de canales ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de compañia crediticia ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de clientes ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de tipos de clientes ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de transacciones ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de tipos de transacción ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de tipos de familia ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de formatos ante un error
PromocontinueOnErrortruePermitir continuar la importación del catálogo de información financiera de lista de precios ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de items ante un error
PromocontinueOnErrortruePermitir continuar la importación del catálogo de stock ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de tipos de Departamento ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de bancos ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de pagos (Código) ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de prefijos ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de tipos de pagos ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de códigos de barra ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de código de productos ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de perfil de cliente ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de Canje de Puntos por Catalogo ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de cadenas ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de sub categorías ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de subzonas ante un error
PromocontinueOnErrortruePermitir continuar la importación de catálogo de proveedores ante un error.
PromocontinueOnErrortruePermitir continuar la importación de catálogo de zonas ante un error.
Redes socialesfacebook.appId
Id de la aplicación de facebook
Redes socialesfacebook.permissions[pages_show_list, pages_read_engagement, pages_manage_posts]Permisos de la aplicación de facebook
Redes socialesfacebook.secret
Clave secreta de la aplicación de facebook
Redes socialesfacebook.secure
Protocolo de conexión segura a la aplicación de facebook
Redes socialestwitter.accessToken
Token de acceso a twitter
Redes socialestwitter.accessTokenSecret
Token secreto de acceso a twitter
Redes socialestwitter.consumerKey
Clave consumer key de twitter
Redes socialestwitter.consumerSecret
Clave consumer secret de twitter
TransaccionescleanTransactions90Cantidad de días que permanecerán los registros de transacciones ( y sus asociados)  y promociones en la base de datos. Las promociones permanecerán durante un año en una tabla temporal.

...

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.

...

Aviso
titleIMPORTANTE

Al utilizar un sistema de autenticación externos los usuarios dados de alta en la consola no deberán poseer ningún tipo de configuración de políticas de seguridad de PROMO.


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.

...

Informações
titleNOTA

La operación en consola sucede al iniciar o cerrar sesión. Al usar saml, el inicio de sesión de PROMO se reemplaza por el inicio de sesión del proveedor de identidad.


Consideraciones de

...

las pruebas de Integración

...


Informações
titleIMPORTANTE

ESTE ES SOLO UN EJEMPLO REALIZADO CON UNA HERRAMIENTA (github) QUE EXISTÍA PARA REALIZAR ESTAS PRUEBAS.



  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 

    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 instalación 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 la

    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.

Aviso
titleIMPORTANTE

Saml2 funciona con la primer empresa existente y no principal. Todo usuario se verificará con dicha empresa. Para el caso del acceso con la empresa Synthesis, se reservó el usuario synthesis, es decir, si se necesita acceder a la compañía principal se debe utilizar el usuario synthesis. El cliente deberá dar de alta en su proveedor de identidad a este usuario previamentecrea promoAdmin. Este war sólo tiene la finalidad de acceder con synthesis para entornos test/productivos con saml activo.


Properties:

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

    Bloco de código
    languagexml
    themeRDark
    #
    # 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
    languagexml
    themeRDark
    ping=C:\\synthesis\\promo\\idp.xml



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

    Bloco de código
    languagexml
    themeRDark
    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
    languagexml
    themeRDark
    #apollo = nalle123


...