Konfiguration im Zusammenspiel mit einem Reverse-Proxy

Reverse-Proxy Konfiguration bei der Verwendung des IIS

Dokumentation > Konfiguration > Webserver IIS > Konfiguration im Zusammenspiel mit einem Reverse-Proxy

Das folgende Konfigurationsbeispiel behandelt den Betrieb der Applikation hinter einem Reverse-Proxy unter folgenden Prämissen:

  • Als Reverse-Proxy wird der IIS eingesetzt
    URL Rewrite v2 und Application Request Routing ARR sind installiert
  • Der Reverse-Proxy terminiert SSL
    Einsatz eines ACME-Clients, welche Zertifikate von Let's Encrypt bezieht
  • Die beiden Server befinden sich nicht im selben Subnetz
  • Der Verkehr zwischen Reverse-Proxy und dem Applikationsserver erfolgt unverschlüsselt
    Dies ermöglicht es einer Firewall oder WAF, den Verkehr auf Auffälligkeiten zu untersuchen, ohne dass die Daten entschlüsselt und anschliessend wieder verschlüsselt werden müssen
  • Der originale DNS-Name kann auf dem Reverse-Proxy korrekt zum Applikationsserver aufgelöst werden
    Bsp.: Eintrag in der hosts Datei auf dem Reverse-Proxy

„Let's Encrypt ist eine Marke der Internet Security Research Group (ISRG). Dieses Softwareprodukt steht in keiner offiziellen Verbindung zu Let's Encrypt und wird nicht von der ISRG gesponsert oder zertifiziert.“

Traffic-Flow

Netzwerkverkehr bis und mit dem Web- bzw. Applikationsserver.

Traffic-Flow

Dieses Setup lässt sich auch mit einer einzelnen Firewall umsetzen

Reverse-Proxy Konfiguration

Ausserhalb der web.config

IIS/Serverknoten

Application Request Routing Cache / Server Proxy Setting

  • Enable proxy
    Aktivieren
  • HTTP Version
    Setzen auf Passthrough
  • Keep Alive
    Aktivieren
  • Reverse rewrite host in response headers
    Aktivieren
  • Preserve Client IP in the following header
    Setze den gewünschten Namen, üblicherweise X-Forwarded-For. Dieser Wert muss unter Core Einstellungen konfiguriert werden. Aus diesen Header wird die IP-Adresse des aufrufenden Clients ermittelt.
  • Include TCP-port from client-ip
    Ist für die Applikation nicht erforderlich, stört jedoch nicht, wenn dies aktiviert ist
  • disk cache
    Deaktivieren

Im Konfigurationseditor

  • Sektion: system.webServer/proxy
    Setze preserveHostHeader auf false
    Setze arrResponseHeader auf false
IIS/Serverknoten UND IIS/Knoten der Website

URL Rewrite / Servervariablen

Sicherstellen, dass die folgenden Servervariablen zugelassen sind, andernfalls müssen diese erfasst werden.

  • HTTP_HOST
  • HTTP_X_FORWARDED_PROTO

web.config des Reverse-Proxy

Reverse-Proxy Setup

Die Regeln bewirken folgendes:

  • Site_LetsEncrypt-Bypass
    Bricht die Verarbeitung weiterer Regeln ab und verhindert einen Redirect auf https bei einer Zertifikatserneuerung
  • Site_redirect-to-https
    Erzwingt https
  • ReverseProxy-website
    Leitet den Traffic an den nur intern erreichbaren Applikationsserver weiter
  • Site_Use-only-secure-cookies
    Weist den Browser an, Cookies ausschließlich über verschlüsselte HTTPS-Verbindungen zu übertragen

Rewrite Section auf dem Reverse-Proxy

<system.webServer>
  <rewrite>
    <rules>
      <clear />
      <rule name="Site_lets-encrypt-bypass" stopProcessing="true">
        <match url="^\.well-known/acme-challenge/.*" />
        <action type="None" />
      </rule>
      <rule name="Site_redirect-to-https" stopProcessing="true">
        <match url="(.*)" />
        <conditions>
          <add input="{HTTPS}" pattern="^OFF$" />
        </conditions>
        <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="SeeOther" />          
      </rule>
      <rule name="ReverseProxy-website" stopProcessing="true">
        <match url="(.*)" />
        <action type="Rewrite" url="http://application-server/{R:1}" />
        <serverVariables>
          <!-- Teile dem Applikationsserver mit, ober der Traffic bis zum Reverse-Proxy verschlüsselt war oder nicht -->
          <set name="HTTP_X_FORWARDED_PROTO" value="{CACHE_URL_PROTOCOL}" />
        </serverVariables>                
      </rule>
    </rules>
    <outboundRules>
      <rule name="Site_use-only-secure-cookies" preCondition="Unsecured cookie">
        <match serverVariable="RESPONSE_SET_COOKIE" pattern=".*" negate="false" />
        <action type="Rewrite" value="{R:0}; secure" />
      </rule>
      <preConditions>
        <preCondition name="Unsecured cookie">
          <add input="{RESPONSE_SET_COOKIE}" pattern="." />
          <add input="{RESPONSE_SET_COOKIE}" pattern="; secure" negate="true" />
        </preCondition>
      </preConditions>
    </outboundRules>    
  </rewrite>
</system.webServer>

web.config des Applikationsservers

Anpassung für das Reverse-Proxy Setup

Damit an der Applikation oder deren Konfiguration möglichst wenig geändert werden muss, wird der Applikation vorgegaukelt, es handle sich um eine eingehende https Verbindung, sofern der Reverse-Proxy den Verbindungsaufbau des Client als https erkannt und dies im Header HTTP_X_FORWARDED_PROTO mitgeteilt hat.

In einer bestehenden Installation muss lediglich die Section rewrite ausgetauscht werden.

system.webserver/rewrite: der Applikationsserver befindet sich hinter einem Reverse-Proxy

<rewrite>
  <rules>
    <clear />
    <rule name="Site_pretend-as-a-secure-connection" patternSyntax="Wildcard">
      <match url="*" />
      <conditions>
        <!-- Pruefe, ob der Traffic über den Reverse-Proxy und bis dahin transportverschlüsselt war  -->
        <add input="{HTTP_X_FORWARDED_PROTO}" pattern="https" />
      </conditions>
      <serverVariables>
        <!-- Vorgaukeln einer SSL Umgebung für die Applikation intern -->
        <set name="HTTPS" value="on" />
        <set name="SERVER_PORT" value="443" />
      </serverVariables>
      <action type="None" />
    </rule>
  </rules>
</rewrite>