linux-system-roles.crypto_policies
crypto_policies
このAnsibleロールは、システム全体の暗号ポリシーを管理します。
この概念は、Red Hat Enterprise Linux 8およびFedoraで広く採用されています。
要件
以下を参照してください。
コレクションの要件
このロールを使用してrpm-ostree
システムを管理する場合は、追加のコレクションをインストールする必要があります。以下のコマンドを実行してコレクションをインストールしてください。
ansible-galaxy collection install -vv -r meta/collection-requirements.yml
ロール変数
デフォルトでは、このロールは以下のセクションに記載されているシステムの状態を報告します。
crypto_policies_policy
この変数を使って、ターゲットシステムでの希望の暗号ポリシーを指定します。これは、基本ポリシーまたはupdate-crypto-policies
ツールが受け入れるサブポリシーを持つ基本ポリシーになります。例えば、FUTURE
やDEFAULT:NO-SHA1:GOST
などです。指定した基本ポリシーとサブポリシーは、ターゲットシステムで利用可能である必要があります。
デフォルト値はnull
で、設定が変更されず、ロールは以下の情報を収集します。
ターゲットシステムで利用可能な基本ポリシーのリストはcrypto_policies_available_policies
変数にあり、利用可能なサブポリシーのリストはcrypto_policies_available_subpolicies
変数にあります。
crypto_policies_reload
デフォルト(true
)では、暗号ポリシーの更新により、システム内のいくつかのデーモンが再読み込みされます。false
に設定するとこの動作を防ぎ、システムの登録中や他のフォローアップタスクが後で再読み込みを行う場合に役立ちます。
crypto_policies_reboot_ok
暗号ポリシーは、暗号ライブラリを使用しているすべてのカスタムアプリケーションを把握できないため、暗号ポリシーを変更した後は再起動を推奨します。デフォルト(false
)では、再起動が必要な場合、ロールは下記のようにcrypto_policies_reboot_required
変数を設定します。その後の再起動はロールのユーザーに任されます。他に再起動を必要とするタスクがない場合、この値をtrue
に設定すると、ロールが必要に応じて再起動を処理します。
crypto_policies_transactional_update_reboot_ok
この変数は、トランザクショナルアップデートによる再起動を処理するために使用されます。トランザクショナルアップデートが再起動を必要とする場合、crypto_policies_transactional_update_reboot_ok
がtrue
に設定されていると、ロールは再起動を実行します。false
に設定されていると、再起動が必要であることをユーザーに通知し、再起動の要件をカスタムで処理できるようにします。この変数が設定されていない場合、ロールは再起動の要件を見落とさないように失敗します。
ロールによってエクスポートされる変数
crypto_policies_active
この情報は、上記のcrypto_policies_policy
変数が受け入れる形式の現在のアクティブなポリシー名を含みます。
crypto_policies_available_policies
これは、ターゲットシステムで利用可能なすべての基本ポリシーのリストです。カスタムポリシーファイルは、.pol
ファイルを/etc/crypto-policies/policies
ディレクトリにコピーすることでインストールできます(このロールではまだ実装されていません)。
crypto_policies_available_subpolicies
これは、ターゲットシステムで利用可能なすべてのサブポリシーのリストです。カスタムサブポリシーは、.pmod
ファイルを/etc/crypto-policies/policies/modules
ディレクトリにコピーすることでインストールできます(このロールではまだ実装されていません)。
crypto_policies_available_modules
crypto_policies_available_subpolicies
の廃止されたエイリアスです。
crypto_policies_reboot_required
デフォルトはfalse
- true
の場合、ロールによって行われた変更を適用するために再起動が必要であることを意味します。
例プレイブック
以下のプレイブックは、SHA1なしのデフォルトの暗号ポリシーレベルにシステムを設定します。この更新は再起動なしで行われます(ユーザーが後で行うことを推奨します)。
- name: Manage crypto policies
hosts: all
roles:
- role: linux-system-roles.crypto_policies
vars:
crypto_policies_policy: "DEFAULT:NO-SHA1"
crypto_policies_reload: false
rpm-ostree
README-ostree.mdを参照してください。
ライセンス
MIT、詳細はLICENSEファイルを参照してください。
著者情報
Jakub Jelen, 2020
This Ansible role manages system-wide crypto policies.
ansible-galaxy install linux-system-roles.crypto_policies