Configurar els servidors intermediaris de confiança

En els entorns que requereixen un nivell de seguretat reforçat, la configuració dels servidors intermediaris de confiança és obligatòria.

Quan Cyberwatch es troba darrere d’un o diversos servidors intermediaris (proxy), com ara un equilibrador de càrrega, un servidor intermediari invers o un servidor intermediari de seguretat, cal configurar la variable TRUSTED_PROXIES per indicar a Cyberwatch quins servidors intermediaris són de confiança. Aquesta configuració permet a Cyberwatch obtenir les adreces IP correctes dels clients a les sessions i als registres, mitjançant les capçaleres HTTP adequades (com ara X-Forwarded-For) en lloc de l’adreça IP del servidor intermediari.

Només s’utilitzaran les adreces IP dels servidors intermediaris de confiança per determinar l’adreça IP real del client. Assegureu-vos d’incloure-hi només els servidors intermediaris que controleu i en què confieu.

Configuració

Amb Docker Swarm i Podman

  1. Afegiu la variable d’entorn TRUSTED_PROXIES al fitxer /etc/cyberwatch/containers.env:

    TRUSTED_PROXIES=10.0.0.1,10.0.0.2
    

    Podeu especificar:

    • Una sola adreça IP: TRUSTED_PROXIES=10.0.0.1
    • Diverses adreces IP separades per comes: TRUSTED_PROXIES=10.0.0.1,10.0.0.2,192.168.1.100
    • Una o diverses xarxes CIDR: TRUSTED_PROXIES=10.0.0.0/24
  2. Reinicieu Cyberwatch:

    sudo cyberwatch restart
    

Amb Kubernetes

  1. Afegiu la variable d’entorn TRUSTED_PROXIES a web.env al fitxer values.yml:

    web:
      env:
        ## Trusted proxy IP addresses or CIDR ranges
        ## Allows Cyberwatch to correctly identify client IP addresses when behind proxies
        TRUSTED_PROXIES: "10.0.0.1,10.0.0.2"
    

    Podeu especificar:

    • Una sola adreça IP: TRUSTED_PROXIES: "10.0.0.1"
    • Diverses adreces IP separades per comes: TRUSTED_PROXIES: "10.0.0.1,10.0.0.2,192.168.1.100"
    • Una o diverses xarxes CIDR: TRUSTED_PROXIES: "10.0.0.0/24"
  2. Reinicieu Cyberwatch seguint el procediment descrit a Reiniciar i actualitzar el chart de Helm

Verificació

Després de la configuració, podeu comprovar que les adreces IP es detecten correctament consultant els registres de sessions o comprovant les adreces IP registrades a la interfície de Cyberwatch.

Desactivar la gestió dels servidors intermediaris de confiança

Si no hi ha res configurat, l’aplicació Cyberwatch utilitza els servidors intermediaris per defecte enumerats a la RFC 1918, que s’utilitzen per a xarxes privades. Podeu desactivar aquests servidors intermediaris per defecte definint la variable TRUSTED_PROXIES amb el valor none.

Per a Docker Swarm:

TRUSTED_PROXIES=none

Per a Kubernetes:

web:
  env:
    TRUSTED_PROXIES: "none"