ansible-users

Rôle pour gérer les utilisateurs sur un système.

Ceci est un fork de singleplatform-eng.users car il semble ne plus être maintenu.

Configuration du rôle

• users_create_per_user_group (par défaut : true) - lors de la création d'utilisateurs, crée également un groupe avec le même nom d'utilisateur et fait de ce groupe le groupe principal de l'utilisateur.
• users_group (par défaut : users) - si users_create_per_user_group n'est pas défini, alors ceci est le groupe principal pour tous les utilisateurs créés.
• users_default_shell (par défaut : /bin/bash) - le shell par défaut si aucun n'est spécifié pour l'utilisateur.
• users_create_homedirs (par défaut : true) - crée des répertoires personnels pour les nouveaux utilisateurs. Mettez ceci à false si vous gérez les répertoires personnels séparément.
• authorized_keys_file (par défaut : .ssh/authorized_keys) - définissez ceci si le serveur ssh est configuré pour utiliser un fichier de clés autorisées non standard.

Création d'utilisateurs

Ajoutez une variable utilisateurs contenant la liste des utilisateurs à ajouter. Un bon endroit pour cela est dans group_vars/all ou group_vars/groupname si vous ne souhaitez que ces utilisateurs sur certaines machines.

Les attributs suivants sont requis pour chaque utilisateur :

• username - Le nom d'utilisateur de l'utilisateur.
• name - Le nom complet de l'utilisateur (champ gecos).
• home - Le répertoire personnel de l'utilisateur à créer (optionnel, par défaut /home/username).
• uid - L'identifiant numérique de l'utilisateur (optionnel). Ceci est requis pour la cohérence des uid entre les systèmes.
• gid - L'identifiant numérique du groupe (optionnel). Sinon, le uid sera utilisé.
• password - Si un hash est fourni, il sera utilisé, sinon le compte sera verrouillé.
• update_password - Cela peut être soit 'always' soit 'on_create'
  • 'always' mettra à jour les mots de passe s'ils diffèrent. (par défaut)
  • 'on_create' ne définira le mot de passe que pour les utilisateurs nouvellement créés.
• group - Remplacement du groupe principal (optionnel).
• groups - Une liste de groupes supplémentaires pour l'utilisateur.
• append - Si oui, ajoutera seulement des groupes, ne les définira pas seulement à la liste dans groups (optionnel).
• profile - Un bloc de chaîne pour définir des profils de shell personnalisés.
• ssh_key - Cela doit être une liste de clés SSH pour l'utilisateur (optionnel). Chaque clé SSH doit être incluse directement et ne doit pas avoir de retours à la ligne.
• generate_ssh_key - Indique s'il faut générer une clé SSH pour l'utilisateur (optionnel, par défaut : non).

De plus, les éléments suivants sont optionnels pour chaque utilisateur :

• shell - Le shell de l'utilisateur. Cela par défaut à /bin/bash. Le défaut est configurable à l'aide de la variable users_default_shell si vous voulez donner le même shell à tous les utilisateurs, mais il est différent de /bin/bash.

Exemple :

---
users:
  - username: foo
    name: Foo Barrington
    groups: ['wheel','systemd-journal']
    uid: 1001
    home: /local/home/foo
    profile: |
      alias ll='ls -lah'
    ssh_key:
      - "ssh-rsa AAAAA.... foo@machine"
      - "ssh-rsa AAAAB.... foo2@machine"
groups_to_create:
  - name: developers
    gid: 10000
users_deleted:
  - username: bar
    name: Bar User
    uid: 1002

Suppression d'utilisateurs

La variable users_deleted contient une liste d'utilisateurs qui ne doivent plus être dans le système, et ceux-ci seront supprimés lors de la prochaine exécution d'ansible. Le format est le même que pour les utilisateurs à ajouter, mais le seul champ requis est username. Toutefois, il est recommandé de conserver également le champ uid à titre de référence afin que les identifiants numériques d'utilisateur ne soient pas accidentellement réutilisés.

Vous pouvez également choisir de supprimer le répertoire personnel de l'utilisateur et le spool de mail avec le paramètre remove, et forcer la suppression des fichiers avec le paramètre force.

users_deleted:
  - username: bar
    uid: 1002
    remove: yes
    force: yes