deekayen.iis_custom_headers

IISカスタムヘッダー

Microsoft Windows Server上のIISウェブサイトから、グローバルなカスタムHTTPヘッダーを追加または削除します。

役割変数

iis_custom_headersのデフォルト変数は、カスタムHTTPヘッダーの設定に使用するキーと値を定義します。上書きしたい場合は、presentまたはabsentにすべきすべてのヘッダーを再定義する必要があります。Ansibleは上書きした変数とデフォルトを統合することはありません。X-Frame-Optionsヘッダーは、ウェブアプリケーションのセキュリティ向上のためにIETFによってRFC7034で定義されています。

デフォルトでは、Ansibleはタスク終了時にIISを再起動します。これは通常、win_shellの実行結果が変更を伴うと仮定するためです。IISの再起動を防ぐには、iis_custom_headers_restart_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

例プレイブック

このタスクは、Powershellのウェブサーバー(IIS)管理コマンドレットAdd-WebConfigurationPropertyと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" }

結果として、グローバルXML設定にcustomHeaders要素が追加されます：

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