IBM eMessage
Versión 9 Release 1.1
13 de febrero de 2015
Guía de inicio y del administrador
Nota
Antes de utilizar este producto y la información a la que da soporte, lea la información contenida en el apartado “Avisos” en la página 125.
Contenido
Capítulo 1. Mensajería alojada utilizando
IBM Campaign e IBM eMessage . . ..
1
Cómo definir una cuenta de correo electrónico
alojada con IBM . . . .. 1 Descripción general del proceso de inicio . . .. 1 Antes de empezar a trabajar con eMessage . . .. 3
Capítulo 2. Configuración del entorno
local de IBM EMM para eMessage
. ..
5
Confirmación de registro de eMessage . . . . .. 5 Registro de eMessage manualmente . . . .. 6 Habilitación de funciones de eMessage en Campaign 6 Visualizar las opciones de menú de eMessage . .. 7 Especificación de las características de las tablas de sistema de eMessage. . . .. 7 Configuración del acceso a las tablas del sistema local de eMessage . . . .. 8 Correlación necesaria para tablas del sistema de eMessage en Campaign . . . .. 9 Reinicio necesario del servidor de aplicaciones web para Campaign . . . .. 9
Capítulo 3. Conexión a servicios de
correo electrónico alojados . . . . ..
11
Requisitos para configurar la conexión con IBM
EMM Hosted Services . . . .. 11 Requisitos para cargar datos a IBM EMM Hosted Services . . . .. 12
Requisitos de conexión y puertos . . . . .. 12 Conexión de carga predeterminada mediante FTP explícito . . . .. 13 Carga de datos con FTP implícito . . . . .. 14 Conexión mediante un proxy HTTP . . . .. 17 Valor de puerto y frecuencia de descarga de datos 23 Requisito del usuario del sistema para acceder a IBM EMM Hosted Services . . . .. 23
Configuración del usuario del sistema que accede a IBM EMM Hosted Services . . . .. 24 Configuración de direcciones para conectarse a IBM EMM Hosted Services . . . .. 25 Configuración de la comunicación segura para el correo electrónico alojado. . . .. 26
Generar un almacén de claves de confianza .. 27 Configuración de SSL al utilizar WebLogic . .. 28 Cómo configurar SSL para utilizar IBM
WebSphere . . . .. 31
Capítulo 4. Operación del rastreador de
respuestas y contactos
. . . ..
33
Operación manual del Rastreador de respuestas y contactos . . . .. 33 Adición del Rastreador de respuestas y contactos (RCT) como servicio . . . .. 34
Eliminación del servicio Rastreador de respuestas y contactos . . . .. 34
Capítulo 5. Verificación del inicio . ..
37
Confirmación de las configuraciones del sistema .. 37 Probar la carga a IBM EMM Hosted Services . .. 39 Probar la descarga desde IBM EMM Hosted Services 39 Probar la conexión a la interfaz de mensajería
alojada . . . .. 39
Capítulo 6. Configuraciones para IBM
eMessage . . . ..
41
Configuración del acceso a historial adicional de ejecución de envíos de correos . . . .. 42 Soporte de la integración de ofertas de campaña .. 43 Configuración del soporte para tablas de
dimensiones . . . .. 44 Configuración del acceso a las tablas del sistema local de eMessage . . . .. 44 Propiedades de configuración de eMessage . . .. 45
Campaign | particiones | partición[n] |
eMessage . . . .. 45 Campaign | partitions | partition[n] | server | internal . . . .. 47 Campaign | particiones | partición[n] |
eMessage | contactAndResponseHistTracking .. 49 eMessage | serverComponentsAndLocations | hostedServices . . . .. 52 eMessage | particiones | partición[n] |
hostedAccountInfo . . . .. 53 eMessage | particiones | partición[n] |
dataSources | systemTables . . . .. 53 eMessage | particiones | partición[n] |
recipientListUploader . . . .. 56 eMessage | particiones | partición[n] |
responseContactTracker . . . .. 57
Capítulo 7. Configuraciones para
implementar notificaciones de envío a
móvil de IBM . . . ..
61
Visión general de cómo integrar las aplicaciones móviles con los sistemas de mensajería de IBM .. 61 Integración de Google Cloud Messaging con IBM eMessage . . . .. 62
Requisitos previos para la integración de aplicaciones de Google Android con
notificaciones de envío de IBM . . . .. 62 Implementación de IBM Push Notification SDK for Android dentro de su aplicación . . . .. 63 Suministro de una bandeja de entrada de
aplicación para aplicaciones Android . . . .. 65 Suministro de notificaciones desencadenadas por ubicación para aplicaciones Android . . . .. 66
Suministro de notificaciones de intención de la acción . . . .. 68 Configuración del soporte para eventos y
notificaciones . . . .. 68 Personalización de notificaciones . . . . .. 71 Integración de ID de usuario de aplicación de dispositivo móvil (XID) para Android . . .. 72 Integración del servicio de notificación de envío de Apple con IBM eMessage. . . .. 73
Requisitos previos para la integración de aplicaciones de Apple iOS con notificaciones de envío de IBM . . . .. 73 Implementación de iOS en la aplicación . . .. 74 Suministro de una bandeja de entrada de
aplicación para aplicaciones iOS . . . . .. 77 Suministro de acciones en notificaciones . . .. 80 Notificaciones desencadenadas por ubicación para las aplicaciones iOS . . . .. 83 Configuración del SDK para notificaciones
activadas por ubicación . . . .. 84 Configuración del comportamiento personalizado de identificadores . . . .. 85 Creación de una notificación de envío para la aplicación de ejemplo de Apple iOS . . . .. 85 Borrado de todas las notificaciones desde el
dispositivo móvil . . . .. 86 Recepción de notificación de registro de
aplicación . . . .. 86 Integración del ID de usuario de aplicación de dispositivo móvil (XID) para iOS . . . . .. 86 Habilitación de la cuenta de mensajería alojada para la mensajería móvil . . . .. 87 Registro de una aplicación móvil en IBM eMessage 88 Requisito para identificar usuarios de la aplicación en la base de datos de marketing . . . .. 89 Prueba de la integración de la aplicación de
dispositivo móvil en un dispositivo móvil . . .. 90 Configuración de ubicaciones para entrega
desencadenada por ubicación . . . .. 91 Edición de las propiedades de ubicación. . .. 91 Supresión de ubicaciones disponibles para
entrega desencadenada por ubicación. . . .. 92 Configuración de valores predeterminados para la mensajería móvil . . . .. 92 Enviar datos de seguimiento de notificación de IBM 93
Capítulo 8. Programas de utilidad para
eMessage . . . ..
95
El script RLU . . . .. 95 Script de seguimiento de respuestas y contactos
(RCT) de eMessage . . . .. 96 Script MKService_rct de eMessage . . . .. 97
configTool . . . .. 98 Para hacer copia de seguridad de los valores de configuración . . . .. 102
Capítulo 9. Acerca de la resolución de
problemas en eMessage. . . ..
103
Archivos de registro de eMessage . . . . .. 103 Utilización de log4j con eMessage . . . . .. 103
Capítulo 10. Gestión del acceso de
usuario a las funciones de mensajería 105
Asignación de roles y políticas para el acceso a
envío de correos . . . .. 105 Roles y permisos en Marketing Platform y
Campaign . . . .. 106 Cómo funcionan las políticas de seguridad .. 106 Permisos de mensajería en Campaign . . . .. 109 Realización de roles y permisos disponibles .. 110 ¿Cómo evalúa Campaign los permisos?. . .. 111 Definición de estados de permiso . . . . .. 111 Permisos de envíos de correos en Campaign .. 112 Permisos para la categoría Activos digitales .. 112 Permisos para la categoría Documentos. . .. 113 Permisos para la categoría Administración de correo electrónico . . . .. 114 Permisos de mensajería para eMessage . . . .. 115 Asignación de roles de eMessage . . . . .. 115 Control de dominios de correo electrónico y
dominios de enlace corto . . . .. 116 Mantenimiento de dominios de correo
electrónico alojado. . . .. 117 Configuración de la dirección y del nombre de
visualización de remitente predeterminados . .. 118 Control del acceso a la lista de mensajes enviados 119
Otorgamiento de acceso a la lista de mensajes enviados . . . .. 119 Denegar el acceso a la lista de mensajes
enviados . . . .. 120 Habilitación de la restricción a la lista de
mensajes enviados. . . .. 121 Permisos para informes de eMessage . . . .. 122
Antes de ponerse en contacto con el
soporte técnico de IBM . . . ..
123
Avisos . . . ..
125
Marcas registradas. . . .. 127 Consideraciones sobre la política de privacidad y los términos de uso . . . .. 127
Capítulo 1. Mensajería alojada utilizando IBM Campaign e IBM
eMessage
Cuando IBM®Campaign se integra con IBM eMessage, puede utilizar eMessage para realizar campañas de marketing por correo electrónico altamente
personalizadas.
eMessage proporciona acceso a recursos alojados por IBM de forma que puede diseñar, enviar y supervisar mensajes personalizados individualmente en función de la información almacenada en su despensa de datos de clientes.
v En Campaign, utilice diagramas de flujo para crear listas de destinatarios de correo electrónico y seleccione datos de personalización para cada destinatario. v En eMessage, utilice recursos de capacidad de entrega, transmisión y diseño de
correo electrónico alojados por IBM para realizar campañas de marketing por correo electrónico.
Cómo definir una cuenta de correo electrónico alojada con IBM
Cuando usted adquiere una suscripción a eMessage, IBM crea una cuenta de correo electrónico alojada en su nombre y le envía las credenciales de cuenta que necesitará para utilizar las características de eMessage. Aplicará estas credenciales cuando configure las aplicaciones locales de IBM EMM para acceder al entorno de correo electrónico alojado sobre conexiones seguras.
Debe tener una cuenta válida para acceder a los recursos de correo electrónico que IBM proporciona como servicio de software. Si su instalación de IBM EMM incluye diversas particiones y tiene previsto utilizar eMessage en más de una partición, necesita una cuenta de correo electrónico alojada para cada partición. No puede compartir cuentas de correo electrónico entre distintas instalaciones o particiones. El hecho de definir una cuenta de correo electrónico alojada es el inicio del proceso de inicio, que dura aproximadamente 90 días. Para obtener una descripción general del proceso, consulte “Descripción general del proceso de inicio”.
Descripción general del proceso de inicio
Puede activar las características de correo electrónico en IBM Campaign, para dirigir campañas de marketing por correo electrónico altamente dirigidas y rastreables. Campaign utiliza funciones de correo electrónico proporcionadas por IBM eMessage a través de recursos alojados en centros de datos en Estados Unidos y Reino Unido. Se incluye una cuenta para acceder a estos recursos en la
suscripción de eMessage.
IBM comienza el proceso de inicio después de crear la cuenta de correo electrónico alojada. IBM ayuda a familizarizarse con eMessage, a conectarse con recursos de correo electrónico alojados y a crearse una reputación como comercial por correo electrónico legítimo entre los principales proveedores de servicios de Internet (ISP). El proceso continúa en tres fases. Los equipos de los servicios profesionales y de los servicios para cuentas de correo electrónico de IBM le guían en el proceso.
El consultor de los Servicios profesionales es el principal punto de contacto con IBM durante el proceso de inicio. Una vez completado el proceso de inicio de la cuenta, el consultor de los Servicios profesionales transfiere la responsabilidad de soporte técnico principal al equipo de soporte técnico de productos de IBM . A partir de entonces, dispone de un consultor de Servicios de cuenta de correo electrónico (EAS, Email Account Services) en exclusiva que le proporciona asistencia especial para problemas relacionados con el correo electrónico. Crearse una reputación favorable en correo electrónico entre los principales proveedores de servicios de Internet (ISP, Internet Service Providers) es esencial para asegurarse de que sus campañas de marketing por correo electrónico llegan siempre a los
destinatarios objetivo. Cuando empieza a realizar envíos de correos, el consultor de EAS revisa el rendimiento en la capacidad de entrega de los envíos de correos y le sugiere formas para construirse gradualmente una reputación en correo electrónico.
Actividades e hitos del proceso de inicio
Planificación
Lo que ocurre Quién es el responsable
Enviar las credenciales de cuenta de correo electrónico y el Kit de bienvenida, incluyendo la hoja de trabajo para iniciar el correo electrónico.
Servicios de cuenta de correo electrónico de IBM Planificar una teleconferencia para presentar a todas las
partes implicadas, revisar la planificación para el inicio y comprender los objetivos del marketing por correo electrónico.
Servicios profesionales de IBM
Completar la Hoja de trabajo para iniciar el correo electrónico especificando los requisitos del dominio de correo electrónico y las previsiones de envío de correos.
Su organización
Crear su reputación en correo electrónico
Lo que ocurre Quién es el responsable
Suministrar la cuenta de correo electrónico utilizando la información proporcionada durante la teleconferencia y en la Hoja de trabajo para iniciar el correo electrónico.
Operaciones de correo electrónico de IBM
Lo que ocurre Quién es el responsable Iniciar envíos de correos de prueba para seleccionar cuentas
de prueba con los principales ISP. Para completar esta fase se necesitan aproximadamente 30 días.
Operaciones de correo electrónico de IBM Activar eMessage en IBM Campaign. Su organización (con el
soporte técnico de IBM) Configurar el acceso a los recursos de correo electrónico
alojados. Consulte al asesor de EAS el centro de datos que debe especificar.
Su organización (con el soporte técnico de IBM) Iniciar el envío de correos. Para crearse una reputación
favorable en correo electrónico, realice primero envíos de correos pequeños, seguidos en el tiempo de envíos más grandes y más frecuentes. Los ISP a menudo intentan limitar el correo no deseado bloqueando los envíos de correos muy grandes o frecuentes que no reconozcan como legítimos.
Su organización (con el soporte técnico de IBM)
Proporcionar resultados de capacidad de entrega y ayuda para establecer una reputación a medida que aumentan los volúmenes y la frecuencia de los envíos de correos.
Servicios de cuenta de correo electrónico de IBM
Producción
Lo que ocurre Quién es el responsable
Enviar correos de un volumen y frecuencia normales. Su organización Transferir la responsabilidad principal de contacto al equipo
de soporte técnico de IBM.
Servicios profesionales de IBM
Mantener el compromiso de consultar sobre cuestiones de correo electrónico. Establecer contacto de forma regular para mantener el soporte de cuentas de correo electrónico de forma continuada.
Servicios de cuenta de correo electrónico de IBM
Antes de empezar a trabajar con eMessage
Antes de empezar el proceso de inicio de correo electrónico alojado, tenga en cuenta las cuestiones siguientes.
v Algunas configuraciones requieren reiniciar el servidor de aplicaciones web. Planifique la actividad de configuración de eMessage de forma que no interfiera con la ejecución de grandes diagramas de flujo ni con otras actividades de Campaign.
v IBM le pide que nombre un individuo que sirva como principal punto de contacto durante el proceso de inicio.
v Solicite credenciales de cuenta de correo electrónico alojada antes de iniciar el proceso de inicio. Utilizará estas credenciales para configurar los sistemas para que accedan a la cuenta.
v Consulte al personal de administración de la red. eMessage requiere unos rangos de puerto específicos para establecer comunicación con IBM EMM Hosted Services.
v Confirme que tiene los permisos de red apropiados para realizar cambios de configuración.
Capítulo 2. Configuración del entorno local de IBM EMM para
eMessage
Para utilizar eMessage para utilizar mensajes de correo electrónico alojado es necesario hacer cambios en la instalación local de IBM EMM. Complete los pasos que se describen en las secciones siguientes.
v “Habilitación de funciones de eMessage en Campaign” en la página 6 v “Registro de eMessage manualmente” en la página 6
v “Especificación de las características de las tablas de sistema de eMessage” en la página 7
v “Correlación necesaria para tablas del sistema de eMessage en Campaign” en la página 9
v “Configuración del acceso a las tablas del sistema local de eMessage” en la página 8
v “Reinicio necesario del servidor de aplicaciones web para Campaign” en la página 9
Si el entorno contiene diversas particiones, repita estos pasos para cada partición de Campaign en la que utilice IBM eMessage. Para obtener más información sobre cómo crear y trabajar con diversas particiones, consulte la publicación IBM
Campaign, Guía de instalación.
Confirmación de registro de eMessage
IBM eMessage debe estar registrado en IBM Marketing Platform. Para confirmar que eMessage se ha registrado correctamente, debe examinar la configuración de Marketing Platform.
Procedimiento
1. Inicie sesión en IBM EMM.
2. Vaya a Valores > Configuración.
3. Busque la categoría de configuración eMessage.
IBM eMessage está registrado en Marketing Platform si la categoría eMessage aparece en jerarquía de propiedades de configuración.
Qué hacer a continuación
Si la categoría eMessage no aparece en la jerarquía de propiedades, consulte la IBM
Campaign, Guía de instalación para obtener información sobre cómo registrar
eMessage manualmente.
Si la categoría de eMessage está disponible, debe habilitar funciones de eMessage en Campaign.
Tareas relacionadas:
“Habilitación de funciones de eMessage en Campaign” en la página 6
Registro de eMessage manualmente
Si el instalador de eMessage no puede acceder a las tablas del sistema de Marketing Platform durante el proceso de instalación, debe ejecutar la utilidad
configToolpara registrarla manualmente.
Acerca de esta tarea
De forma predeterminada, el instalador de Campaign registra automáticamente eMessage en las tablas del sistema de Marketing Platform sin habilitar eMessage. En algunas situaciones, el instalador de Campaign no establece conexión con las tablas de sistema de Marketing Platform para que registren automáticamente eMessage.
Si el instalador no registra eMessage automáticamente, debe registrar eMessage manualmente con la utilidad configTool que se proporciona con la instalación de IBM EMM.
Procedimiento
1. En la instalación de Marketing Platform, vaya hasta el directorio tools\bin. La utilidad configTool está en el directorio tools\bin. El directorio de instalación de eMessage es un subdirectorio del directorio de instalación de Campaign.
2. Ejecute el comando configTool -r eMessage -f
"vía_acceso_completa_directorio_instalación_eMessage\conf\ emessage_configuration.xml"
Habilitación de funciones de eMessage en Campaign
Cuando se instala Campaign, el instalador instala también eMessage en la partición predeterminada, pero no lo habilita. Las funciones de eMessage no están
disponibles hasta que se habilita eMessage.
Antes de empezar
Confirme que eMessage se ha registrado correctamente con IBM Marketing Platform.
Registrar eMessage con Marketing Platform forma parte del proceso de instalación de IBM Campaign.
Procedimiento
1. En IBM Marketing Platform, edite Campaign > partitions > partition[n] > server > internal > eMessageInstalled.
2. Para habilitar eMessage, debe cambiar el valor a yes.
Tareas relacionadas:
Visualizar las opciones de menú de eMessage
Para utilizar IBM eMessage, debe actualizar la configuración del sistema de modo que las opciones de menú para eMessage se visualicen en la interfaz de IBM Marketing Platform. Para visualizar las opciones obligatorias, utilice el programa de utilidad configTool que se suministra con la instalación de IBM EMM.
Debe ejecutar configTool con parámetros específicos para cada opción de menú de eMessage. Al ejecutar configTool se actualizan los valores de configuración del sistema. Debe reiniciar el servidor de aplicaciones web para aplicar los cambios. Aunque eMessage se instala con Campaign, las opciones de menú de eMessage no aparecen hasta que se ejecuta configTool y se reinicia el servidor de aplicaciones web. En el directorio tools de la instalación de Marketing Platform, encontrará el programa de utilidad configTool en la carpeta bin.
Nota: Debe especificar una ruta al directorio de instalación de eMessage como parámetro de configTool. El directorio de instalación de eMessage es un subdirectorio del directorio de instalación de Campaign.
v Para visualizar los Valores de mensajería en el menú Valores.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|settingsMenu" -f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_odsettings_navigation.xml"
v Para visualizar Mensajería en el menú Campaña.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|mainMenu|Campaign" -f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_mailings_navigation.xml"
v Para visualizar Editor de mensajes en el menú Campaña.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|mainMenu|Campaign" -f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_documents_navigation.xml"
v Para visualizar Herramientas de análisis de mensajes en el menú Herramientas
de análisis.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_analytics_navigation.xml"
Para verificar que ha añadido satisfactoriamente las opciones de menú, tras reiniciar el servidor de aplicaciones web, inicie sesión en IBM EMM y abra los menús Valores, Campaña, y Herramientas de análisis y compruebe que aparecen las opciones correspondientes a eMessage.
Especificación de las características de las tablas de sistema de
eMessage
IBM eMessage requiere información que describa el tipo, esquema y JDBC de conexión de las tablas de sistema de eMessage en su instalación. Las tablas de sistema de eMessage se crean en el esquema de Campaign como parte del proceso de instalación de Campaign.
Procedimiento
Proporcione la información necesaria en las siguientes propiedades de configuración. Consulte la ayuda en línea de Marketing Platform para cada
propiedad para obtener más información sobre cómo establecer las propiedades de configuración.
v eMessage > partitions > partition [n] < dataSources > systemTables > type v eMessage > partitions > partition [n] < dataSources > systemTables >
schemaName
v eMessage > partitions > partition [n] < dataSources > systemTables > jdbcBatchSize
v eMessage > partitions > partition [n] < dataSources > systemTables > jdbcClassName
v eMessage > partitions > partition [n] < dataSources > systemTables > jdbcURI
Qué hacer a continuación
Para obtener información adicional sobre las propiedades de configuración y la configuración de eMessage, consulte Capítulo 6, “Configuraciones para IBM eMessage”, en la página 41.
Configuración del acceso a las tablas del sistema local de eMessage
IBM eMessage requiere acceso a las tablas del sistema de eMessage en el esquema de Campaign. Para permitir que los componentes de eMessage accedan a tablas del sistema en el esquema de Campaign sin solicitar un inicio de sesión de base de datos manual, debe especificar un usuario del sistema de eMessage para
proporcionar las credenciales de acceso de base de datos necesarias.
Acerca de esta tarea
El usuario del sistema que accede a la base de datos está asociado a un origen de datos de IBM Marketing Platform que contiene las credenciales de inicio de sesión de la base de datos que aloja el esquema de Campaign.
Para obtener más información sobre las propiedades de configuración de la tabla del sistema, consulte “eMessage | particiones | partición[n] | dataSources | systemTables” en la página 53.
Procedimiento
1. Especifique el usuario del sistema que ha definido en IBM Marketing Platform. Edite la siguiente propiedad de configuración.
eMessage > partitions > partition [n] < dataSources > systemTables > asmUserForDBCredentials
2. Especifique las credenciales de inicio de sesión de la base de datos que contiene el esquema de Campaign y las tablas del sistema de eMessage. Edite la
siguiente propiedad de configuración.
eMessage > partitions > partition [n] < dataSources > systemTables > amDataSourceForDBCredentials
Correlación necesaria para tablas del sistema de eMessage en
Campaign
Debe correlacionar las tabla de sistema de eMessage del esquema de Campaign con las correspondientes tablas de base de datos de eMessage. Las tablas de sistema de eMessage tienen eMessage en el nombre de tabla.
En Campaign, correlacione las siguientes tablas de sistema de eMessage. v Tabla de lista de salida de eMessage
v Tabla de correlación de campos de audiencia de lista de salida de eMessage v Tabla de envío de correos de eMessage
v Tabla de instancia de envío de correos de eMessage
v Tabla de correlación de columnas de tablas de datos de eMessage v Tabla de correlación de campos de personalización de eMessage v Tabla de uso de campos de personalización de tabla de eMessage
Para obtener información sobre la correlación de tablas, consulte la publicación
IBM Campaign, Guía del administrador.
Reinicio necesario del servidor de aplicaciones web para Campaign
Tras realizar cambios en las configuraciones de Campaign y eMessage, debe reiniciar el servidor de aplicaciones web que aloja a Campaign.
Consulte la documentación de su servidor de aplicaciones web para obtener instrucciones sobre cómo reiniciar.
Capítulo 3. Conexión a servicios de correo electrónico
alojados
Para acceder a servicios de correo electrónico alojados proporcionados por IBM, debe configurar una conexión entre la instalación local de IBM EMM y IBM EMM Hosted Services.
Los usuarios de marketing acceden a las características de eMessage a través de la interfaz de Campaign. Para trabajar con eMessage es necesario que establezca una conexión a Internet automática y segura que Campaign pueda utilizar para cargar listas de destinatarios de correo electrónico en IBM EMM Hosted Services. Los componentes de eMessage instalados con Campaign también utilizan esta conexión para descargar datos de contacto y respuesta en las tablas de sistema de eMessage en el esquema de Campaign.
Nota: Cada instancia de Campaign requiere una conexión exclusivo a IBM EMM Hosted Services. Si la instalación de Campaign incluye diversas particiones, cada partición requiere una cuenta de correo electrónico alojada distinta. Las cuentas pueden compartir la conexión IP a IBM EMM Hosted Services.
Todas las comunicaciones entre IBM EMM y IBM EMM Hosted Services se llevan a cabo sobre SSL. Cada comunicación de IBM EMM Hosted Services es una
respuesta a una solicitud del entorno local. IBM EMM Hosted Services nunca intenta iniciar una conexión con la red corporativa. Todas las comunicaciones con IBM EMM Hosted Services se originan desde detrás del cortafuegos de la empresa.
Requisitos para configurar la conexión con IBM EMM Hosted Services
Para configurar una conexión con IBM EMM Hosted Services se requieren permisos de administración, así como información sobre la cuenta de correo electrónico alojada establecida para la organización.
Para configurar una conexión correo electrónico alojada, se necesita lo siguiente. v Nombre de usuario y contraseña proporcionada por IBM para la cuenta de
correo electrónico alojada
v Permisos para crear y modificar usuarios del sistema en IBM Marketing Platform v Acceso administrativo a las propiedades de configuración que se mantienen en
la instalación local de IBM Marketing Platform
v Acceso administrativo al servidor de aplicaciones web donde están desplegados IBM Marketing Platform y Campaign
Debe saber, o poder de consultar a las personas que lo saben, los requisitos
corporativos de seguridad de datos. Antes de empezar, revise estos procedimientos para entender cómo crear la necesaria conexión en conformidad con las
restricciones corporativas de cortafuegos.
Debe estar familiarizado con cómo configurar conexiones de confianza en su servidor de aplicaciones web, ya sea IBM WebSphere u Oracle WebLogic.
Requisitos para cargar datos a IBM EMM Hosted Services
Hay un componente de eMessage, denominado el Cargador de Listas de
Destinatarios (RLU -Recipient List Uploader) que forma parte de su instalación de IBM Campaign. El RLU utiliza el FTP en modo pasivo para gestionar la carga de listas de envío de correos y los metadatos asociados en IBM EMM Hosted Services. eMessage utiliza FTP pasivo para cargar datos. Al utilizar FTP pasivo, el RLU inicia todas las solicitudes de conexión de subida como el cliente local. IBM EMM Hosted Services nunca inicia una solicitud de conexión a la red.
eMessage admite dos tipos de métodos de FTP pasivo, el FTP explícito y el FTP implícito. El FTP explícito es el método predeterminado utilizado para cargar listas de destinatarios. Para utilizar FTP implícito que se deben hacer cambios en las propiedades de configuración de eMessage.
Para obtener más información sobre FTP en modo pasiva y sobre cómo utilizar FTP sobre SSL, consulte RFC959 y RFC2228.
Conceptos relacionados:
“Conexión de carga predeterminada mediante FTP explícito” en la página 13 “Carga de datos con FTP implícito” en la página 14
Requisitos de conexión y puertos
Para establecer comunicación con IBM EMM Hosted Services, debe disponer de una conexión a Internet. IBM EMM Hosted Services utiliza puertos específicos. La instalación local de IBM EMM y IBM EMM Hosted Services utiliza los siguientes puertos para comunicarse.
HTTPS: puerto 443
Puertos de comandos FTP
v FTP explícito: puerto 21 v FTP implícito: puerto 990
Puertos de carga de datos FTP
v Centro de datos de EE.UU.
FTP explícito: puertos del 15393 al 15424 FTP implícito: puertos del 15600 al 15701 v Centro de datos del Reino Unido
FTP explícito: puertos del 15393 al 15443 FTP implícito: puertos del 15600 al 15650
IBM EMM Hosted Services nunca inicia una conexión con la red local. Únicamente responde a las solicitudes de conexión iniciadas desde detrás de su cortafuegos.
Conexión de carga predeterminada mediante FTP explícito
De forma predeterminada, el Cargador de listas de destinatarios (RLU) utiliza el FTP explícito cuando el sistema carga una lista de destinatarios de correo
electrónico. La lista de destinatarios también se denomina Tabla de lista de salida (OLT)
El RLU establece una conexión con IBM EMM Hosted Services utilizando el puerto de comandos FTP predeterminado (puerto 21). Emite un comando para solicitar que la sesión se cifre sobre SSL. Mediante la conexión segura, el RLU negocia con el servidor FTP para establecer un enlace SSL aparte sobre un puerto seleccionado aleatoriamente por el RLU. Para obtener más información sobre el FTP explícito, consulte el RFC 2228.
En el diagrama siguiente se ilustra el método predeterminado para cargar datos de destinatarios de Campaign a IBM EMM Hosted Services.
En la tabla siguiente se describe la secuencia de conexión.
Paso Acción Descripción
1 Solicitud de conexión FTP inicial del cliente
Desde detrás del cortafuegos corporativo, el RLU inicia una sesión de carga de datos utilizando FTP sobre SSL explícito. El RLU envía la solicitud de conexión SSL a la dirección de IBM EMM Hosted Services. Debe configurar previamente esta dirección. Para iniciar la sesión, el RLU abre un puerto seleccionado al azar en el lado del cliente y como puerto de comandos FTP. IBM EMM Hosted Services acepta
conexiones de comandos FTP cifrados en el puerto 21.
Paso Acción Descripción 2 Respuesta del servidor FTP
remoto
Como respuesta a la solicitud del RLU de establecer una sesión SSL segura, el servidor FTP designa el puerto de datos FTP sobre el que aceptará la carga de listas de destinatarios.
3 Carga de listas de destinatarios El RLU inicia la carga de la lista en el puerto de datos especificado. Cuando finaliza la carga, el RLU libera la conexión FTP.
Para ver el rango de puertos de datos que puede especificar el servidor FTP, consulte “Requisitos de conexión y puertos” en la página 12.
Conceptos relacionados:
“Requisitos para cargar datos a IBM EMM Hosted Services” en la página 12
Tareas relacionadas:
“Configuración de direcciones para conectarse a IBM EMM Hosted Services” en la página 25
“Configuración del usuario del sistema que accede a IBM EMM Hosted Services” en la página 24
Configuración de la conexión FTP explícita
No es necesaria ninguna configuración adicional. De forma predeterminada, el RLU utiliza la FTP explícita.
Carga de datos con FTP implícito
Puede configurar el RLU para que utilice FTP implícito para cargar listas de destinatarios de correo electrónico. El FTP implícito utiliza el puerto 990 para establecer una conexión con IBM EMM Hosted Services.
Al habilitar el RLU para FTP implícito, toda la sesión se cifra desde el inicio. El FTP implícito es diferente de la conexión mediante FTP explícito, donde el RLU solicita explícitamente un enlace seguro.
Para utilizar FTP implícito para subir las listas de destinatarios, debe descubrir y configurar una propiedad de configuración del sistema en las propiedades de configuración de eMessage.
El siguiente diagrama ilustra cómo el RLU carga datos de destinatarios en IBM EMM Hosted Services cuando el sistema está configurado para utilizar FTP implícito.
En la tabla siguiente se describe la secuencia de conexión.
Paso Acción Descripción
1 Solicitud de conexión FTP inicial del cliente
Desde detrás del cortafuegos corporativo, el RLU inicia una sesión de carga de datos utilizando FTP sobre SSL. El RLU envía la solicitud de conexión SSL a la dirección de IBM EMM Hosted Services. Debe configurar previamente esta dirección.
Para iniciar la sesión, el RLU abre el puerto 990. IBM EMM Hosted Services únicamente acepta conexiones de comandos FTP cifrados en el puerto 990.
2 Respuesta del servidor FTP remoto
Si IBM EMM Hosted Services reconoce la solicitud como una solicitud de FTP implícito válida, el servidor FTP acepta la solicitud de conexión. Designa el puerto de datos FTP para utilizar para la carga de lista de destinatarios.
Consulte “Requisitos de conexión y puertos” en la página 12 para saber el rango de puertos de datos que el servidor FTP puede especificar.
3 Carga de listas de destinatarios El RLU inicia la carga de la lista en el puerto de datos especificado. Cuando finaliza la carga, el RLU libera la conexión FTP.
Conceptos relacionados:
“Requisitos para cargar datos a IBM EMM Hosted Services” en la página 12
Acceso a los parámetros de configuración para carga de FTP
implícito
Para configurar el sistema para utilizar FTP implícito para cargar datos, debe editar las propiedades de configuración que están ocultas de forma predeterminada. Puede ejecutar un script para que se muestren las propiedades.
Acerca de esta tarea
Para configurar el sistema para utilizar FTP implícito para cargar datos, debe hacer visibles las siguientes propiedades de configuración. De forma predeterminada, estas propiedades están ocultas.
v eMessage > serverComponentsAndLocations > hostedServices > ftpPort v eMessage > serverComponentsAndLocations > hostedServices >
useFTPImplicitSSL
Este procedimiento muestra las propiedades de configuración, pero no las configura. Para habilitar el FTP implícito, debe acceder a estas propiedades de la configuración de eMessage y configurarlas. Para obtener información sobre cómo configurar estas propiedades, consulte “Habilitación de la carga de FTP implícito”.
Procedimiento
Para mostrar ftpPort y useFTPImplicitSSL, en el directorio Tools de su instalación de eMessage, ejecute el script switch_config_visibility desde el script de línea de comandos, como se detalla a continuación.
Windows \switch_config_visibility.bat -p "Affinium|eMessage|serverComponentsAndLocations|hostedServices|ftpPort" -v true \switch_config_visibility.bat -p "Affinium|eMessage|serverComponentsAndLocations|hostedServices| useFTPImplicitSSL" -v true UNIX /switch_config_visibility.sh "Affinium|eMessage|serverComponentsAndLocations|hostedServices|ftpPort" -v true /switch_config_visibility.sh "Affinium|eMessage|serverComponentsAndLocations|hostedServices| useFTPImplicitSSL" -v true
Qué hacer a continuación
Debe reiniciar el servidor de aplicaciones web para hacer estas propiedades visibles en la configuración de eMessage.
Tareas relacionadas:
“Configuración del acceso a historial adicional de ejecución de envíos de correos” en la página 42
Habilitación de la carga de FTP implícito
Antes de empezar
Para completar esta tarea, debe revelar dos propiedades de configuración. Para obtener más información, consulte “Acceso a los parámetros de configuración para carga de FTP implícito” en la página 16.
Procedimiento
1. Vaya a Valores > Configuración > eMessage > serverComponentsAndLocations > hostedServices.
2. Pulse en Editar configuración.
v Confirme que useFTPImplicitSSL está establecido en true. v Establezca ftpPort en 990.
3. Guarde los cambios que ha realizado.
Qué hacer a continuación
Los cambios no entrarán en vigor hasta que reinicie el servidor de aplicaciones web y el escucha de Campaign. Puede hacer esto ahora o esperar hasta completar todos los pasos de la configuración de inicio.
Conexión mediante un proxy HTTP
Si las reglas del cortafuegos corporativo prohíben la comunicación directa con Internet público, puede conectar a IBM EMM Hosted Services mediante un servidor proxy HTTP. eMessage da soporte a la conexión mediante un servidor proxy SOCKS que permite tráfico HTTPS y FTPS.
eMessage da soporte al protocolo SOCKS versión 5.
Nota: Para conectar a IBM EMM Hosted Services mediante un servidor proxy, debe instalar Campaign versión 8.5.0.1 o superior.
El diagrama siguiente muestra la comunicación entre el entorno local y el entorno hospedado cuando se utiliza un proxy SOCKS.
Puede configurar un servidor de proxy SOCKS en el entorno local in situ. Antes de empezar a configurar el servidor proxy, confirme que cumple los requisitos
siguientes.
v El servidor proxy debe ser un servidor proxy SOCKS.
v El servidor proxy debe poder acceder al entorno de eMessage OD. El servidor debe permitir tráfico a/de los puertos configurados para el centro de datos que utiliza la cuenta de correo electrónico hospedado. IBM mantiene los centros de datos en EE.UU. y en el Reino Unido.
v El entorno de eMessage OP debe poder acceder al servidor proxy SOCKS.
Configuración del direccionamiento para tráfico FTPS y HTTPS
mediante proxy SOCKS
Para utilizar un proxy SOCKS para acceder a los recursos de correo electrónico hospedados, debe actualizar el servidor de aplicaciones web donde ha desplegado IBM Campaign. También debe modificar los scripts de inicio para el RCT y RLU de eMessage.
Procedimiento
v Para tráfico FTPS, aplique las siguientes configuraciones al RLU y al servidor de aplicaciones web.
Configuración Descripción
-Dibm.unica.emessage.ftps.proxy.host = <host_socks> Nombre de host o IP del proxy SOCKS.
-Dibm.unica.emessage.ftps.proxy.port = <puerto_socks> Puerto en el que se ejecuta el proxy SOCKS.
Configuración Descripción -Dibm.unica.emessage.ftps.proxy.match.hosts=
<lista separada por comas de nombres de host y direcciones IP>
Nombres de host y direcciones IP que se utilizan al direccionar tráfico mediante el proxy SOCKS. Proporcione valores específicos al centro de datos utilizado por la cuenta.
Cuando el entorno locales y el entorno hospedado establecen una conexión de datos, la dirección IP que se especifica para
-Dibm.unica.emessage.ftps.proxy.match.hostses la dirección IP que el servidor FTP remoto envía al cliente FTP local.
Establezca -Dibm.unica.emessage.ftps.proxy.match.hosts en uno de los valores siguientes. El valor que especifique dependerá del centro de datos que utilice la cuenta de correo electrónico hospedada.
Nombre de host y direcciones IP del centro de datos de EE.UU.: -Dibm.unica.emessage.ftps.proxy.match.hosts=
ftp-em.unicaondemand.com,192.86.44.132,192.86.44.133,192.86.44.134,192.86.45.132,192.86.45.133,192.86.45.134 Nombre de host y direcciones IP del centro de datos del Reino Unido:
-Dibm.unica.emessage.ftps.proxy.match.hosts=
ftp-em-eu.unicaondemand.com,192.86.45.132,192.86.45.133,192.86.45.134,192.86.44.132,192.86.44.133,192.86.44.134 v Para tráfico HTTPS, aplique las siguientes configuraciones al RCT y al servidor
de aplicaciones web.
Configuración Descripción
-Dibm.unica.emessage.https.proxy.host=<socksHost> Nombre de host o IP del proxy SOCKS
-Dibm.unica.emessage.https.proxy.port=<puerto_socks> Puerto en el que se ejecuta el proxy SOCKS
-Dibm.unica.emessage.https.proxy.type=SOCKS Tipo de servidor proxy. Debe utilizar un servidor proxy SOCKS.
Configuración de la autenticación para acceder a un proxy
SOCKS
Si el proxy SOCKS requiere autenticación, debe configurar el servidor de aplicaciones web, el RLU y el RCT para proporcionar las credenciales de acceso.
Procedimiento
Configure lo siguiente para el servidor de aplicaciones web, el RLU y el RCT. Los valores de nombre_usuario y contraseña deben ser las credenciales necesarias para la autenticación en el proxy.
-Dibm.unica.emessage.proxy.auth.user = <nombre_usuario> -Dibm.unica.emessage.proxy.auth.password = <contraseña>
Configuración del RCT para utilizar un proxy SOCKS
Debe modificar el RCT para la comunicación mediante un servidor proxy SOCKS. Los valores necesarios dependen del sistema operativo.
Procedimiento
v Para el RCT en entornos Windows, añada los siguientes argumentos de proxy a common.bat. El archivo common.bat se encuentra en el directorio //eMessage/bin de su instalación local de eMessage.
set RCT_PROXY_ARGS= -Dibm.unica.emessage.https.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.https.proxy.port=<PROXY_PORT> -Dibm.unica.emessage.https.proxy.type=SOCKS -Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER> -Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD> set RCT_JAVA_ARGS=%BASE_VM_ARGS% %RCT_MEM_ARGS%
%RCT_EXTRA_VM_ARGS% %RCT_PROXY_ARGS%
v Para el RCT en entornos UNIX, añada los siguientes argumentos de proxy a common.sh. El archivo common.sh se encuentra en el directorio \\eMessage\bin de su instalación local de eMessage.
Nota: No modifique directamente rlu.sh, rct.sh o setenv.sh. El sistema anula temporalmente los cambios.
RCT_PROXY_ARGS=" -Dibm.unica.emessage.https.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.https.proxy.port=<PROXY_PORT> -Dibm.unica.emessage.https.proxy.type=SOCKS -Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER> -Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>" RCT_JAVA_ARGS="${BASE_VM_ARGS} ${RCT_MEM_ARGS} ${RCT_EXTRA_VM_ARGS} ${RCT_PROXY_ARGS}"
Configuración del RLU para utilizar un proxy SOCKS
Debe modificar el RLU para la comunicación mediante un servidor proxy SOCKS. Los valores necesarios dependen del sistema operativo.
Procedimiento
v Para el RLU en entornos Windows, añada los siguientes argumentos de proxy a common.bat.El archivo common.bat se encuentra en el directorio //eMessage/bin de su instalación local de eMessage.
set RLU_PROXY_ARGS=
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD> set RLU_JAVA_ARGS=%BASE_VM_ARGS% %RLU_MEM_ARGS% %RLU_EXTRA_VM_ARGS% %RLU_PROXY_ARGS%
v Para el RLU en entornos UNIX, añada los siguientes argumentos de proxy a common.sh. El archivo common.sh se encuentra en el directorio \\eMessage\bin de su instalación local de eMessage.
Nota: No modifique directamente rlu.sh, rct.sh o setenv.sh. El sistema anula temporalmente los cambios.
RLU_PROXY_ARGS="
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>" RLU_JAVA_ARGS="${BASE_JAVA_ARGS} ${RLU_MEM_ARGS} ${RLU_EXTRA_VM_ARGS} ${RLU_PROXY_ARGS}"
Configuración del servidor de aplicaciones web para utilizar un
proxy SOCKS
Para conectar a IBM EMM Hosted Services mediante un proxy SOCKS, debe modificar la configuración del servidor de aplicaciones web. Para servidores IBM WebSphere, puede modificar los argumentos JVM genéricos. Para servidores Oracle Weblogic, puede modificar el script SetDomainEnv.
Procedimiento
v Si el servidor de aplicaciones web es IBM WebSphere, añada lo siguiente a los argumentos JVM genéricos de WebSphere.
-Dibm.unica.emessage.https.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.https.proxy.port=<PROXY_PORT> -Dibm.unica.emessage.https.proxy.type=SOCKS -Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>
v Si el servidor de aplicaciones web es Oracle Weblogic, modifique el script setDomainEnv. Los valores necesarios dependen del sistema operativo. En entornos Windows, realice los cambios siguientes:
JAVA_OPTIONS =%{JAVA_OPTIONS} -Dibm.unica.emessage.https.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.https.proxy.port=<PROXY_PORT> -Dibm.unica.emessage.https.proxy.type=SOCKS -Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD> En entornos UNIX, realice los cambios siguientes:
JAVA_OPTIONS ='${JAVA_OPTIONS} -Dibm.unica.emessage.https.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.https.proxy.port=<PROXY_PORT> -Dibm.unica.emessage.https.proxy.type=SOCKS -Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST> -Dibm.unica.emessage.ftps.proxy.port=<POXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
Valor de puerto y frecuencia de descarga de datos
Como parte de la instalación de IBM Campaign, se instala un componente de eMessage denominado Rastreador de respuestas y contactos (RCT). El RCT solicita regularmente datos de respuestas y contactos de correo electrónico a IBM EMM Hosted Services. De forma predeterminada, el RCT emite una solicitud de datos cada 5 segundos.
El RCT emite las solicitudes de datos sobre HTTPS (HTTP sobre SSL). IBM EMM Hosted Services acepta las solicitudes de conexión HTTPS en el puerto 443, y únicamente de aquellos hosts que haya especificado durante el proceso de inicio de cuenta de correo electrónico alojada.
Conceptos relacionados:
Capítulo 4, “Operación del rastreador de respuestas y contactos”, en la página 33
Requisito del usuario del sistema para acceder a IBM EMM Hosted
Services
Los componentes de eMessage tienen que poder acceder a IBM EMM Hosted Services sin que sea necesario especificar manualmente las credenciales de inicio de sesión. Para establecer el inicio de sesión automático, defina un usuario del sistema en Marketing Platform que pueda proporcionar las credenciales de acceso
necesarias.
Para simplificar la administración de usuario y la resolución de problemas, puede modificar un usuario del sistema existente para que acceda a los servicios alojados y las tablas del sistema local. Puede configurar un único usuario del sistema que suministre las credenciales a diversos sistemas. Por ejemplo, modificando la configuración del usuario del sistema de Campaign se crea un único usuario que puede acceder automáticamente a las tablas del sistema de IBM EMM Hosted Services y de eMessage del esquema Campaign.
La credencial necesaria para acceder a IBM EMM Hosted Services son el nombre de usuario y la contraseña que IBM proporciona para la cuenta de mensajería alojada. Las credenciales que utilice dependen de si se está conectando al centro de datos que mantiene IBM en los Estados Unido o al centro de datos del Reino Unido. Consulte a IBM el centro de datos que debe utilizar.
Para obtener información específica sobre cómo configurar un usuario del sistema para comunicarse con IBM EMM Hosted Services, consulte la Guía del administrador
y de inicio de IBM eMessage.
Para obtener información general sobre cómo crear usuarios del sistema y orígenes de datos, consulte la publicación IBM Marketing Platform, Guía del administrador.
Requisito para el acceso de partición a IBM EMM Hosted
Services
Se debe permitir que los componentes de IBM eMessage en la partición
proporcionen automáticamente credenciales de inicio de sesión válidas al intentar comunicarse con los servicios alojados de IBM EMM Hosted Services. Para ello,
debe añadir las credenciales de inicio de sesión de IBM EMM Hosted Services a un usuario de Marketing Platform. Este usuario se convierte en el usuario de sistema de eMessage.
Puede añadir el origen de datos de la plataforma que contiene las credenciales de IBM EMM Hosted Services al usuario del sistema de eMessage. Este usuario puede ser el mismo usuario del sistema que accede a las tablas del sistema de Campaign en la partición.
Los pasos para configurar usuarios del sistema para una partición son los mismos que los que se siguen durante la instalación inicial de eMessage, que ha creado la primera partición. Para obtener detalles sobre cómo añadir credenciales de inicio de sesión a un usuario del sistema de IBM EMM Hosted Services, consulte la publicación IBM eMessage Guía del administrador y de inicio.
Las credenciales necesarias para acceder a IBM EMM Hosted Services son el nombre de usuario y la contraseña que IBM ha proporcionado durante el proceso de inicio.
Importante: Para cada partición adicional, debe solicitar a IBM.
Configuración del usuario del sistema que accede a IBM EMM
Hosted Services
Los componentes de eMessage en Campaign deben poder acceder a IBM EMM Hosted Services automáticamente, sin que se le solicite un inicio de sesión. Los usuarios del sistema configurados en IBM Marketing Platform pueden hacer referencia a un origen de datos que proporcione el nombre de usuario y contraseña necesarios. Puede añadir el origen de datos a un usuario del sistema nuevo o a cualquier usuario del sistema existente. Para simplificar la administración de usuarios, puede actualizar un usuario del sistema que ya esté configurado para acceder al esquema de Campaign para que pueda acceder también a IBM EMM Hosted Services.
Antes de empezar
Para completar esta tarea, debe conocer el nombre de usuario y la contraseña de IBM EMM Hosted Services que IBM ha asignado a su cuenta de correo electrónico alojada. La recepción del nombre de usuario y la contraseña forma parte del proceso de inicio de la cuenta..
Debe tener los permisos de acceso adecuados y saber cómo crear usuarios del sistema y orígenes de datos en IBM Marketing Platform.
Acerca de esta tarea
Nota: Si su instalación contiene diversas particiones, debe llevar a cabo esta tarea para cada una de las particiones. No se pueden compartir usuarios de sistema entre distintas particiones.
Procedimiento
1. Cree un origen de datos de plataforma que contenga el nombre de usuario y la contraseña necesarios para acceder a IBM EMM Hosted Services. Para obtener los mejores resultados y facilitar el mantenimiento, ponga a este origen de datos el nombre UNICA_HOSTED_SERVICES. Configure este origen de datos como se indica a continuación.
En Inicio de sesión en origen de datos, escriba el nombre de usuario que ha recibido de IBM durante el proceso de inicio de la cuenta.
En Contraseña en origen de datos, escriba la contraseña que ha recibido de IBM durante el proceso de inicio de la cuenta.
2. Especifique el origen de datos en la configuración de eMessage. Utilice la propiedad de configuración amDataSourceForAcctCredentials.
Esta propiedad de configuración se encuentra en eMessage > partitions > partition[n] > hostedAccountInfo > amDataSourceForAcctCredentials. De forma predeterminada, el origen de datos especificado es
UNICA_HOSTED_SERVICES.
3. Especifique un usuario del sistema para acceder a IBM EMM Hosted Services. Puede especificar un usuario existente o crear un usuario. En la configuración de eMessage, utilice la propiedad de configuración amUserForAcctCredentials. Esta propiedad de configuración se encuentra en eMessage > partitions > partition[n] > hostedAccountInfo > amUserForAcctCredentials.
De forma predeterminada, el usuario predeterminado es asm_admin.
4. Añada el origen de datos configurado en el Paso 1 al usuario del sistema especificado en el Paso 3.
Qué hacer a continuación
Debe reiniciar el servidor de aplicaciones web para que los cambios tengan efecto.
Conceptos relacionados:
“Conexión de carga predeterminada mediante FTP explícito” en la página 13 “Confirmación de las configuraciones del sistema” en la página 37
Configuración de direcciones para conectarse a IBM EMM Hosted
Services
Para garantizar la correcta conexión con IBM EMM Hosted Services, debe
especificar las direcciones como valores de las propiedades de configuración en la configuración de eMessage. Las direcciones de conexión que especifique
dependerán de si se conecta al centro de datos de IBM de Estados Unidos o al centro de datos de IBM del Reino Unido.
Antes de empezar
Consulte IBM para confirmar el centro de datos que utiliza su cuenta de correo electrónico alojada.
Procedimiento
En IBM Marketing Platform, vaya a Valores > Configuración. En la configuración de eMessage, vaya a las siguientes propiedades de configuración eMessage y confirme o actualice los valores de conexión, según el centro de datos que utilice su cuenta.
Si su cuenta se conecta al centro de datos de EE.UU. utilice los valores predeterminados.
v eMessage > serverComponentsAndLocations > hostedServices> uiHostName El valor predeterminado es em.unicaondemand.com.
Para conectar con el centro de datos de IBM del Reino Unido, cambie este valor a
em-eu.unicaondemand.com.
v eMessage > serverComponentsAndLocations > hostedServices> dataHostName El valor predeterminado es em.unicaondemand.com.
Para conectar con el centro de datos de IBM del Reino Unido, cambie este valor a
em-eu.unicaondemand.com.
v eMessage > serverComponentsAndLocations > hostedServices> ftpHostName El valor predeterminado es ftp-em.unicaondemand.com.
Para conectar con el centro de datos de IBM del Reino Unido, cambie este valor a
ftp-em-eu.unicaondemand.com.
Qué hacer a continuación
Si cambia una propiedad de configuración, reinicie el servidor de aplicaciones web para aplicar los cambios.
Conceptos relacionados:
“Conexión de carga predeterminada mediante FTP explícito” en la página 13
Configuración de la comunicación segura para el correo electrónico
alojado
Las comunicaciones entre el usuario de marketing de correo electrónico y IBM EMM Hosted Services se producen sobre SSL (Secure Sockets Layer). Debe cambiar la configuración del servidor de aplicaciones web para que utilice SSL. Para hacer los cambios necesarios se debe utilizar el programa de utilidad Java™keytool.
Para configurar la comunicación segura se requieren las siguientes acciones. v Generar un almacén de claves de confianza.
v Obtener un certificado digital de IBM EMM Hosted Services.
v Añadir el almacén de claves de confianza al servidor de aplicaciones web. v Importar el certificado digital de IBM EMM Hosted Services en el almacén de
claves de confianza.
Los pasos exactos y la secuencia necesarios para configurar SSL dependen del tipo y la versión del servidor de aplicaciones web (WebSphere o WebLogic) en el que haya desplegado IBM Marketing Platform y IBM Campaign.
Para WebLogic, consulte “Configuración de SSL al utilizar WebLogic” en la página 28.
Para WebSphere, consulte “Cómo configurar SSL para utilizar IBM WebSphere” en la página 31.
Generar un almacén de claves de confianza
Siga este procedimiento para crear un almacén de claves de identidades y un almacén de claves confianza para configurar IBM eMessage para comunicarse con IBM EMM Hosted Services por SSL. Los almacenes de claves se añaden al servidor de aplicaciones web al configurar SSL.
Acerca de esta tarea
IBM utiliza los siguientes valores de muestra en los procedimientos de este apartado.
v Almacén de claves de identidades: IBMUnicaClientIdentity.jks v Alias del almacén de claves de identidades: IBMUnicaClientIdentity v Contraseña (-storepass) del almacén de claves de identidades: clientPwd v Clave de seguridad (-keypass) del almacén de claves de identidades: clientPwd v Certificado basado en el almacén de claves de identidades:
ClientCertificate.cer
v Almacén de claves de confianza: IBMUnicaTrust.jks
v Contraseña (-storepass) del almacén de claves de confianza: trustPwd Los valores reales que especifique debe ser específicos de la instalación.
Para completar los pasos de este procedimiento, ejecute el programa de utilidad keytool de Java desde la línea de comandos.
Procedimiento
1. Genere un almacén de claves de identidades. Utilice el comando genkey, como se muestra en el siguiente ejemplo.
En este ejemplo se crea un almacén de claves de identidades denominado IBMUnicaClientIdentity.jks. Puede utilizar un nombre distinto para el almacén de claves de identidades que cree usted.
keytool -genkey -alias IBMUnicaClientIdentity -keyalg RSA -keystore
<IBMUnicaClientIdentity.jks> -keypass <clientPwd> -validity 1000 -dname
"CN=hostName, O=myCompany" -storepass <clientPwd> Tenga en cuenta lo siguiente.
v Utilizará los valores de alias, keystore, keypass, y storepass más adelante en este procedimiento y cuando configure SSL en el servidor de aplicaciones web.
v Para WebSphere 6.0, la contraseña del almacén de claves (-storepass) y la contraseña de clave (-keypass) deben ser la misma.
v En el nombre distinguido (-dname) el nombre común (CN) es el mismo que el nombre de host utilizado para acceder a IBM EMM. Por ejemplo, si el URL de IBM EMM es https://hostName.example.com:7002/unica/jsp, el CN es hostName.example.com. La parte de CN del nombre distinguido es la única parte obligatoria; la organización (O) y la unidad organizativa (OU) no son obligatorias.
2. Genere un certificado basado en el almacén de claves de identidades. Utilice el comando export, como se muestra en el siguiente ejemplo.
En este ejemplo se genera un certificado denominado ClientCertificate.cer. Puede utilizar un nombre distinto para el certificado que cree usted.
Los valores de keystore, storepass, y alias deben coincidir con los valores que haya especificado en el almacén de claves de identidades.
keytool -export -keystore <IBMUnicaClientIdentity.jks> -storepass
<clientPwd> -alias IBMUnicaClientIdentity -file <ClientCertificate.cer>
3. Genere el almacén de claves de confianza. Utilice el comando import, como se muestra en el siguiente ejemplo.
En este ejemplo se genera un almacén de claves de confianza denominado IBMUnicaTrust.jks. Puede utilizar un nombre distinto para el almacén de claves de confianza que cree usted.
keytool –import -alias IBMUnicaClientIdentity -file
<ClientCertificate.cer> -keystore <IBMUnicaTrust.jks> -storepass <trustPwd>
Escriba Y cuando se le solicite si desea confiar en el certificado.
Qué hacer a continuación
Anote los valores que ha definido para las siguientes variables. Sus valores pueden ser diferentes de los valores que aparecen en el ejemplo.
v alias(en el ejemplo: IBMUnicaClientIdentity)
v identity keystore (en el ejemplo: IBMUnicaClientIdentity.jks)
v storepass(en el ejemplo: trustPwd) El valor de storepass del almacén de claves de confianza puede ser distinto del valor de storepass del almacén de claves de identidades y del certificado.
v keystore (en el ejemplo: IBMUnicaTrust.jks) Según su servidor de aplicaciones web, deberá especificar también el almacén de claves de identidades.
Estos valores específicos de la instalación se especifican al configurar SSL en el servidor de aplicaciones web de la instalación de IBM EMM.
Configuración de SSL al utilizar WebLogic
En esta sección se describen los pasos necesarios para configurar SSL al desplegar componentes de IBM EMM en Oracle WebLogic. Este cambio es necesario para permitir que los componentes de eMessage que operan dentro de Campaign puedan comunicarse con IBM EMM Hosted Services sobre SSL.
Acerca de esta tarea
Para obtener instrucciones específicas sobre cómo navegar y trabajar con la interfaz de usuario de Oracle WebLogic, consulte la documentación para la versión
específica de Oracle WebLogic que está utilizando.
Procedimiento
Realice las siguientes tareas.
v Modifique el script de inicio de WebLogic v Modifique la configuración de WebLogic
v Obtenga un certificado digital de IBM EMM Hosted Services
v Cree un almacén de claves de confianza e importe el certificado digital de IBM
Modificación del script de inicio WebLogic
Si ha desplegado Campaign en WebLogic, debe modificar el script de inicio de WebLogic y la configuración de WebLogic para SSL de forma que WebLogic reconozca y acepte la comunicación segura entre los componentes de eMessage instalados localmente y IBM EMM Hosted Services.
Procedimiento
Añada el argumento siguiente a las JAVA_OPTIONS en el script de inicio de WebLogic.
v -Dweblogic.security.SSL.allowSmallRSAExponent=true v WebLogic versión 12c o superior:
-Dweblogic.security.SSL.protocolVersion=TLS1
Todas las versiones anteriores: -Dweblogic.security.SSL.nojce=true
Modifique la configuración de WebLogic
Debe modificar la configuración de SSL en WebLogic.
Procedimiento
Puede utilizar la consola de WebLogic para realizar el siguiente cambio en la configuración de SSL de su dominio.
Cambie el valor de Verificación del nombre de host a Ninguna.
Obtener un certificado de IBM EMM Hosted Services
Para configurar la comunicación por SSL, debe descargar un certificado digital de IBM EMM Hosted Services. Los detalles del certificado se guardan en un archivo con extensión .cer que puede importar en el almacén de claves del servidor de aplicaciones web.
Acerca de esta tarea
Cuando el certificado SSL existente caduque, perderá el acceso a IBM EMM Hosted Services. Puede utilizar este procedimiento para descargar un nuevo certificado.
Procedimiento
1. En Internet Explorer, inicie sesión en la dirección de IBM EMM Hosted Services que se haya configurado para su cuenta de correo electrónico alojada.
v Para el centro de datos de Estados Unidos, vaya a https:// em.unicaondemand.com
v Para el centro de datos del Reino Unido, vaya a https://em-eu.unicaondemand.com
El intento de inicio falla, pero le permite utilizar el navegador para enviar la solicitud de certificado.
2. Pulse en el icono de bloqueo y seleccione Ver certificado.
3. Seleccione la pestaña Detalles y después seleccione Copiar a un archivo. Guarde el archivo con extensión .cer en una ubicación que sea accesible para el servidor de aplicaciones web. El archivo que ha creado es el certificado digital que insertará en el almacén de claves del servidor de aplicaciones web. Por ejemplo, guarde el certificado con el nombre IBMHosted.cer.
Crear un almacén de claves de confianza de WebLogic e
importar el certificado digital de IBM
Para Weblogic, debe crear un almacén de claves de confianza que acepte el certificado de IBM.
Antes de empezar
Antes de empezar, utilice un navegador web para descargar el certificado digital de IBM EMM Hosted Services y guárdelo como un archivo .cer. Por ejemplo, el certificado puede denominarse IBMHosted.cer (su nombre de archivo puede ser diferente). Para obtener información detallada adicional, consulte “Obtener un certificado de IBM EMM Hosted Services” en la página 29.
Acerca de esta tarea
IBM utiliza los siguientes valores de muestra en los procedimientos de este apartado.
v Almacén de claves de identidades: IBMUnicaClientIdentity.jks v Contraseña del almacén de claves de identidades: clientPwd v Almacén de claves de confianza: IBMUnicaTrust.jks
v Alias del almacén de claves de confianza: IBMUnicaHostedIdentity v Contraseña (-storepass) del almacén de claves de confianza: trustPwd v Certificado digital (-file) de IBM: IBMHosted.cer
Los valores reales que especifique debe ser específicos de la instalación.
Para completar los pasos de este procedimiento, ejecute el programa de utilidad keytool de Java desde la línea de comandos.
Procedimiento
1. Generar un almacén de claves de confianza para WebLogic. Para obtener información detallada, consulte “Generar un almacén de claves de confianza” en la página 27.
Debe especificar el almacén de claves de identidad y el almacén de claves de
confianza en la configuración de WebLogic.
2. Utilice el comando importación en el programa de utilidad keytool para añadir el certificado de IBM EMM Hosted Services al almacén de claves de confianza creado en el Paso 1, como se muestra en el siguiente ejemplo. Utilice el certificado digital que ha descargado de IBM.
En este procedimiento, también se define un alias para el almacén de claves de confianza. keytool -import -alias IBMUnicaHostedIdentity -file
<IBMHosted.cer> -keystore <IBMUnicaTrust.jks> -storepass <trustPwd> Escriba Y cuando se le solicite si desea confiar en el certificado.
3. En la consola de administración de WebLogic, configure los almacenes de claves para el servidor.
Para especificar las reglas de configuración, seleccione la opción correspondiente a almacenes de claves de identidades y de confianza
personalizados entre de las opciones disponibles. En Identidad personalizada, debe especificar el almacén de claves de identidades. En Confianza
personalizada, debe especificar el almacén de claves de confianza. Por ejemplo, en la consola de administración, especifique lo siguiente
(utilizando los valores del ejemplo del almacén de claves de confianza que ha creado en el paso 1).
v En Identidad: especifique el almacén de claves de identidades y la contraseña asociada.