Ansible collection for managing users, groups, SSH keys and more.

There are several ansible roles in this collection. Together they can set up a Unix system with proper users, groups and, if needed, superpowers. The user can be given SSH keys or a password. It is also possible to restrict login via SSH to the defined users. And it is also possible to delete users.

Please note, it is pretty useless to add an ssh key to an non-existing user directory. So please add users first before running other roles

• l3d.users.user: roles/user
• l3d.users.admin: roles/admin
• l3d.users.sshd: roles/sshd
• l3d.users.dotfiles: roles/dotfiles

You can install the collection using ansible-galaxy by running:

ansible-galaxy collection install l3d.users:1.2.0

Remember you can to Upgrade to the latest version of the l3d.git collection using the --upgrade parameter:

ansible-galaxy collection install l3d.users --upgrade

Or you could clone this collection in your local ansible project for example to collections/ansible_collections/l3d/users/.

# Clone git Repo to specified path
git clone https://github.com/roles-ansible/ansible_collection_users.git collections/ansible_collections/l3d/users/

# change directory
cd collections/ansible_collections/l3d/users/

# optionally install all requirements
ansible-galaxy collection install -r requirements.yml --upgrade

You can also list a collection in requirements.yml:

---
collections:
  - name: l3d.users
    version: ">=1.2.0"

• The dictionary-variable for your group_vars to set your general users and admins is l3d_users__default_users.
• The dictionary-variable for your host_vars to set your host-specific users and admins is: l3d_users__local_users. The Option of these directory-variables are the following.

There is also the l3d_users__ssh_login variable which only supports name and state. It can be used to whitelist users to the sshd config.