Skip to main content

Guide d’installation de BriefCam

Configuration d’un environnement distribué RESEARCH et des services Web

Last Updated: 3 minute read
Version2024r2
LangueFrançais

Si vous travaillez dans un environnement distribué où le composant Services Web et le composant RESEARCH se trouvent sur des machines distinctes, vous devez effectuer l'une des opérations suivantes :

  • Utilisez un équilibreur de charge (voir : Installer et configurer NGINX)

  • Utiliser un FQDN (de préférence) ou un alias / CNAME - Si vous utilisez déjà un domaine, utilisez un nom pleinement qualifié (FQDN). Si les serveurs ne font pas partie d’un domaine (pas de FQDN), utilisez un alias/CNAME. Des détails sur la façon de le faire sont fournis ci-dessous.

Vous devez effectuer ces configurations car l’application Web de BriefCamconsomme le composant RESEARCH à partir d’un IFrame (un élément HTML qui est utilisé pour insérer du contenu provenant d’une autre source - un tiers). Les navigateurs les plus récents ont amélioré leur sécurité et empêchent désormais l’envoi de cookies avec les requêtes intersites.

La solution consiste à configurer les cookies pour qu’ils soient des cookies de première partie (même site) (lorsque le domaine dans la barre URL du navigateur correspond à votre domaine de cookie).

Pour ce faire, vous devez utiliser le FQDN afin que le suffixe du domaine soit le même pour tous les serveurs, comme indiqué en jaune dans les exemples ci-dessous. Si vous utilisez uniquement le nom d’hôte, tel que « synopsis » ou « research » dans les exemples ci-dessous, il n’y a pas de suffixe de domaine et les cookies ne sont pas partagés entre les sites.

Par exemple :

  • synopsis.your-domain.com

  • research.your-domain.com

Si vous avez un équilibreur de charge configuré, vous n’aurez pas ce problème. Pour plus d’informations à ce sujet, consultez Installer et configurer NGINX.

Si vous utilisez l’option FQDN ou alias/CNAME, vous devez procéder comme suit :

  1. Si vous utilisez un nom pleinement qualifié (FQDN), trouvez le FQDN de votre serveur en cliquant sur le menu Système dans le Panneau de configuration. Vous verrez le FQDN de votre machine (s’il existe).

    FQDN.png

  2. Dans la section Environment Settings (Paramètres d' environnement du BriefCam Administrator Console), modifiez le paramètre QlikServer et changez-le en FQDN ou en alias/CNAME. Par exemple, si votre nom de domaine est : www.test.com, utilisez : research.test.com.

  3. Sur la machine Web Services, modifiez le fichier webConfig.js de ProWebClient (situé à l’adresse suivante : C:\Program Files\BriefCam\WebServices\ProWebClient\webConfig.js) et remplacez le nom d’hôte par le FQDN ou l’alias/CNAME. Par exemple :

    const endPointApi = "//www.test.com/prowebapi"; const matomoSiteID = 10; const reCaptchaKey = "";

  4. Sur la machine Web Services, modifiez le fichier web.config.js de ProWebAdminClient (situé à l’adresse : C:\Program Files\BriefCam\WebServices\ProWebAdminClient\web.config.js et remplacez le nom d’hôte par le FQDN ou l’alias/CNAME. Par exemple :

    const endPointApi = "//www.test.com/AdminApi/";

  5. Entrez dans Qlik QMC > Virtual proxies (https://localhost/qmc/virtualproxies) et modifiez le proxy bc .

  6. Ouvrez l'onglet Avancé et ajoutez le nouveau nom d’hôte de la machine RESEARCH (le FQDN ou l’alias/CNAME) dans la liste verte des hôtes. Par exemple :

    QMC host allow list.png

  7. Cliquez sur Appliquer.

  8. Revenez sur Proxies virtuels et modifiez le proxy central (par défaut).

  9. Ouvrez l'onglet Avancé et ajoutez le nouveau nom d’hôte de la machine RESEARCH (le FQDN ou l’alias/CNAME) dans la liste verte des hôtes. Par exemple :

    QMC host allow list Central.png

  10. Cliquez sur Appliquer.

  11. Lorsque vous ouvrez le Web Client ou le BriefCam Administrator Console, veillez à utiliser le nouveau nom d’hôte dans l’URL. Par exemple :

    http://www.test.com/app

    http://www.test.com/admin