Serverspecを仕様としたユーザー・権限管理向けAnsibleロールの設計と実装

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

前回の記事では、システム基盤フェーズとして、hostnameの統一やSwap領域の確保、EPEL/Remiリポジトリの有効化といったOSレベルの前提条件を、Serverspecを仕様としてIaC化する取り組みをご紹介しました。

今回は、ユーザー作成やsudo権限付与といった権限管理を対象に、既存のServerspecテストを仕様として読み解きながら、AnsibleでIaC化する取り組みについてご紹介します。サーバー運用においては、機能やミドルウェアの設定だけでなく、誰がどの権限で操作できるのかを明確に定義することが不可欠です。適切に役割分離されたユーザーを作成し、必要最小限のsudo権限を付与することで、不必要な権限集中を防ぎ、セキュリティリスクを低減することができます。

本記事では、運用上必要となるユーザーの作成やsudo権限の付与といったアクセス制御要件を、Serverspecによって仕様として定義し、それを満たすサーバーをAnsibleロールで構築していく流れを紹介します。また、sudoが利用可能であることや、不適切なユーザーがsudoersに含まれていないことといった要件についても、テストを通じて安全な状態を担保していきます。

目次

開発環境

これまでの環境と同様で以下の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ロールの作成にあたって参考にしたServerspecファイルについて、その役割を簡単に紹介します。

今回参考にしたServerspecテストは、主に次の状態を担保しています。

  • 運用上必要なユーザーが適切に作成されていること
  • 役割に応じたsudo権限が正しく付与されていること
  • 不要なユーザーがsudo権限を持っていないこと

前回のシステム基盤フェーズでは、hostnameの統一やSwap領域の確保など、OSが安定して動作するための前提条件を整理しました。

今回は、サーバー操作の主体となるユーザーとその権限設計に焦点を当てています。

各Serverspecのテストケースは、最終的に目指す「安全なアクセス制御状態」を示す指標として位置づけています。

本セクションではコードの詳細には踏み込まず、それぞれのテストが担保しているシステム基盤要件を概要レベルで整理していきます。


1. user-<operator_user>_spec.rb

require 'spec_helper'

describe '[os-2] 初期運用ユーザー(<operator_user>)が存在すること' do
  describe user('<operator_user>') do
    it { should exist }
    it { should belong_to_group '<service_group>' }
  end
end

describe '[NaN] <operator_user> が sudo 可能であること' do
  describe command('sudo -l -U <operator_user>') do
    its(:exit_status) { should eq 0 }
    its(:stdout) { should match /may run the following commands/ }
  end
end
  • 初期運用ユーザー(operator_user)がサーバー上に作成されていること
  • operator_userが適切なサービスグループ(service_group)に所属していること
  • operator_userがsudo権限を持ち、管理操作を実行できる状態であること

これにより、運用に必要な管理ユーザーが適切な権限で準備され、システム管理作業を安全かつ確実に実施できる状態を担保しています。

※社外公開のため、ユーザー名・グループ名は<operator_user>/<service_group>のように抽象化しています。

2. sudoers_spec.rb

require 'spec_helper'

describe '[NaN] sudo可能であること' do
  describe command('sudo -l') do
    its(:stdout) { should match /may run the following commands/}
  end
end
  • 実行ユーザーがsudo -lを実行できること
  • sudo実行時に、許可されたコマンド一覧(may run the following commands)が表示されること

これにより、サーバ上で管理操作を行うためのsudo権限が適切に設定されており、運用作業が問題なく実施できる状態を担保しています。

3. sudoers-daemon_spec.rb

require 'spec_helper'

describe '[os-8] sudoersにミドルウェア実行ユーザーが含まれないこと' do
  describe file('/etc/sudoers') do
    let(:filtered_content) do
      subject.content
             .split("\n")
             .reject { |line| line.strip.start_with?('#') }
             .join("\n")
    end
    it 'ミドルウェア実行ユーザーが含まれない' do
      expect(filtered_content).not_to match(/<middleware_user>/)
    end
  end
end
  • ミドルウェア実行ユーザー(middleware_user)がsudoersに含まれていないこと

これにより、Webサーバーやアプリケーション実行ユーザーなどのサービスアカウントに不要なsudo権限が付与されていない状態を担保しています。

※社外公開のため、実際のサービス実行ユーザー名は<middleware_user>として抽象化しています。

Ansibleロールの作成

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

userロールの構成

userロールは、テンプレート(_template-middleware)を基に以下のような構成で実装しています。

roles/
└── user/
    ├── defaults/
    │   └── main.yml    # デフォルト変数
    ├── templates/
    │   └── sudoers.j2    # ファイルテンプレ
    └── tasks/
        ├── main.yml      # タスクファイルの呼び出し
        ├── user-<operator_user>.yml  # 実際のタスクファイル
        ├── ...

前回までと同様、処理内容ごとにタスクを分割し、tasks/main.ymlを起点として各タスクを呼び出す構成としています。またtemplates/sudoers.j2には、sudoers設定を記述しており、ユーザーごとに必要な権限をテンプレートから生成してsudoers.d配下へ配置できるようにしています。

userロールのタスクファイル

ここでは、userロールの中でも中核となるタスクファイルについて、Serverspecで定義されたユーザー・権限関連の要件をどのようにAnsibleで実装しているかを説明します(※社外公開のため、一部のコマンドやパスは抽象化しています)。

tasks/user-<operator_user>.yml
---
- name: <operator_user> を作成
  ansible.builtin.user:
    name: "{{ operator_user_name }}"
    groups: "{{ operator_user_groups }}"
    append: true
    shell: "{{ operator_user_shell }}"
    state: present
    create_home: true
  tags:
    - user
    - operator

- name: "<operator_user>にsudo権限を付与"
  ansible.builtin.template:
    src: sudoers.j2
    dest: "{{ user_sudoers_dir }}/{{ operator_user_name }}"
    owner: "{{ common_file_owner }}"
    group: "{{ common_file_group }}"
    mode: "{{ user_sudoers_file_mode }}"
    validate: '/usr/sbin/visudo -cf %s'
  vars:
    sudo_target_user: "{{ operator_user_name }}"
    sudo_nopasswd: "{{ operator_sudo_nopasswd }}"
  tags:
    - user
    - operator

このタスクでは、Serverspecで求められているユーザーおよび権限管理の要件を満たすために、運用ユーザーの作成とsudo権限の付与を構成管理で実装しています。ユーザーと権限は、日常運用や障害対応の起点となる重要な基盤要素であり、属人的な手作業ではなくコードとして定義しておくことが、安全な運用体制の確立につながります。

実装上の工夫として、ユーザー名や所属グループ、NOPASSWDの有無といった設定をテンプレート化し、役割ごとに変数で制御できる構成としています。また、/etc/sudoersを直接編集するのではなく、sudoers.d配下に個別ファイルとして配置し、さらにvisudoによる構文チェックを通すことで、設定ミスによるsudo不能リスクを防止しています。

このように、ユーザーの存在だけでなく「適切な権限が正しく付与されている状態」までをテストで定義し、それを満たす構成をAnsibleで再現することで、安全かつ再現性のあるユーザー管理基盤を実現しています。

冪等性の確認

以下はuser-<operator_user>.ymlを再度実行した際の実行ログです(一部抜粋)。

$ ./scripts/run-playbook.sh docker playbooks/tester.yml

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

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

TASK [user : <operator_user>ユーザー管理] *********************************
included: <roles_path>/user/tasks/user-<operator_user>.yml for target_host

TASK [user : <operator_user>ユーザーを作成] ************************************
ok: [target_host]

TASK [user : <operator_user>にsudo権限を付与] **************************
ok: [target_host]

PLAY RECAP **********************************************************
target_host : ok=4   changed=0   failed=0   skipped=0   rescued=0   ignored=0 

このログは、同じAnsibleプレイブックを再実行した結果です。changed=0 となっていることから、すでに期待する状態が作られている場合は差分更新が発生せず、冪等性が担保できていることが分かります。これにより、運用中でも必要なときだけ安全に差分適用でき、不要な設定上書きや再起動による事故を防ぎやすくなります。

本フェーズで実装対象としなかったテストについて

本フェーズでは、ユーザー作成とsudo権限付与を中心にAnsibleロール化しました。一方で、以下のServerspecについては「仕様として重要だが、権限設計そのものとは役割が異なる」と判断し、実装範囲を整理しています。

sudoers_spec.rb

これはsudoが利用可能であることを確認する前提条件テストです。

本プロジェクトでは、sudoパッケージの導入やsudoers.dの存在確認といった土台部分はosロール側で整備しています。そのうえで、sudoの利用可否そのものは基盤要件として扱い、userロールでは「誰に権限を付与するか」という設計に専念しています。

sudoers-daemon_spec.rb

これはミドルウェア実行ユーザーがsudo権限を持たないことを保証するテストです。

「不要な権限が混入していないか」を検知するための監視的テストとして位置づけており、IaC側で明示的に削除制御を行うよりも、望ましくない状態を検知する役割として継続的に担保しています。


このように本プロジェクトでは、

  • sudoパッケージ導入などのOS基盤としての前提整備(osロール)
  • ユーザー作成やsudo付与といったアクセス制御の権限定義(userロール)
  • 不要な権限混入を防ぐための禁止事項チェック(Serverspec)

という役割分担のもと、安全なアクセス制御状態を維持しています。

まとめ・今後の展望

本記事では、これまでのシステム基盤整備に続くフェーズとして、ユーザーおよび権限管理をテーマに、Serverspecを仕様とした構成管理で設計・実装する方法について紹介しました。

ユーザー作成やsudo権限の付与といった設定は、運用上欠かせない一方で、手作業や属人的な判断が入りやすい領域でもあります。今回のプロジェクトでは、既存のServerspecテストケースを起点に、「どのユーザーが存在し、どの権限を持つべきか」という状態を仕様として明確化し、それを満たすサーバーをAnsibleロールで構築しました。

また、sudo設定については/etc/sudoersを直接編集するのではなく、sudoers.d配下に定義を分離し、さらにvisudoによる構文チェックを組み込むことで、設定ミスによる事故を防ぎながら安全に権限管理を行える構成としています。

今後は、今回整備した基盤と権限設計を前提に、データベースやnginxといったミドルウェア領域についても同様にServerspecを仕様として整理し、「テストを仕様としたIaC」の考え方をさらに拡張していきます。

​

​