Incident: Broken SSH Access¶
Description¶
Users cannot SSH into a server due to misconfiguration or permission issues.
Symptoms¶
- Connection refused or timed out
Permission denied
error- Users locked out after SSH key change
Root Cause Checklist¶
- Wrong file permissions on
.ssh/authorized_keys
? - SSH service down?
- Firewall rules changed?
- SSH daemon misconfigured?
Resolution Steps¶
- Gain emergency access (console/Proxmox/IPMI)
- Check SSH service:
systemctl status sshd journalctl -u sshd
- Check user permissions:
ls -la ~/.ssh chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys
- Validate config:
sshd -t
Preventive Actions¶
- Always test new SSH settings in parallel session
- Use fallback user or console access
- Enable monitoring on SSH status
Tools & Commands¶
systemctl
,sshd -t
,chmod
,firewall-cmd
, emergency console