Ansible-Roles/roles/openssh/README.md

Ansible Role: openssh_server

Comprehensive OpenSSH server hardening for Debian and Ubuntu systems with support for 16 compliance frameworks, extensive CVE tracking, and version-aware capability detection.

✨ Features

• 🔒 Security-First: Comprehensive hardening with modern cryptography
• 📋 16 Compliance Frameworks: PCI DSS, HIPAA, FedRAMP, FISMA, SOC 2, GDPR, ISO 27001+
• 🛡️ CVE Tracking: Comprehensive mitigation status for 20+ OpenSSH vulnerabilities
• 🌍 Supported Distributions:
  • Debian: 11 (Bullseye), 12 (Bookworm), 13 (Trixie), 14 (Forky/Testing)
  • Ubuntu: 22.04 LTS, 24.04 LTS, 25.10
  • Rocky Linux: 8, 9, 10
• 🔐 Post-Quantum Ready: ML-KEM support for OpenSSH 9.9+
• 🔑 FIDO2/WebAuthn: Hardware security key authentication
• 📊 13 Capability Flags: Automatic feature detection and version-aware configuration

🚀 Quick Start

Installation

Then install:

ansible-galaxy install -r requirements.yml

Basic Usage

---
- hosts: all
  become: true
  roles:
    - role: openssh_server

Advanced Configuration

---
- hosts: production_servers
  become: true
  roles:
    - role: openssh_server
      vars:
        # Disable password authentication
        openssh_password_authentication: false

        # Restrict root login
        openssh_permit_root_login: "prohibit-password"

        # Enable advanced security features (version-aware)
        openssh_enable_persourcepenalties: true
        openssh_enable_verbose_logging: true
        openssh_required_rsa_size: 3072

        # Limit access to specific users
        openssh_allow_users:
          - deploy
          - admin

📚 Documentation

• Distribution Support - Debian/Ubuntu version matrix and capability flags
• Compliance Frameworks - PCI DSS, HIPAA, FedRAMP, SOC 2, GDPR, ISO 27001+
• CVE Tracking - Vulnerability status by distribution with patch details
• Configuration Reference - Complete role variables documentation
• Examples - Configuration examples for different use cases
• Troubleshooting - Common issues and debugging

🔧 Requirements

• Ansible: 2.15+
• Platform: Debian 9+ or Ubuntu 16.04+
• Collections:
  • ansible.posix >= 1.5.0
  • community.general >= 8.0.0

🔐 Security Features

Core Security

• ✅ Key-based authentication only (password auth disabled by default)
• ✅ Modern cryptography (ChaCha20-Poly1305, AES-GCM preferred over AES-CTR)
• ✅ Strong key exchange (Curve25519, DH Group 16/18)
• ✅ Configuration validation (sshd -t before applying)
• ✅ Automatic backups (previous config saved)
• ✅ Login attempt limits (MaxAuthTries, LoginGraceTime)
• ✅ Client keepalive (prevents hung connections)
• ✅ Comprehensive logging (VERBOSE level with optional LogVerbose)

Advanced Security Features (Version-Aware)

• OpenSSH 10.0+: ML-KEM Post-Quantum Cryptography, Enhanced AES-GCM preference
• OpenSSH 9.8+: PerSourcePenalties (automatic rate limiting)
• OpenSSH 9.3+: RequiredRSASize (enforce 3072-bit RSA minimum)
• OpenSSH 8.5+: LogVerbose (enhanced forensic logging)
• OpenSSH 8.2+: FIDO2/WebAuthn hardware security key support
• All Versions: Session re-keying, certificate authority support, moduli verification

🌍 Compliance Support

This role supports compliance with 16 major regulatory frameworks and standards:

Financial Services: PCI DSS 4.0, SOX, SAMA CSF Healthcare & Privacy: HIPAA, HITRUST CSF, GDPR Cloud Standards: ISO/IEC 27017, 27018, 27037, 27040, 27701 Government: FedRAMP, FISMA, NERC CIP, NCA ECC, UAE IA Trust Frameworks: SOC 2

See docs/COMPLIANCE.md for detailed compliance mappings.

🛡️ CVE Mitigation

The role provides comprehensive protection against 20+ OpenSSH vulnerabilities:

• CVE-2024-6387 ("regreSSHion"): Patched on all current LTS distributions
• CVE-2023-48795 (Terrapin Attack): Patched via vendor backports
• CVE-2023-38408 (PKCS#11 RCE): Patched on all distributions
• And many more... See docs/CVE-TRACKING.md for complete status

📋 Example Playbooks

See the examples/ directory for complete playbooks:

• basic-hardening.yml - Simple SSH hardening
• pci-dss-compliance.yml - PCI DSS 4.0 configuration
• fedramp.yml - FedRAMP Moderate & High baseline
• maximum-security.yml - Maximum security hardening
• fido2-hardware-keys.yml - Security key authentication

🤝 Contributing

Contributions are welcome! This role is designed to be community-driven.

Please see CONTRIBUTING.md for detailed guidelines on:

• Development workflow and coding standards
• Testing requirements and validation
• Documentation expectations
• Pull request process
• Security contribution guidelines

📝 License

MIT License - Copyright (c) 2025 Gravitino LLC

See LICENSE for full details.

---