86.5. シークレットが漏洩した場合の Ansible での IdM サービス Vault シークレットの変更

手順

1. /usr/share/doc/ansible-freeipa/playbooks/vault ディレクトリーに移動します。

   $ cd /usr/share/doc/ansible-freeipa/playbooks/vault

2. インベントリーファイルを開き、以下のホストが正しく定義されていることを確認します。

   • [ipaserver] セクションの IdM サーバー

   • [webservers] セクションのシークレット取得先のホスト。たとえば Ansible に対して webserver1.idm.example.com と webserver2.idm.example.com にシークレットを取得するように指示するには、以下を入力します。

     [ipaserver]
     server.idm.example.com
     
     [webservers]
     webserver1.idm.example.com
     webserver2.idm.example.com

   重要

   このリストに不正アクセスのあった Web サーバーが含まれないようにしてください (現在の例では webserver3.idm.example.com)。

3. data-archive-in-asymmetric-vault.yml Ansible Playbook ファイルのコピーを作成します。次に例を示します。

   $ cp data-archive-in-asymmetric-vault.yml data-archive-in-asymmetric-vault-copy.yml

4. data-archive-in-asymmetric-vault-copy.yml ファイルを編集のために開きます。

5. ファイルを変更するには、ipavault タスクセクションに以下の変数を設定します。

   • ipaadmin_password 変数は IdM 管理者パスワードに設定します。
   • name 変数は Vault の名前 (例: secret_vault) に設定します。
   • service 変数は Vault のサービス所有者に設定します (例: HTTP/webserver.idm.example.com)。
   • in 変数は "{{ lookup('file', 'new-private-key-to-an-externally-signed-certificate.pem')| b64encode }}" に設定します。この設定では、Ansible が IdM サーバーではなく、Ansible コントローラーの作業ディレクトリーから秘密鍵のあるファイルを取得するようになります。

   • action 変数は member に設定します。

     今回の例で使用するように変更した Ansible Playbook ファイル:

   ---
   - name: Tests
     hosts: ipaserver
     gather_facts: false
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - ipavault:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: secret_vault
         service: HTTP/webserver.idm.example.com
         in: "{{ lookup('file', 'new-private-key-to-an-externally-signed-certificate.pem') | b64encode }}"
         action: member

6. ファイルを保存します。

7. Playbook を実行します。

   $ ansible-playbook --vault-password-file=password_file -v -i inventory.file data-archive-in-asymmetric-vault-copy.yml

8. retrieve-data-asymmetric-vault-copy.yml ファイルを開いて編集します。

9. ファイルを変更するには、ipavault タスクセクションに以下の変数を設定します。

   • ipaadmin_password 変数は IdM 管理者パスワードに設定します。
   • name 変数は Vault の名前 (例: secret_vault) に設定します。
   • service 変数は Vault のサービス所有者に設定します (例: HTTP/webserver1.idm.example.com)。
   • private_key_file 変数は、サービス Vault のシークレットの取得に使用する秘密鍵の場所に設定します。
   • out 変数は、現在の作業ディレクトリーなど、new-private-key-to-an-externally-signed-certificate.pem シークレットの取得先となる IdM サーバーの場所に設定します。

   • action 変数は member に設定します。

     今回の例で使用するように変更した Ansible Playbook ファイル:

   ---
   - name: Retrieve data from vault
     hosts: ipaserver
     become: no
     gather_facts: false
   
     vars_files:
     - /home/user_name/MyPlaybooks/secret.yml
     tasks:
     - name: Retrieve data from the service vault
       ipavault:
         ipaadmin_password: "{{ ipaadmin_password }}"
         name: secret_vault
         service: HTTP/webserver1.idm.example.com
         vault_type: asymmetric
         private_key: "{{ lookup('file', 'service-private.pem') | b64encode }}"
         out: new-private-key-to-an-externally-signed-certificate.pem
         state: retrieved

10. Playbook に、IdM サーバーから Ansible コントローラーにデータファイルを取得するセクションを追加します。

    ---
    - name: Retrieve data from vault
      hosts: ipaserver
      become: true
      gather_facts: false
      tasks:
    [...]
      - name: Retrieve data file
        fetch:
          src: new-private-key-to-an-externally-signed-certificate.pem
          dest: ./
          flat: true
          mode: 0600

11. インベントリーファイルの webservers セクションに記載されている Web サーバーに、Ansible コントローラーから取得した new-private-key-to-an-externally-signed-certificate.pem ファイルを転送するセクションを Playbook に追加します。

    ---
    - name: Send data file to webservers
      become: true
      gather_facts: no
      hosts: webservers
      tasks:
      - name: Send data to webservers
        copy:
          src: new-private-key-to-an-externally-signed-certificate.pem
          dest: /etc/pki/tls/private/httpd.key
          mode: 0444

12. ファイルを保存します。

13. Playbook を実行します。

    $ ansible-playbook --vault-password-file=password_file -v -i inventory.file retrieve-data-asymmetric-vault-copy.yml