Ansible role to configure and secure sshd and optional add a whitelist for users, groups and ssh keys.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
L3D f56cbf5ded
update meta information
2 months ago
.github Add galaxy icon and link 3 months ago
defaults add users to default 3 months ago
handlers start adding github actions and improve meta 4 months ago
meta update meta information 2 months ago
tasks update meta information 2 months ago
templates template improvement? 6 months ago
vars update meta information 2 months ago
.gitignore create yamllint 4 months ago
.yamllint create yamllint 4 months ago
LICENCE Improve LICENCE Text 2 years ago Fixed typo 2 months ago

Ansible Galaxy MIT License

OpenSSH Server

Ansible role to configure the OpenSSH Server SSHD. The main goal of this role is to manage the sshd.conf file. And some additional parts like deploying the defined ssh host keys at the configured path.

Pro Tipp

Use Eliptic cureve cryptografie for your ssh keys:

ssh-keygen -t ed25519

The default values of this role will only allow ed25519 keys. But you can change that obviously if you like.


It is highly recomended to use this role together with a role to manage users and to manage the sshd configuration.
The following roles are tested in combination and work well - at least for the user DO1JLR:

Some Variables explained

Remember: Have a look into defaults/main.yml for all possible variables.

  • SSH Port
    The OpenSSH Port is defined with the variable sshd__port: 22. Change it if you wish.

  • Allowed Users and Groups
    The default users that are allowd to login come from the users: {} list.
    The same users: {} variable is used in the other recomended ssh roles.
    A example to allow the login for the users and groups called l3d and ottojo are:

    - l3d
   - ottojo@uni
   - ottojo@home
  • SSH Login via Passwort
    The SSH Passwort auth is set to false via sshd__password_authentication: false. This won't allow you to use your passwort to login via SSH.

  • Manage SSH Key Types
    By default this role configure which ssh key types are allowed to login. If you don't want to define that change the sshd__manage_key_types: true variable.

  • Define allowed ssh key types
    The allowed SSH Key Types are defined with this list. Some of them are commented out.
    Please not that by defualt only ed25519 keys are allowed. Keep that in mind if you are using a rsa key.

  - 'ed25519'
  # - 'rsa'
  # - 'ecdsa'
  # - 'dsa' # (do not use!)
  • Advanced SSH Algorithm Settings
    You can define the used Key and Kex Algorithm here to. For the default values and some examples for the variables sshd__key_algorithmus and sshd__kex_algorithmus have a look into defaults/main.yml.

  • force new SSH Features
    If you know that you use a ssh version >8 you can optionally define it with true/false with the sshd__version_is_above_eight variable.


The main task of this role is to configure the sshd.conf file.



This role is tested with some linting tests. Sadly I don't know how to run this role in a docker container because systemd is involved... If you have ideas how to improve testing please dend me a message, open a issue or Pull Request. If you want to find out more about our tests, please have a look at the github marketplace.

test status Github Marketplace
Galaxy release publish-ansible-role-to-galaxy
Yamllint GitHub Actions yamllint-github-action
Ansible Lint check ansible-lint action