cmusei.rwreceiver

rwreceiver

=========

rwreceiverサービスの設定と管理のための役割です。rwreceiverは、1つ以上のrwsenderプロセスから転送されたファイルを受け入れるデーモンです。受け取ったファイルは、指定されたディレクトリに保存されます。詳細については、rwreceiverのドキュメントをご覧ください。

必要条件

TLSを使用する場合、送信者と受信者の両方に対して一致する証明書を生成してアップロードする必要があります。

役割変数

利用可能な変数とそのデフォルト値は以下の通りです（defaults/main.ymlを参照してください）：

• silk_packing_tools_loc: "/usr/local/sbin"

  silkパッキングツールのフォルダの場所。

• silk_tls_support: False

  接続にTLSを使用するかどうか。

• rwreceiver_myname: "rwreceiver"

  rwreceiverプロセスの名前。異なる名前を付ければ、単一のボックス上で複数のrwreceiverを実行できます。

• rwreceiver_conf_template: "rwreceiver.conf.j2"

• rwreceiver_conf_file_loc: "/usr/local/etc"

• rwreceiver_conf_file_path: "{{ rwreceiver_conf_file_loc }}/{{ rwreceiver_myname }}.conf"

• rwreceiver_init_template: "rwreceiver.j2"

• rwreceiver_init_file_path: "/etc/init.d/{{ rwreceiver_myname }}"

  使用するテンプレートとその保存先。

オプションのGnuTLSサポートを使用する場合は、CAファイル（TLS_CA）のフルパスを指定する必要があります。さらに、プログラム固有のPKCS#12ファイル（TLS_PKCS12）のフルパスまたはプログラム固有の証明書（TLS_CERT）および鍵（TLS_KEY）のフルパスのいずれかを指定する必要があります。PKCS#12ファイルがパスワードで保護されている場合は、rwreceiverを起動する前にRWRECEIVER_TLS_PASSWORD環境変数にパスワードを設定する必要があります。

依存関係

• cmusei.silk

例プレイブック

- hosts: server
  become: true
  vars:
    data_root_dir: "/data"
    # rwreceiverの設定
    silk_tls_support: True
    rwreceiver_statedirectory: "{{ data_root_dir }}/rwreceiver"
    rwreceiver_destination_dir: "{{ rwreceiver_statedirectory }}/incoming"
    rwreceiver_create_directories: "yes"
    rwreceiver_mode: "server"
    rwreceiver_port: "3737"
    rwreceiver_sender_clients: |
      sender1
      sender2
    # rwreceiverのTLS設定
    tls_ca: "testcert.pem"
    tls_key: "client-key.pem"
    tls_cert: "client-cert.pem"
    rwreceiver_tls_ca: "/etc/pki/tls/{{ tls_ca }}"
    rwreceiver_tls_key: "/etc/pki/tls/private/{{ tls_key }}"
    rwreceiver_tls_cert: "/etc/pki/tls/{{ tls_cert }}"
    rwreceiver_pid_dir: "/var/run"
  pre_tasks:
    - name: SSL証明書をコピー
      copy:
        src: "{{ item.f }}"
        dest: "{{ item.d }}"
        mode: "{{ item.m }}"
        owner: "root"
        group: "root"
      with_items:
        - f: "{{ tls_ca }}"
          d: "{{ rwreceiver_tls_ca }}"
          m: '0644'
        - f: "{{ tls_key }}"
          d: "{{ rwreceiver_tls_key }}"
          m: '0600'
        - f: "{{ tls_cert }}"
          d: "{{ rwreceiver_tls_cert }}"
          m: '0644'
  roles:
    - role: cmusei.rwreceiver
      tags: [ 'rwreceiver' ]

ライセンス

Copyright 2020 Carnegie Mellon University. 保証はありません。これは「現状のまま」で提供されるCarnegie Mellon大学およびソフトウェア工学研究所の資料です。Carnegie Mellon大学は、目的や商品性、排他性、あるいは資料の使用によって得られる結果に関するいかなる保証も行いません。Carnegie Mellon大学は、特許、商標、著作権の侵害からの自由に関していかなる保証も行いません。 MIT（SEI）スタイルのライセンスの下で公開されており、詳細な条項についてはlicense.txtを参照するか、permission@sei.cmu.eduに連絡してください。 [DISTRIBUTION STATEMENT A] この資料は公共のリリースと無制限の配布が承認されています。米国政府以外の使用と配布に関しては著作権の通知を参照してください。 CERT®はCarnegie Mellon大学により、米国特許商標庁に登録されています。 このソフトウェアには、独自のライセンスに従った以下のサードパーティソフトウェアが含まれています：

1. ansible (https://github.com/ansible/ansible/tree/devel/licenses) Copyright 2019 Red Hat, Inc.
2. molecule (https://github.com/ansible-community/molecule/blob/master/LICENSE) Copyright 2018 Red Hat, Inc.
3. testinfra (https://github.com/philpep/testinfra/blob/master/LICENSE) Copyright 2020 Philippe Pepiot.

DM20-0505

著者情報

この役割は2019年にMatt Heckathornによって作成されました。