rwreceiver

Un rôle pour configurer et gérer le service rwreceiver. rwreceiver est un démon qui accepte des fichiers transférés depuis un ou plusieurs processus rwsender. Les fichiers reçus sont stockés dans un répertoire de destination. Consultez la documentation pour plus d'informations.

Exigences

Si vous utilisez TLS pour les connexions, des certificats correspondants doivent être générés et téléchargés à la fois sur l'émetteur et le récepteur.

Variables du Rôle

Les variables disponibles sont listées ci-dessous, ainsi que leurs valeurs par défaut (voir defaults/main.yml) :

silk_packing_tools_loc: "/usr/local/sbin"

Le chemin du dossier contenant les outils de packing Silk.

silk_tls_support: False

Indique si TLS doit être utilisé pour les connexions.

rwreceiver_myname: "rwreceiver"

Le nom du processus rwreceiver. Il est possible d'exécuter plusieurs copies de rwreceiver sur une seule machine en leur donnant des noms différents.

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

Modèles à utiliser et leurs destinations.

Lors de l'utilisation du support optionnel GnuTLS en configurant silk_tls_support: True, le chemin complet du fichier CA (TLS_CA) doit être spécifié, ainsi que SOIT le chemin complet du fichier PKCS#12 spécifique au programme (TLS_PKCS12) OU les chemins complets du certificat (TLS_CERT) et de la clé (TLS_KEY) spécifiques au programme. Si le fichier PKCS#12 est protégé par un mot de passe, vous devez définir la variable d'environnement RWRECEIVER_TLS_PASSWORD sur le mot de passe avant de démarrer rwreceiver. Si RWRECEIVER_TLS_PASSWORD n'est pas défini, il est traité comme un mot de passe nul ; définissez-le sur la chaîne vide pour permettre un mot de passe vide.

Dépendances

• cmusei.silk

Exemple de Playbook

- hosts: server
  become: true
  vars:
    data_root_dir: "/data"
    # paramètres 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
    # paramètres 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: Copier les certificats 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' ]

Licence

Droits d'auteur 2020 Carnegie Mellon University.
AUCUNE GARANTIE. CE MATÉRIEL DE CARNEGIE MELLON UNIVERSITY ET DE L'INSTITUT D'INGÉNIERIE LOGICIELLE EST FOURNI "EN L'ÉTAT". CARNEGIE MELLON UNIVERSITY NE FOURNIT AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, QUANT À QUOI QUE CE SOIT, Y COMPRIS, MAIS SANS S'Y LIMITER, À LA GARANTIE D'APTITUDE À UN USAGE OU DE COMMERCIALISATION, D'EXCLUSIVITÉ, OU DE RÉSULTATS OBTENUS PAR L'UTILISATION DU MATÉRIEL. CARNEGIE MELLON UNIVERSITY NE DONNE AUCUNE GARANTIE QUELCONQUE EN CE QUI CONCERNE LA LIBERTÉ DES BREVETS, DES MARQUES DÉPOSÉES OU DES DROITS D'AUTEUR.
Publié sous une licence de type MIT (SEI), veuillez consulter license.txt ou contacter permission@sei.cmu.edu pour les termes complets.
[STATEMENT DE DISTRIBUTION A] Ce matériel a été approuvé pour publication et distribution illimitée. Veuillez consulter l'avis de droits d'auteur pour une utilisation et une distribution non gouvernementales des États-Unis.
CERT® est enregistré au Bureau américain des brevets et des marques par Carnegie Mellon University.
Ce logiciel inclut et / ou utilise le logiciel tiers suivant soumis à sa propre licence :

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

DM20-0505

Informations sur l'Auteur

Ce rôle a été créé en 2019 par Matt Heckathorn.