Help Center
Bienvenue au centre d’aide WalkMe

Please login in order to continue:

Work flows better with WalkMe
Work flows better with WalkMe.

Installer WalkMe sur les communautés Salesforce Lightning à l’aide du proxy inverse

Last Updated janvier 3, 2022

Offrez WalkMe à vos utilisateurs !

Les communautés Salesforce Lightning n'autorisent pas les administrateurs à ajouter l'extrait WalkMe dans le code HTML, nous utilisons donc un processus appelé Reverse Proxy (Proxy inverse) pour déployer WalkMe.

Utilisation du proxy inverse

Un proxy inverse ne nécessite aucune configuration côté client. Vos utilisateurs demandent simplement la page Web et votre serveur proxy demandera la page à Salesforce avec l'extrait WalkMe placé dans l'en-tête de la page. Cela vous permet de déployer WalkMe sur tous les utilisateurs externes sans leur demander d'installer quoi que ce soit.

Comment ça marche

Un proxy inverse vous permet de modifier la page Web finale fournie à un utilisateur. Dans ce cas, le proxy inverse ajoute l'extrait WalkMe dans l'en-tête de page avant de le remettre à l'utilisateur final.

Le client (càd l'utilisateur) demande la page Web à l'aide de l'URL de votre domaine. Ceci est envoyé à votre DNS, mais au lieu de simplement fournir la page Web de Salesforce, il envoie une demande au serveur CDN avec le proxy inverse dessus. Le proxy inverse demande ensuite la page à Salesforce et place l'extrait WalkMe dans le code HTML et remet la page au client.

Avant de commencer

Pour utiliser Reverse Proxy (proxy inverse) pour déployer l'extrait de code WalkMe, vous devez disposer des éléments suivants :

  • Une URL qui fait partie de votre domaine pour la configuration de la communauté, par ex. communauté.nomsociété.com
  • Un serveur CDN qui peut être configuré comme proxy inverse
Remarque importante sur le test

Vous ne pouvez pas tester un proxy inverse dans un environnement Salesforce Sandbox. Salesforce ne vous permet pas de tester des domaines personnalisés dans un environnement Sandbox, donc tous les tests doivent être effectués dans un environnement de production.

Notez également que les domaines racine personnalisés (par exemple, http://mydomain.org) ne peuvent pas être ajoutés dans Salesforce. Vous pouvez uniquement ajouter des sous-domaines comme suit, http://www.mydomain.org.

1. Obtenir votre URL CNAME à partir de Salesforce

1. Obtenir votre URL CNAME à partir de Salesforce

Accès administrateur

Vous devez être connecté en tant qu'administrateur Salesforce pour achever le processus suivant.

Le moyen le plus simple d'obtenir l'URL CNAME est d'essayer de configurer le domaine sans configuration de proxy. Cela crée un message d'erreur avec le CNAME inclus.

  1. Dans Salesforce, cliquez sur Configuration
  2. Sous Administrer, cliquez sur Gestion de domaine
  3. Cliquez sur Domaines
  4. Cliquez sur Ajouter un domaine
  5. Saisissez un nom de domaine pour votre communauté.
  6. Cliquez sur Enregistrer. Un message d'erreur apparaîtra
  7. À partir du message d'erreur, copiez l'enregistrement CNAME qui pointe vers [domain].00dXXXXXXXXXX.live.siteforce.com. Le CNAME est utilisé pour configurer un serveur de proxy
  8. Passez à 2. Configuration de votre serveur proxy CDN

2. Configuration de votre serveur proxy CDN

2. Configuration de votre serveur proxy CDN

Vous devez avoir l'enregistrement CNAME de la section précédente

  1. À partir du serveur CDN, créez un proxy inverse qui relaie votre domaine vers l'enregistrement CNAME copié à partir de la section 1. Obtention de votre URL CNAME auprès de Salesforce, [domain].00dXXXXXXXXXX.live.siteforce.com
  2. Configurez un filtre de substitution pour capturer et modifier les requêtes proxy, comme indiqué ci-dessous. Vous devez ajouter l'URL du Snippet WalkMe au code fourni.

    Dans cet exemple, $ {WALKME_SNIPPET_URL}est l'URL du snippet tel qu'il apparaît dans l'éditeur. Où trouver l'extrait WalkMe dans l'éditeur WalkMe

    Trouver :
    </head
    Remplacer :
    <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
  3. Assurez-vous que l'en-tête d'hôte de la demande proxy, conserve votre domaine personnalisé, par exemple, proxy_set_header hôte $http_host ;
  4. Assurez-vous que le proxy inverse sert le domaine personnalisé via HTTPS.
  5. Attendez 1 heure pour permettre au CDN de se mettre à jour avant de passer à la section 3. Créer, activer et configurer votre domaine dans Salesforce

3. Créer, activer et configurer votre domaine dans Salesforce

3. Créer, activer et configurer votre domaine dans Salesforce

Attendez 1 heure après avoir terminé la section 2. Configuration de votre serveur proxy CDN pour permettre au CDN de se mettre à jour

  1. Dans Salesforce, cliquez sur Configuration
  2. Sous Administrer, cliquez sur Gestion de domaine
  3. Cliquez sur Domaines
  4. Cliquez sur Ajouter un domaine
  5. Saisissez un nom de domaine pour votre communauté.
  6. Cliquez sur ENREGISTRER.
  7. Dans Domaines dans Salesforce, cliquez sur Activer à côté de votre domaine.
  8. Depuis votre serveur DHCP, configurez l'enregistrement DNS sur votre nouveau serveur proxy
  9. Depuis Domaines dans Salesforce, cliquez sur votre domaine pour le modifier. La page de modification du domaine apparaît
  10. Sélectionnez « Vous servez le domaine via HTTPS, en utilisant votre propre partenaire CDN ou votre propre matériel »
  11. Cliquez sur ENREGISTRER. La page de détails du domaine apparaîtra
  12. Dans les URL personnalisées, cliquez sur « Nouvelle URL personnalisée »
  13. Tapez le nom du site (càd le nom de la communauté)
  14. Cliquez sur Enregistrer

4. Test de votre implémentation de proxy inverse

4. Test de votre implémentation de proxy inverse

Nous vous recommandons fortement de tester votre implémentation avec l'aide de votre CSM. Pour tester votre implémentation, vous devez publier à partir de l'éditeur WalkMe. Depuis Le proxy inverse nécessite que vous publiiez uniquement dans un environnement de production, nous vous suggérons de travailler avec votre CSM pour vous assurer que cela a un impact minimal sur vos utilisateurs finaux.

Lorsque vous testez une nouvelle implémentation, vous devez publier les fichiers de paramètres associés à votre compte d'éditeur. Vous n'avez pas besoin de publier de contenu spécifique pour voir l'onglet lecteur WalkMe apparaître sur votre site. La publication uniquement des fichiers de paramètres est souvent appelée « publication vierge ».

Cet article a-t-il été utile?

Merci pour votre avis!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×