Reverse Proxy

Kopfzeilen

Wenn Sie einen Reverse Proxy verwenden, müssen Sie die Kopfzeile X-Forwarded-For in der Verbindung zu mosparo definieren. Ansonsten weiss mosparo nicht, welcher Client die Anfrage gestartet hat.

Zusätzlich müssen Sie die Kopfzeile X-Forwarded-Proto übermitteln, falls die Verbindung hinter dem Reverse Proxy nicht mit SSL verschlüsselt ist.

Beispiel nginx

server {
    listen 443 ssl http2;

    server_name [domain];

    index  index.html index.htm index.php;

    # Reverse Proxy Konfiguration - Start
    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_pass http://127.0.0.1:8080;
    }
    # Reverse Proxy Konfiguration - Ende

    [sslConfiguration] # Konfigurieren gemäss Ihren Anforderungen
}

mosparo unter einem Unterpfad mit Reverse Proxy installieren

Generell empfehlen wir, mosparo im Stammverzeichnis einer Domain oder Subdomain zu installieren und nicht in einem Unterpfad. Das Problem mit dem Unterpfad ist, dass bei einer Fehlkonfiguration des Webservers die falschen Daten von mosparo abrufbar sein könnten.

Seit v1.2 ist es jedoch möglich, mosparo über einen Reverse Proxy in einem Unterpfad zu installieren. Nur das public Verzeichnis von mosparo darf dem Internet zugänglich gemacht werden. Sie können das Docker-Image verwenden oder mosparo an einem anderen Ort installieren und das public-Verzeichnis von dort aus freigeben.

Sie müssen die Header X-Forwarded-Host mit dem Namen Ihres Hosts und X-Forwarded-Prefix mit dem Namen Ihres Unterpfades an mosparo weiterleiten.

Beispiel nginx

server {
    listen 443 ssl http2;

    server_name [domain];

    root /var/www/;
    index index.html index.htm index.php;

    # Reverse Proxy Konfiguration - Start
    location /app/ {
        rewrite /app/(.*) /$1 break;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-Host $http_host;
        proxy_set_header X-Forwarded-Prefix /app;
        proxy_pass http://127.0.0.1:8080;
    }
    # Reverse Proxy Konfiguration - Ende

    [sslConfiguration] # Konfigurieren gemäss Ihren Anforderungen
}

Vertrauenswürdige Proxies

Symfony, auf welchem mosparo basiert, erlaubt zusätzliche HTTP-Kopfzeilen wie X-Forwarded-For nur, wenn die Anfrage von einem vertrauenswürdigen Proxy kommt.

Damit das korrekt funktioniert, müssen Sie die IP-Adressen der Proxy-Server in der Konfiguration von mosparo hinterlegen, damit mosparo die Kopfzeilen X-Forwarded-Proto und X-Forwarded-For akzeptieren kann.

Gehen Sie in die mosparo Administrationsoberfläche und wählen Sie "Sicherheits-Einstellungen". In den Sicherheits-Einstellungen können Sie die Einstellungen für Ihren Reverse Proxy für mosparo konfigurieren (aber natürlich nicht für Ihren Webserver). Fügen Sie alle vertrauenswürdigen Proxys in die Liste der vertrauenswürdigen Proxys ein. Bei Bedarf können Sie durch Setzen des Flags den Wert REMOTE_ADDR hinzufügen. Zusätzlich können Sie die Namen der Adress- und Proto-Header setzen, wenn Ihr Proxy dies erfordert.

Achtung

Diese Methode kann gefährlich sein und Sie sollten Sie nur nutzen, falls notwendig. Sie sollten eine mosparo Installation nie direkt (ohne Reverse Proxy) in der Öffentlichkeit zugänglich machen, wenn Sie die Option REMOTE_ADDR in der Liste der vertrauenswürdigen Proxies hinterlegt haben.