11.7. RELP での logging システムロールの使用

手順

1. 以下の内容を含む playbook.yml ファイルを作成します。

   ---
   - name: Deploying basic input and relp output
     hosts: clients
     roles:
       - rhel-system-roles.logging
     vars:
       logging_inputs:
         - name: basic_input
           type: basics
       logging_outputs:
         - name: relp_client
           type: relp
           target: _logging.server.com_
           port: 20514
           tls: true
           ca_cert: _/etc/pki/tls/certs/ca.pem_
           cert: _/etc/pki/tls/certs/client-cert.pem_
           private_key: _/etc/pki/tls/private/client-key.pem_
           pki_authmode: name
           permitted_servers:
             - '*.server.example.com'
       logging_flows:
         - name: _example_flow_
           inputs: [basic_input]
           outputs: [relp_client]

   Copy to Clipboard Toggle word wrap

   Playbook は、以下の設定を使用します。

   • target:リモートロギングシステムが稼働しているホスト名を指定する必須パラメーターです。
   • port:リモートロギングシステムがリッスンしているポート番号です。

   • tls:ネットワーク上でログをセキュアに転送します。セキュアなラッパーが必要ない場合は、tls 変数を false に設定します。デフォルトでは tls パラメーターは true に設定されますが、RELP を使用する場合には鍵/証明書およびトリプレット {ca_cert、cert、private_key} や {ca_cert_src、cert_src、private_key_src} が必要です。

     • {ca_cert_src、cert_src、private_key_src} のトリプレットを設定すると、デフォルトの場所 (/etc/pki/tls/certs と /etc/pki/tls/private) を、コントロールノードから転送する管理対象ノードの宛先として使用します。この場合、ファイル名はトリプレットの元の名前と同じです。
     • {ca_cert、cert、private_key} トリプレットが設定されている場合には、ファイルはロギング設定の前にデフォルトのパスを配置する必要があります。
     • トリプレットの両方が設定されている場合には、ファイルはコントロールノードのローカルのパスから管理対象ノードの特定のパスへ転送されます。
   • ca_cert:CA 証明書へのパスを表します。デフォルトのパスは /etc/pki/tls/certs/ca.pem で、ファイル名はユーザーが設定します。
   • cert:証明書へのパスを表します。デフォルトのパスは /etc/pki/tls/certs/server-cert.pem で、ファイル名はユーザーが設定します。
   • private_key:秘密鍵へのパスを表します。デフォルトのパスは /etc/pki/tls/private/server-key.pem で、ファイル名はユーザーが設定します。
   • ca_cert_src:ローカルの CA 証明書ファイルパスを表します。これはターゲットホストにコピーされます。ca_cert が指定している場合は、その場所にコピーされます。
   • cert_src:ローカルの証明書ファイルパスを表します。これはターゲットホストにコピーされます。cert を指定している場合には、その証明書が場所にコピーされます。
   • private_key_src:ローカルキーファイルのパスを表します。これはターゲットホストにコピーされます。private_key を指定している場合には、その場所にコピーされます。
   • pki_authmode:name または fingerprint の認証モードを使用できます。
   • permitted_servers:ロギングクライアントが、TLS 経由での接続およびログ送信を許可するサーバーの一覧。
   • inputs:ロギング入力ディクショナリーの一覧。
   • outputs:ロギング出力ディクショナリーの一覧。

2. オプション:Playbook の構文を確認します。

   # ansible-playbook --syntax-check playbook.yml

   Copy to Clipboard Toggle word wrap

3. Playbook を実行します。

   # ansible-playbook -i inventory_file playbook.yml

   Copy to Clipboard Toggle word wrap

手順

1. 以下の内容を含む playbook.yml ファイルを作成します。

   ---
   - name: Deploying remote input and remote_files output
     hosts: server
     roles:
       - rhel-system-roles.logging
     vars:
       logging_inputs:
         - name: relp_server
           type: relp
           port: 20514
           tls: true
           ca_cert: _/etc/pki/tls/certs/ca.pem_
           cert: _/etc/pki/tls/certs/server-cert.pem_
           private_key: _/etc/pki/tls/private/server-key.pem_
           pki_authmode: name
           permitted_clients:
             - '_*example.client.com_'
       logging_outputs:
         - name: _remote_files_output_
           type: _remote_files_
       logging_flows:
         - name: _example_flow_
           inputs: _relp_server_
           outputs: _remote_files_output_

   Copy to Clipboard Toggle word wrap

   Playbook は、以下の設定を使用します。

   • port:リモートロギングシステムがリッスンしているポート番号です。

   • tls:ネットワーク上でログをセキュアに転送します。セキュアなラッパーが必要ない場合は、tls 変数を false に設定します。デフォルトでは tls パラメーターは true に設定されますが、RELP を使用する場合には鍵/証明書およびトリプレット {ca_cert、cert、private_key} や {ca_cert_src、cert_src、private_key_src} が必要です。

     • {ca_cert_src、cert_src、private_key_src} のトリプレットを設定すると、デフォルトの場所 (/etc/pki/tls/certs と /etc/pki/tls/private) を、コントロールノードから転送する管理対象ノードの宛先として使用します。この場合、ファイル名はトリプレットの元の名前と同じです。
     • {ca_cert、cert、private_key} トリプレットが設定されている場合には、ファイルはロギング設定の前にデフォルトのパスを配置する必要があります。
     • トリプレットの両方が設定されている場合には、ファイルはコントロールノードのローカルのパスから管理対象ノードの特定のパスへ転送されます。
   • ca_cert:CA 証明書へのパスを表します。デフォルトのパスは /etc/pki/tls/certs/ca.pem で、ファイル名はユーザーが設定します。
   • cert:証明書へのパスを表します。デフォルトのパスは /etc/pki/tls/certs/server-cert.pem で、ファイル名はユーザーが設定します。
   • private_key:秘密鍵へのパスを表します。デフォルトのパスは /etc/pki/tls/private/server-key.pem で、ファイル名はユーザーが設定します。
   • ca_cert_src:ローカルの CA 証明書ファイルパスを表します。これはターゲットホストにコピーされます。ca_cert が指定している場合は、その場所にコピーされます。
   • cert_src:ローカルの証明書ファイルパスを表します。これはターゲットホストにコピーされます。cert を指定している場合には、その証明書が場所にコピーされます。
   • private_key_src:ローカルキーファイルのパスを表します。これはターゲットホストにコピーされます。private_key を指定している場合には、その場所にコピーされます。
   • pki_authmode:name または fingerprint の認証モードを使用できます。
   • permitted_clients:ロギングサーバーが TLS 経由での接続およびログ送信を許可するクライアントの一覧。
   • inputs:ロギング入力ディクショナリーの一覧。
   • outputs:ロギング出力ディクショナリーの一覧。

2. オプション:Playbook の構文を確認します。

   # ansible-playbook --syntax-check playbook.yml

   Copy to Clipboard Toggle word wrap

3. Playbook を実行します。

   # ansible-playbook -i inventory_file playbook.yml

   Copy to Clipboard Toggle word wrap