Serverspecを仕様としたセキュリティ設定の構成管理とAnsibleロールの設計・実装

こんにちは、AI Labの川口あいです。

前回の記事では、既存インフラの構成管理を前進させる取り組みとして、Serverspecを仕様としたログ基盤向けのAnsibleロールの設計・実装についてご紹介しました。

今回のブログでは、その続きとして、「セキュリティ関連の設定を構成管理に組み込むフェーズ」について解説します。 ログ基盤だけでなく、システム全体の安全性を高めるためには、通信やアクセスの制御に加え、OSやミドルウェアが安全な構成状態で動作していることを担保する仕組みが重要です。

本記事では、こうしたセキュリティ要件をどのようにAnsibleロールとして設計・実装し、Serverspecを用いて検証しているのかを、実装コードとともに紹介します。

目次

開発環境

これまでの環境と同様で以下の3つのコンテナから構成されています。

┌─────────────────────┐
│ ansible-controller  │  Ansible実行環境
│  - Python 3.11      │
│  - Ansible 2.19     │
└──────────┬──────────┘
           │
           │ SSH (ed25519)
           │
┌──────────▼──────────┐
│ almalinux-target    │  テスト対象サーバー
│  - AlmaLinux 9      │
│  - SSHd             │
└──────────▲──────────┘
           │
           │ SSH (ed25519)
           │
┌──────────┴──────────┐
│ kondate-runner      │  ServerSpec実行環境
│  - Ruby 3.3         │
│  - Kondate          │
│  - ServerSpec       │
└─────────────────────┘

構成管理の設計と実装

今回のプロジェクトでも、既存環境で運用されていたServerspecのテストケースを仕様書として位置づけ、それらをすべてパスする状態をゴールとします。

今回活用したServerspecテストケースの概要

ここでは、今回のセキュリティ関連Ansibleロールの作成にあたって参考にした6つのServerspecファイルについて、その役割を簡単に紹介します。

前回のプロジェクトまでで、httpd(Apache)やsshdのインストールおよび起動・自動起動設定、ならびにログ基盤としての基本的な構成はすでに整っているものとし、本記事ではそれらを前提に、セキュリティ観点での設定が適切に行われているかに焦点を当てています。

各Serverspecは、「Ansibleによる構成管理で最終的にどのようなセキュアな状態を実現したいのか」を明確にするための指標として位置づけています。 ここではコードの詳細には踏み込まず、それぞれのテストが担保しているセキュリティ要件を概要レベルで整理します。

1. system-sysctl_spec.rb

require 'spec_helper'

describe '[NaN] kernelパラメータの設定をしていること' do
  describe file('/etc/sysctl.conf') do
    its(:content) { should match /^net.ipv4.tcp_timestamps\s*=\s*0$/ } 
    its(:content) { should match /^net.core.somaxconn\s*=\s*1024$/ }
    its(:content) { should match /^net.ipv4.tcp_max_syn_backlog\s*=\s*1024$/ }  
  end

  describe command('sysctl -n net.ipv4.tcp_timestamps') do
    its(:stdout) { should match /^0$/ }
  end

  describe command('sysctl -n net.core.somaxconn') do
    its(:stdout) { should match /^1024$/ }
  end

  describe command('sysctl -n net.ipv4.tcp_max_syn_backlog') do
    its(:stdout) { should match /^1024$/ }
  end
end
  • net.ipv4.tcp_timestampsが無効(0)に設定されていること
  • net.core.somaxconn が 1024 に設定されていること
  • net.ipv4.tcp_max_syn_backlog が 1024 に設定されていること

-> これにより、ネットワーク通信における不要な情報露出を抑制しつつ、負荷がかかった状況でも安定した通信を維持できる状態を担保しています。

2. httpd-SSL-CVEs_spec.rb

  • Webサーバー(443/tcp)において、TLS 1.2 または TLS 1.3 が有効化されていること
  • 脆弱とされる暗号スイート(EXP、DES)が利用不可となっていること

-> これにより、既知のSSL/TLS脆弱性による通信内容の盗聴や改ざんリスクを低減し、セキュアなHTTPS通信が常に提供されている状態を担保しています。

3. httpd_override_spec.rb

  • /etc/httpd/conf.d/ 配下の各Apache設定ファイルにおいて、有効な<Directory>設定内に .htaccess による制御を許可するAllowOverride ディレクティブが存在しないこと

-> これにより、意図しないディレクトリ単位での設定変更や、.htaccess を介したセキュリティ設定の上書きを防ぎ、Webサーバーの設定を安全かつ一貫した状態で管理できることを担保しています。

4. httpd_SSLOffload_spec.rb

  • SSLオフロード用の設定ファイルとして、/etc/httpd/conf.d/ssl_offload.confが作成されていること
  • 上記設定ファイル内で、Upgrade ヘッダーが明示的に削除されていること

-> これにより、意図しないプロトコル切り替えや挙動の発生を防止できる状態を担保しています。

5. dehydrated_spec.rb

  • 証明書管理ツールとしてdehydratedが/opt/dehydrated配下に配置されていること
  • dehydratedの実行ファイル、設定ファイル、および証明書対象ドメインを定義したファイルが存在すること
  • dehydrated による証明書更新処理が、cron によって定期的に自動実行される設定となっていること
  • 証明書更新処理の実行結果がログとして出力され、更新失敗時にも検知可能な状態であること

-> これにより、証明書の期限切れによるサービス停止を防ぎ、https通信を継続的かつ安全に提供できる運用状態を構成管理によって担保しています。

6. ssh-port_spec.rb

  • サーバー上で22/tcp がリッスン状態となっていること
  • TCP通信による SSH 接続が受け付け可能であること

-> これにより、構成管理適用後も管理者がサーバーへ安全に接続でき、障害対応や運用作業が行える状態が維持されていることを担保しています。

Ansibleロールの作成

ここでは、Serverspec のテストケースを基に作成した Ansible ロールのうちsystem-sysctl_spec.rbを例に、実行環境を考慮した構成管理について説明します。

今回の検証は Dockerコンテナ上で行ったため、system-sysctl_spec.rbに関しては前回と同様Serverspecのテスト内容をそのまま適用するのではなく、環境に応じた対応が必要となりました。

ファイル構成

system-sysctl に関する設定については、今回osロール内のdehydrated関連タスクとまとめて配置しています。osロールは、テンプレート(_template-middleware)を基に以下のような構成で実装しています。

roles/
└── os/
    ├── defaults/
    │   └── main.yml    # デフォルト変数
    ├── handlers/
    │   └── main.yml      # ハンドラー定義(service restart など)      
    └── tasks/
        ├── main.yml      # タスクファイルの呼び出し
        ├── system_sysctl.yml  # 実際のタスクファイル
        ├── ...

前回と同様、処理内容ごとにタスクを分割し、tasks/main.yml を起点として各タスクを呼び出す構成としています。 また、設定値は defaults/main.yml に集約し、再利用性と可読性を高めています。

各ファイルの役割

system_sysctl では、Serverspec で定義されている カーネルパラメータが正しく設定されている状態を実現することを目的としています。一方で、今回は Docker コンテナ上で検証を行っているため、実行環境による制約を考慮した実装が必要となりました。

Docker コンテナはホスト OS のカーネルを共有しているため、/etc/sysctl.confの編集自体は可能であるものの、sysctl -pによる設定の再読み込みを行うと権限エラーが発生します。このため、「設定ファイルの管理」と「設定の反映」を分離して扱う設計としています。

1. tasks/system_sysctl.yml
---
- name: sysctl コマンドをインストール
  ansible.builtin.package:
    name: procps-ng
    state: present
  tags:
    - kernel
    - sysctl

# Dockerコンテナでは権限エラーになるため場合分け(/etc/sysctl.confの変更はできるけどその反映はできない)
- name: "kernelパラメータを /etc/sysctl.conf に設定"
  ansible.builtin.lineinfile:
    path: /etc/sysctl.conf
    regexp: '^{{ item.key }}\s*='
    line: "{{ item.key }} = {{ item.value }}"
    state: present
    create: yes
    owner: root
    group: root
    mode: '0644'
  loop: "{{ system_sysctl | dict2items }}"
  # 実際に反映(reload)するかどうかは、Handlerが環境を見て判断
  notify: reload sysctl
  tags:
    - kernel
    - sysctl

  • カーネルパラメータを変数(system_sysctl)として定義し、設定内容を一元管理
  • lineinfile を用いて冪等性を保った設定ファイル管理を実施

という点を意識して実装しています。

2. handlers/main.yml
---
- name: reload sysctl
  ansible.builtin.command: sysctl -p
  when: ansible_virtualization_type != 'docker'
  • Docker 環境ではsysctl -pを実行せず、設定ファイルの管理のみに留める
  • 実機・VM 環境では、設定変更時のみsysctl -pを実行して即時反映する

という挙動を切り分けています。

このように、実行環境に依存する処理を handlers側に集約することで、tasks側では「あるべき設定状態」の管理に専念させ、環境差分による分岐ロジックを最小限に抑えた構成としています。

Ansibleロールの実装内容

作成したAnsibleロールを用いてサーバーを構築します。以下は、osロール実行時のログの一部(system_sysctl部分)です。

hogehoge playbook % ./scripts/run-playbook.sh docker playbooks/tester.yml

PLAY [任意のテストを単一で実施する] ***********************************************************************************************************************************************************************************************************

TASK [Gathering Facts] ************************************************************************************************************************************************************************************************************************
ok: [almalinux_target]

TASK [os : kernelパラメータ設定を適用] ********************************************************************************************************************************************************************************************************
included: /workspace/roles/os/tasks/system_sysctl.yml for almalinux_target

TASK [os : sysctl コマンドをインストール] *****************************************************************************************************************************************************************************************************
changed: [almalinux_target]

TASK [os : kernelパラメータを /etc/sysctl.conf に設定] ****************************************************************************************************************************************************************************************

RUNNING HANDLER [os : reload sysctl] **********************************************************************************************************************************************************************************************************
skipping: [almalinux_target]

PLAY RECAP ************************************************************************************************************************************************************************************************************************************
almalinux_target           : ok=4    changed=2    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0

Docker環境での検証のため、reload sysctlは 条件分岐によりスキップされていることが分かります。

まとめ・今後の展望

本記事では、前回のログ基盤向けAnsibleロールの設計・実装に続くフェーズとして、システム全体の安全性を高めるためのセキュリティ設定を、Serverspecを仕様とした構成管理で設計・実装する方法について紹介しました。

これにより、セキュリティ設定についても 属人化しがちな運用知識をコードとして再現可能な形に落とし込むことができました。

また、Dockerコンテナ上で検証を行うという制約があったため、system-sysctl_spec.rbのようなカーネル関連の設定については、設定ファイルの管理と実際の反映処理を分けて考える必要がありました。実行環境によって挙動を切り替える設計とすることで、検証環境でも無理なく構成管理を行えるよう工夫しています。

今後は、今回扱った通信・アクセス制御や OS・ミドルウェアのセキュリティ設定に加え、監視や運用ルールといった非機能要件についても Serverspecを起点に整理し、「テストを仕様とした IaC」の形でより広範な領域を自動化していきたいと考えています。

​

​