diff options
| author | Ahmed AbdelHalim <[email protected]> | 2025-08-11 00:32:01 +0200 |
|---|---|---|
| committer | Ahmed AbdelHalim <[email protected]> | 2025-08-11 00:32:01 +0200 |
| commit | e1919c8d12d61a5b454d6a3372caa21c6d436dcd (patch) | |
| tree | 43c4e64ec450e05787fa35906d2ec4327b4df09c /roles/ssh/README.md | |
| parent | c3759bbd12585643b02c1d0108e778038d0e6d26 (diff) | |
Add ssh role
Diffstat (limited to 'roles/ssh/README.md')
| -rw-r--r-- | roles/ssh/README.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/roles/ssh/README.md b/roles/ssh/README.md new file mode 100644 index 00000000..7786808a --- /dev/null +++ b/roles/ssh/README.md @@ -0,0 +1,23 @@ +# Ansible Role: ssh + +This role configure the ssh functionality of a linux distro with hardening + +## Role Variables + +- `username` the user account to be added to the ssh allowed users. +- `ssh_port` the port number to be enabled for ssh (default: 2222) + +## Internals + +- ensure that ssh packages is installed and enabled +- configure ssh host keys +- configure ssh defaults + - disable keyboard interactive authentication + - disable PAM authentication +- configure ssh authentication policy (hardened) + - configure custom ssh port + - disable password authentication + - require public key authentication + - disable root login +- add user (username) to allowed authentication users +- TBA: `fail2ban` |