Skip to main content

BriefCam Installationsanleitung

Konfigurieren einer verteilten Umgebung für RESEARCH- und Webdienste

Last Updated: 2 minute read
Version2024r2
SpracheDeutsch

Wenn Sie mit einer verteilten Umgebung arbeiten, bei der sich die Webdienste-Komponente und die RESEARCH-Komponente auf separaten Systemen befinden, müssen Sie entweder eine der folgenden Maßnahmen ergreifen:

  • Verwenden Sie einen Load Balancer (siehe: Installieren und konfigurieren von NGINX)

  • Verwenden Sie einen FQDN (bevorzugt) oder einen Aliasnamen/CNAME – Wenn Sie bereits eine Domäne verwenden, verwenden Sie einen FQDN. Wenn die Server nicht Teil einer Domäne sind (kein FQDN), verwenden Sie einen Alias/CNAME. Einzelheiten dazu finden Sie weiter unten.

Sie müssen diese Einstellungen vornehmen, da die Webanwendung von BriefCamdie RESEARCH-Komponente aus einem IFrame (einem HTML-Element, das zum Einfügen von Inhalten aus einer anderen Quelle verwendet wird) verwendet. Die neuesten Browser haben ihre Sicherheit verbessert und verhindern jetzt das Senden von Cookies zusammen mit Cross-Site-Anfragen.

Die Lösung besteht darin, die Cookies als First-Party-Cookies (derselben Website) einzurichten (wenn die Domain in der URL-Leiste des Browsers mit Ihrer Cookie-Domain übereinstimmt).

Um dies zu erreichen, müssen Sie den FQDN verwenden, damit das Domain Suffix für alle Server gleich ist, wie in den Beispielen unten gelb hervorgehoben. Wenn Sie nur den Hostnamen verwenden, z. B. "synopsis" oder "research" in den Beispielen unten, gibt es kein Domain-Suffix und Cookies werden nicht zwischen den Websites geteilt.

Beispielsweise:

  • synopsis.your-domain.com

  • research.your-domain.com

Wenn Sie einen Load Balancer eingerichtet haben, tritt dieses Problem nicht auf. Weitere Informationen hierzu finden Sie unter Installieren und konfigurieren von NGINX.

Wenn Sie die Option FQDN oder Alias/CNAME verwenden, müssen Sie Folgendes tun:

  1. Wenn Sie einen voll qualifizierten Namen (FQDN) verwenden, suchen Sie den FQDN Ihres Servers, indem Sie in der Systemsteuerung auf das Menü System klicken. Sie sehen den FQDN Ihres Rechners (falls vorhanden).

    FQDN.png

  2. Im Abschnitt Environment Settings des BriefCam Administrator Consolebearbeiten Sie die QlikServer-Einstellung und ändern sie in den FQDN oder Alias/CNAME. Wenn Ihr Domainname zum Beispiel www.test.com lautet, verwenden Sie research.test.com.

  3. Bearbeiten Sie auf dem Web Services Rechner die ProWebClient webConfig.js Datei (Pfad: C:\Program Files\BriefCam\WebServices\ProWebClient\webConfig.js) und ersetzen Sie den Hostnamen mit dem FQDN oder Alias/CNAME. Beispielsweise:

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

  4. Bearbeiten Sie auf dem Web Services-Rechner die web.config.js -Datei des ProWebAdminClient (Pfad: C:\Program Files\BriefCam\WebServices\ProWebAdminClient\web.config.js ) und ersetzen Sie den Hostnamen durch den FQDN oder Alias/CNAME. Beispielsweise:

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

  5. Öffnen Sie Qlik QMC > Virtual proxies (https://localhost/qmc/virtualproxies) und bearbeiten Sie den bc Proxy.

  6. Öffnen Sie die Registerkarte Erweitert und fügen Sie den neuen Hostnamen des RESEARCH-Rechners (den FQDN oder Alias/CNAME) in die Host-Zulassungsliste ein. Beispielsweise:

    QMC host allow list.png

  7. Klicken Sie auf Anwenden.

  8. Navigieren Sie zurück zu Virtuelle Proxies und bearbeiten Sie das zentrale Proxie (Standard).

  9. Öffnen Sie die Registerkarte Erweitert und fügen Sie den neuen Hostnamen des RESEARCH-Rechners (den FQDN oder Alias/CNAME) in die Host-Zulassungsliste ein. Beispielsweise:

    QMC host allow list Central.png

  10. Klicken Sie auf Anwenden.

  11. Achten Sie beim Öffnen des Web Clients oder des BriefCam Administrator Consoledarauf, dass der neue Hostname in der URL verwendet wird. Beispielsweise:

    http://www.test.com/app

    http://www.test.com/admin