deekayen.iis_custom_headers

En-têtes personnalisés IIS

Ajoutez ou supprimez des en-têtes HTTP personnalisés et globaux des sites web IIS sur Microsoft Windows Server.

Variables du rôle

La variable par défaut iis_custom_headers définit quelle clé et quelle valeur définir pour les en-têtes HTTP personnalisés. Si vous souhaitez la remplacer, vous devrez redéfinir tous les en-têtes qui devraient être présents ou absents. Ansible ne fusionnera pas votre variable remplacée avec les valeurs par défaut. L'en-tête X-Frame-Options est défini par l'IETF dans RFC7034 pour améliorer la sécurité des applications web.

Par défaut, Ansible redémarrera IIS à la fin des tâches car il suppose généralement que l'exécution de win_shell entraîne un changement ; changez iis_custom_headers_restart_iis pour empêcher le redémarrage d'IIS.

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

Exemple de Playbook

Les tâches s'appuient sur les cmdlets d'administration du serveur web (IIS) de Powershell Add-WebConfigurationProperty et 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" }

Le résultat ajoutera des éléments customHeaders à la configuration XML globale :

<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>