Instala WalkMe en Salesforce Lightning Communities utilizando un proxy inverso.
¡Llevemos WalkMe a tus usuarios!
Salesforce Lightning Communities no permite a los administradores añadir el fragmento de WalkMe al código HTML, por lo que utilizamos un proceso llamado Proxy Inverso para implementar WalkMe.
Uso de un proxy inverso
Un proxy inverso no requiere ninguna configuración en el lado del cliente. Los usuarios simplemente solicitan la página web y el servidor proxy solicitará la página de Salesforce con el fragmento de WalkMe colocado en el encabezado de la página. Esto te permite implementar WalkMe a todos los usuarios externos sin pedirles que instalen nada.
Cómo funciona
Un proxy inverso te permite modificar la página web final entregada a un usuario. En este caso, el proxy inverso añade el fragmento de WalkMe al encabezado de la página antes de entregarlo al usuario final.
El cliente (también conocido como usuario) solicita la página web utilizando la URL de tu dominio. Esto se envía a tu DNS, pero en lugar de simplemente entregar la página web desde Salesforce, envía una solicitud al servidor CDN con el proxy inverso en él. El proxy inverso solicita la página a Salesforce y coloca el fragmento de WalkMe en el código HTML y entrega la página al cliente.
Antes de comenzar.
Para utilizar el Proxy inverso para implementar el fragmento de WalkMe, debes tener lo siguiente:
- Una URL que sea parte del dominio para la configuración de la comunidad, por ejemplo, community.companyname.com.
- Servidor CDN que se puede configurar como un proxy inverso.
1. Obtener la URL del CNAME de Salesforce.
La forma más fácil de obtener la URL del CNAME es intentar configurar el dominio sin una configuración de proxy. Esto crea un mensaje de error con el CNAME incluido.
- Desde Salesforce, haz clic en Configuración.
- En Administrador, haz clic en Gestión de dominio.
- Haz clic en Dominios
- Haz clic en Añadir un dominio.
- Escribe el nombre de dominio de tu comunidad.
- Haz clic en Guardar. Aparecerá un mensaje de error.
- Desde el mensaje de error, copia el registro CNAME que apunta a [dominio].00dXXXXXXXXXX.live.siteforce.com. El CNAME se utiliza para configurar el servidor proxy.
- Continúa con, 2. Configuración del servidor proxy CDN.
2. Configuración del servidor proxy CDN.
- Desde el servidor CDN, crea un proxy inverso que retransmita tu dominio al registro CNAME copiado de la sección 1. Obteniendo la URL del CNAME de Salesforce, [domain].00dXXXXXXXXXX.live.siteforce.com.
- Configura un filtro alternativo para capturar y modificar las solicitudes de proxy, como se muestra a continuación. Debes añadir la URL del fragmento de WalkMe al código proporcionado.
Busca:
</headReemplaza:
<script type="text/javascript">(function() {var walkme = document.createElement("script"); walkme.type = "text/javascript"; walkme.async = true; walkme.src = "${WALKME_SNIPPET_URL}"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(walkme, s); window._walkmeConfig = {smartLoad:true}; })();</script></head - Asegúrate de que el encabezado Host de la solicitud proxy mantenga tu dominio personalizado, por ejemplo, proxy_set_header Host $http_host;
- Asegúrate de que el proxy inverso sirva al dominio personalizado a través de HTTPS.
- Espera 1 hora para que el CDN se actualice antes de continuar con la sección 3. Crea, activa y configura tu dominio en Salesforce.
3. Crea, activa y configura tu dominio en Salesforce.
- Desde Salesforce, haz clic en Configuración.
- En Administrar, haz clic en Gestión de dominio.
- Haz clic en Dominios
- Haz clic en Añadir un dominio.
- Escribe el nombre de dominio de tu comunidad.
- Haz clic en Guardar.
- Desde Dominios en Salesforce, haz clic en Activar junto a tu dominio.
- Desde tu servidor DHCP, configura el registro DNS en tu nuevo servidor proxy.
- Desde Dominios en Salesforce, haz clic en tu dominio para editarlo. Aparece la página Editar dominio.
- Selecciona "Sirves el dominio a través de HTTPS, utilizando tu propio socio de CDN o tu propio hardware".
- Haz clic en Guardar. Aparecerá la página Detalles del dominio.
- Haz clic en "Nueva URL personalizada" desde las URL personalizadas.
- Escribe el nombre del sitio (Nombre de la Comunidad, también conocido como AKA).
- Haz clic en Guardar
4. Prueba de la implementación del proxy inverso.
Recomendamos probar la implementación con la ayuda de tu Gerente de Éxito del Cliente (CSM). Para probar la implementación, debes publicar desde el Editor de WalkMe. Dado que El proxy inverso requiere que publiques solo en un entorno de producción, sugerimos trabajar con tu CSM para garantizar que esto tenga un impacto mínimo en los usuarios finales.
Al probar una nueva implementación, debes publicar los archivos de configuración asociados a tu cuenta de editor. No es necesario publicar ningún contenido específico para que aparezca la pestaña del reproductor de WalkMe en tu sitio. La publicación solo de archivos de configuración se conoce a menudo como "publicación en blanco".