rwreceiver

Un rol para configurar y administrar el servicio rwreceiver. rwreceiver es un daemon que acepta archivos transferidos desde uno o más procesos rwsender. Los archivos recibidos se almacenan en un directorio de destino. Consulte la documentación de rwreceiver para más información.

Requisitos

Si se utiliza TLS para las conexiones, se deben generar y cargar certificados coincidentes tanto en el remitente como en el receptor.

Variables de Rol

Las variables disponibles se enumeran a continuación, junto con los valores predeterminados (ver defaults/main.yml):

silk_packing_tools_loc: "/usr/local/sbin"

La ubicación de la carpeta de las herramientas de empaquetado silk.

silk_tls_support: False

Si se debe usar TLS para las conexiones.

rwreceiver_myname: "rwreceiver"

El nombre del proceso rwreceiver. Es posible ejecutar múltiples copias de rwreceiver en una sola máquina nombrándolas de manera diferente.

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 }}" 

Fuentes de plantilla a usar y sus destinos.

Al usar la opción de soporte de GnuTLS estableciendo silk_tls_support: True, se debe especificar la ruta completa del archivo CA (TLS_CA), así como O la ruta completa al archivo PKCS#12 específico del programa (TLS_PKCS12) O las rutas completas al certificado (TLS_CERT) y al archivo de clave (TLS_KEY) específicos del programa. Si el archivo PKCS#12 está protegido por contraseña, debe establecer la variable de entorno RWRECEIVER_TLS_PASSWORD con la contraseña antes de iniciar rwreceiver. Si RWRECEIVER_TLS_PASSWORD no está establecido, se trata como una contraseña nula; establezca la cadena vacía para permitir una contraseña vacía.

Dependencias

• cmusei.silk

Ejemplo de Playbook

- hosts: server
  become: true
  vars:
    data_root_dir: "/data"
    # configuraciones de 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
    # configuraciones tls de rwreceiver
    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: Copiar certificados 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' ]

Licencia

Copyright 2020 Carnegie Mellon University. SIN GARANTÍA. ESTOS MATERIALES DE LA UNIVERSIDAD CARNEGIE MELLON Y DEL INSTITUTO DE INGENIERÍA DE SOFTWARE SE PROPORCIONAN EN UNA BASE "TAL CUAL". LA UNIVERSIDAD CARNEGIE MELLON NO OFRECE NINGUNA GARANTÍA DE NINGÚN TIPO, YA SEA EXPRESA O IMPLÍCITA, EN CUANTO A CUALQUIER ASUNTO INCLUYENDO, PERO NO LIMITADO A, GARANTÍAS DE ADECUACIÓN PARA UN PROPÓSITO O COMERCIALIZACIÓN, EXCLUSIVIDAD, O RESULTADOS OBTENIDOS DEL USO DEL MATERIAL. LA UNIVERSIDAD CARNEGIE MELLON NO OFRECE NINGUNA GARANTÍA DE NINGÚN TIPO CON RESPECTO A LA LIBERTAD DE INFRACCIONES DE PATENTE, MARCA REGISTRADA O DERECHO DE AUTOR. Publicado bajo una licencia estilo MIT (SEI), consulte license.txt o comuníquese con permission@sei.cmu.edu para obtener los términos completos. [DISTRIBUTION STATEMENT A] Este material ha sido aprobado para su divulgación pública y distribución ilimitada. Consulte el aviso de derechos de autor para su uso y distribución fuera del gobierno de EE. UU. CERT® está registrado en la Oficina de Patentes y Marcas Registradas de EE. UU. por la Universidad Carnegie Mellon. Este software incluye y/o hace uso del siguiente software de terceros sujeto a su propia licencia:

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

Información del Autor

Este rol fue creado en 2019 por Matt Heckathorn.