deekayen.iis_custom_headers

IIS Benutzerdefinierte Header

Fügen Sie globale, benutzerdefinierte HTTP-Header von IIS-Websites auf Microsoft Windows Server hinzu oder entfernen Sie sie.

Rollenvariablen

Die Standardvariable iis_custom_headers definiert, welchen Schlüssel und Wert für benutzerdefinierte HTTP-Header gesetzt werden sollen. Wenn Sie dies überschreiben möchten, müssen Sie alle Header neu definieren, die "vorhanden" oder "nicht vorhanden" sein sollen. Ansible wird Ihre überschriebenen Variablen nicht mit den Standardwerten zusammenführen. Der Header X-Frame-Options wird von der IETF in RFC7034 definiert, um die Sicherheit von Webanwendungen zu verbessern.

Standardmäßig wird Ansible IIS am Ende der Aufgaben neu starten, da davon ausgegangen wird, dass die Ausführung von win_shell zu einer Änderung führt; setzen Sie iis_custom_headers_restart_iis auf "false", um den Neustart von IIS zu verhindern.

iis_custom_headers:
  - { name: "X-Frame-Options", value: "SAMEORIGIN", state: "present" }
  - { name: "X-Powered-By", value: "ASP", state: "absent" }
  - { name: "X-Powered-By", value: "ASP.NET", state: "absent" }

iis_custom_headers_restart_iis: True

Beispiel Playbook

Die Aufgaben verwenden die PowerShell-Webserver (IIS) Verwaltungsbefehle Add-WebConfigurationProperty und Remove-WebConfigurationProperty.

- hosts: iis_servers
  roles:
     - role: deekayen.iis_custom_headers
       iis_custom_headers:
         - { name: "Strict-Transport-Security", value: "max-age=31536000", status: "present" }
         - { name: "X-Frame-Options", value: "SAMEORIGIN", status: "present" }
         - { name: "X-Powered-By", value: "ASP.NET", status: "absent" }

Das Ergebnis wird customHeaders Elemente zur globalen XML-Konfiguration hinzufügen:

<configuration>
   <system.webServer>
      <httpProtocol>
         <customHeaders>
            <add name="Strict-Transport-Security" value="max-age=31536000" />
            <add name="X-Frame-Options" value="SAMEORIGIN" />
         </customHeaders>
      </httpProtocol>
   </system.webServer>
</configuration>