feat: unified launcher, multi-OS hardening, login alerts & auto-updates

Restructure around a single entry point (automations.sh) with a Gum wizard and
a self-extracting bundle for repo-less installs. Add scripts/oslib.sh so the
provisioning scripts (setup-host, harden-ssh, harden-jumphost, sshuser) run on
Alpine/Debian/Alma; seed root keys from globals/.

- ntfy SSH-login alerts (user, source IP, key, region, jump target) via pam_exec
- daily auto-updates with AUTO_REBOOT=idle (reboots only when no SSH active) and
  opt-in Alpine stable-branch upgrades
- generic + per-deployment cloud-init; Gitea release workflow on tag
- README/LICENSE/.gitignore/.gitattributes (force LF); repo URLs -> Gitea
This commit is contained in:
57_Wolve committed 2026-06-12 14:56:02 -05:00
1 parent 85eeb79971
commit 7faa9098de
58 files changed
+6225 -284

No files matched your search

+121 -107
View File
@@ -2,34 +2,24 @@
#
# harden-jumphost.sh
#
# Hardens an Alpine box for use as an SSH jump host (bastion). Run on a fresh
# box. Layered on the same PQ-hybrid posture as harden-ssh.sh, plus jump-host
# specifics.
# Hardens a box for use as an SSH jump host (bastion) on Alpine, Debian, or
# Alma Linux. Layered on the same PQ-hybrid posture as harden-ssh.sh, plus
# jump-host specifics. All distro differences go through scripts/oslib.sh.
#
# Two groups, two privilege levels:
# ssh-admins -- full TTY shell on the jump host (for maintenance only).
# No forwarding. This is for fixing the box, not for
# reaching anywhere else.
# ssh-admins -- full TTY shell on the jump host (maintenance only). No
# forwarding. For fixing the box, not reaching elsewhere.
# ssh-jumpers -- ProxyJump ONLY. No TTY, no shell, no SFTP, no agent
# forwarding. Only direct-tcpip to whitelisted targets.
# These users cannot get a prompt on the jump host even if
# their key works.
#
# How the restriction works:
# - Global default: DisableForwarding yes, PermitTTY no, ForceCommand
# /sbin/nologin. So a user with no group membership cannot do anything.
# - Match Group ssh-admins: re-enables PermitTTY and clears ForceCommand
# so admins get a normal shell. Forwarding stays off.
# - Match Group ssh-jumpers: enables AllowTcpForwarding + PermitOpen
# whitelist. Keeps PermitTTY no and ForceCommand /sbin/nologin so any
# attempt at an interactive session fails -- but ProxyJump (direct-tcpip)
# still works because it doesn't open a session channel.
#
# A note on ProxyJump and ForceCommand:
# `ssh -J jumphost target` opens a direct-tcpip channel on the jump host;
# it is NOT a session/exec request, so ForceCommand never fires. That's
# why this pattern works: jumpers literally cannot run anything on the
# jump host, but their tunnels go through.
# <nologin>. A user in neither group can do nothing.
# - Match Group ssh-admins: re-enables PermitTTY, clears ForceCommand.
# - Match Group ssh-jumpers: enables AllowTcpForwarding + a PermitOpen
# whitelist, but keeps PermitTTY no + ForceCommand <nologin>. ProxyJump
# (direct-tcpip) works because it never opens a session channel, so
# ForceCommand never fires.
#
# Usage:
# bash harden-jumphost.sh
@@ -40,56 +30,57 @@
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck source=scripts/oslib.sh
. "$SCRIPT_DIR/oslib.sh"
# ============================================================================
# CONFIG
# ============================================================================
: "${SSH_PORT:=22}"
: "${ALLOWED_IP:=}"
: "${FORCE:=0}"
# Space-separated host:port list jumpers can reach via ProxyJump.
# Empty means jumpers can ProxyJump nowhere (deny-all). Set this to your
# internal targets, e.g. "10.0.0.5:22 10.0.0.6:22".
# Space-separated host:port list jumpers can reach via ProxyJump. Empty means
# deny-all. e.g. "10.0.0.5:22 10.0.0.6:22".
: "${JUMP_TARGETS:=}"
: "${KEY_COMMENT:=root@$(hostname)-$(date +%Y%m%d)}"
log() { printf '\033[1;32m[+]\033[0m %s\n' "$*"; }
warn() { printf '\033[1;33m[!]\033[0m %s\n' "$*" >&2; }
die() { printf '\033[1;31m[x]\033[0m %s\n' "$*" >&2; exit 1; }
log() { _log "$@"; }
warn() { _warn "$@"; }
die() { _die "$@"; }
[[ $EUID -eq 0 ]] || die "Run as root."
[[ -f /etc/alpine-release ]] || die "This script targets Alpine Linux."
os_detect
log "Detected OS: ${OS_ID} (family ${OS_FAMILY}, init ${INIT_SYSTEM})"
# ----------------------------------------------------------------------------
# 1. Packages
# ----------------------------------------------------------------------------
log "Installing openssh + PAM + sshguard + iptables + gum..."
if apk info -e openssh-server >/dev/null 2>&1 && \
! apk info -e openssh-server-pam >/dev/null 2>&1; then
apk del -q openssh-server || true
fi
apk add -q openssh openssh-server-pam linux-pam sshguard iptables ip6tables openrc gum shadow
log "Installing OpenSSH + sshguard + iptables..."
install_openssh
install_bruteforce_protection
ensure_gum || warn "gum not installed; sshuser will use its CLI mode."
# Install sshuser tool alongside this script if present.
SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
SFTP_PATH="$(sftp_server_path)"
NOLOGIN="$(nologin_path)" # /sbin/nologin (Alpine/Alma) or /usr/sbin/nologin (Debian)
# Install the sshuser tool alongside this script if present.
if [[ -f "$SCRIPT_DIR/sshuser.sh" ]]; then
install -m 0755 "$SCRIPT_DIR/sshuser.sh" /usr/local/bin/sshuser
log "Installed /usr/local/bin/sshuser"
fi
# ----------------------------------------------------------------------------
# 2. PQ KEX detection (same as harden-ssh.sh)
# 2. PQ KEX detection
# ----------------------------------------------------------------------------
log "Checking OpenSSH version supports PQ KEX..."
SSH_VER=$(ssh -V 2>&1 | grep -oE 'OpenSSH_[0-9]+\.[0-9]+' | head -1 | sed 's/OpenSSH_//')
SSH_MAJOR=${SSH_VER%%.*}
SSH_MINOR=${SSH_VER##*.}
HAS_MLKEM=0
HAS_SNTRUP=0
HAS_MLKEM=0; HAS_SNTRUP=0
[[ $SSH_MAJOR -gt 9 || ( $SSH_MAJOR -eq 9 && $SSH_MINOR -ge 0 ) ]] && HAS_SNTRUP=1
[[ $SSH_MAJOR -gt 9 || ( $SSH_MAJOR -eq 9 && $SSH_MINOR -ge 9 ) ]] && HAS_MLKEM=1
[[ $HAS_SNTRUP -eq 1 || $HAS_MLKEM -eq 1 ]] \
|| die "OpenSSH ${SSH_VER} has no PQ KEX. Need >= 9.0."
[[ $HAS_SNTRUP -eq 1 || $HAS_MLKEM -eq 1 ]] || die "OpenSSH ${SSH_VER} has no PQ KEX. Need >= 9.0."
log "OpenSSH ${SSH_VER}: ML-KEM=${HAS_MLKEM} sntrup761=${HAS_SNTRUP}"
KEX_LIST=""
@@ -107,25 +98,16 @@ if [[ ! -f /etc/ssh/ssh_host_ed25519_key ]]; then
fi
chmod 600 /etc/ssh/ssh_host_ed25519_key
chmod 644 /etc/ssh/ssh_host_ed25519_key.pub
log "Host key fingerprint:"
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub | sed 's/^/ /'
# Stop Alpine's sshd init from regenerating RSA/ECDSA keys.
if [[ -f /etc/conf.d/sshd ]]; then
if ! grep -q '^sshd_disable_keygen=' /etc/conf.d/sshd; then
echo 'sshd_disable_keygen="yes"' >> /etc/conf.d/sshd
else
sed -i 's/^sshd_disable_keygen=.*/sshd_disable_keygen="yes"/' /etc/conf.d/sshd
fi
fi
sshd_disable_keygen # Alpine-only; no-op on systemd
# ----------------------------------------------------------------------------
# 4. Groups -- create if missing
# 4. Groups
# ----------------------------------------------------------------------------
log "Ensuring groups ssh-admins and ssh-jumpers exist..."
getent group ssh-admins >/dev/null || addgroup -S ssh-admins
getent group ssh-jumpers >/dev/null || addgroup -S ssh-jumpers
group_add_system ssh-admins
group_add_system ssh-jumpers
# ----------------------------------------------------------------------------
# 5. Root keypair (for ssh-admins maintenance access)
@@ -135,27 +117,35 @@ mkdir -p /root/.ssh
chmod 700 /root/.ssh
touch /root/.ssh/authorized_keys
chmod 600 /root/.ssh/authorized_keys
# Add root to ssh-admins so the Match block applies.
adduser root ssh-admins 2>/dev/null || true
user_add_to_group root ssh-admins
TMP_KEY=$(mktemp -u /tmp/root_ed25519.XXXXXX)
ssh-keygen -q -t ed25519 -f "$TMP_KEY" -N "" -C "$KEY_COMMENT"
ROOT_PUB=$(cat "${TMP_KEY}.pub")
ROOT_PRIV=$(cat "$TMP_KEY")
if ! grep -qxF "$ROOT_PUB" /root/.ssh/authorized_keys; then
echo "$ROOT_PUB" >> /root/.ssh/authorized_keys
grep -qxF "$ROOT_PUB" /root/.ssh/authorized_keys || echo "$ROOT_PUB" >> /root/.ssh/authorized_keys
# Seed root (ssh-admins) with the shared admin keys from globals/ so the
# bastion has a known, secure default login. Best-effort.
if [[ "${SEED_KEYS:-1}" == "1" && -f "$SCRIPT_DIR/lib.sh" ]]; then
# shellcheck source=scripts/lib.sh
. "$SCRIPT_DIR/lib.sh"
load_globals
if declare -f resolve_ssh_keys >/dev/null 2>&1; then
SEEDED=0
while IFS= read -r k; do
[[ -n "$k" ]] || continue
grep -qxF "$k" /root/.ssh/authorized_keys || { echo "$k" >> /root/.ssh/authorized_keys; SEEDED=$((SEEDED+1)); }
done <<< "$(resolve_ssh_keys 2>/dev/null || true)"
[[ "$SEEDED" -gt 0 ]] && log "Seeded ${SEEDED} admin key(s) into /root/.ssh/authorized_keys from globals."
fi
fi
# ----------------------------------------------------------------------------
# 6. Build PermitOpen line from JUMP_TARGETS
# 6. PermitOpen line from JUMP_TARGETS (space-separated -> comma-separated)
# ----------------------------------------------------------------------------
# JUMP_TARGETS is space-separated; PermitOpen wants comma-separated.
# Empty => "none" (deny all). sshd_config doesn't accept a literal empty list.
PERMIT_OPEN_LINE="none"
if [[ -n "$JUMP_TARGETS" ]]; then
PERMIT_OPEN_LINE=$(echo "$JUMP_TARGETS" | tr -s ' ' ',' | sed 's/^,//;s/,$//')
fi
[[ -n "$JUMP_TARGETS" ]] && PERMIT_OPEN_LINE=$(echo "$JUMP_TARGETS" | tr -s ' ' ',' | sed 's/^,//;s/,$//')
# ----------------------------------------------------------------------------
# 7. sshd_config
@@ -164,13 +154,18 @@ log "Writing /etc/ssh/sshd_config..."
[[ -f /etc/ssh/sshd_config.orig ]] || cp /etc/ssh/sshd_config /etc/ssh/sshd_config.orig
cat > /etc/ssh/sshd_config <<EOF
# Generated by harden-jumphost.sh -- $(date -u +%FT%TZ)
# Generated by harden-jumphost.sh on ${OS_ID} -- $(date -u +%FT%TZ)
# Original config preserved at /etc/ssh/sshd_config.orig
Port ${SSH_PORT}
AddressFamily any
ListenAddress 0.0.0.0
ListenAddress ::
PidFile /run/sshd.pid
# VERBOSE so the auth log records key fingerprints and direct-tcpip targets
# (used by the login notifier to report the key and best-effort jump target).
LogLevel VERBOSE
# --- Host key: Ed25519 only ---
HostKey /etc/ssh/ssh_host_ed25519_key
@@ -199,13 +194,15 @@ AuthenticationMethods publickey
MaxAuthTries 3
MaxSessions 10
LoginGraceTime 30s
# Expose the authenticated key (file at \$SSH_USER_AUTH) for the notifier.
ExposeAuthInfo yes
# --- Default posture: deny everything ---
# Anyone not in ssh-admins or ssh-jumpers gets nothing. Matches below
# Anyone not matched below gets nothing. The per-group Match blocks
# selectively re-enable what each group needs.
DisableForwarding yes
PermitTTY no
ForceCommand /sbin/nologin
ForceCommand ${NOLOGIN}
X11Forwarding no
GatewayPorts no
PermitTunnel no
@@ -228,13 +225,11 @@ Compression no
Banner none
# --- Subsystems ---
# SFTP off by default. Admins who need it can be added to a separate
# Match block; jumpers must never have it.
# Subsystem sftp internal-sftp
# SFTP off by default on a jump host; jumpers must never have it. If you
# enable it for admins, log transfers to AUTHPRIV at INFO:
# Subsystem sftp ${SFTP_PATH} -f AUTHPRIV -l INFO
# --- Allowlist ---
# Only members of these groups can authenticate at all. AllowGroups
# enforces this BEFORE the per-group Match blocks run.
AllowGroups ssh-admins ssh-jumpers
# ============================================================================
@@ -252,13 +247,10 @@ Match Group ssh-admins
X11Forwarding no
PermitOpen none
# --- Jumpers: ProxyJump only, no shell, no SFTP, whitelisted destinations ---
# direct-tcpip channels are controlled by AllowTcpForwarding + PermitOpen.
# Session channels (shell/exec/subsystem) hit ForceCommand=/sbin/nologin
# and PermitTTY=no, so any interactive attempt fails immediately.
# --- Jumpers: ProxyJump only, no shell, whitelisted destinations ---
Match Group ssh-jumpers
PermitTTY no
ForceCommand /sbin/nologin
ForceCommand ${NOLOGIN}
AllowTcpForwarding yes
PermitOpen ${PERMIT_OPEN_LINE}
AllowAgentForwarding no
@@ -287,14 +279,17 @@ log "Configuring sshguard..."
mkdir -p /etc/sshguard
WHITELIST=/etc/sshguard/whitelist
{
echo "127.0.0.1"
echo "::1"
echo "127.0.0.1"; echo "::1"
[[ -n "$ALLOWED_IP" ]] && echo "$ALLOWED_IP"
} > "$WHITELIST"
SSHGUARD_BACKEND="$(sshguard_backend)"
SSHGUARD_LOGREADER="$(sshguard_logreader)"
[[ -x "${SSHGUARD_BACKEND}" ]] || warn "sshguard backend not found at ${SSHGUARD_BACKEND}; brute-force blocking may be inactive."
cat > /etc/sshguard/sshguard.conf <<EOF
BACKEND="/usr/libexec/sshg-fw-iptables"
LOGREADER="LANG=C journalctl -afb -p info -n1 -u sshd -o cat"
BACKEND="${SSHGUARD_BACKEND}"
${SSHGUARD_LOGREADER:+LOGREADER="${SSHGUARD_LOGREADER}"}
THRESHOLD=30
BLOCK_TIME=300
DETECTION_TIME=1800
@@ -302,53 +297,74 @@ PID_FILE=/run/sshguard.pid
WHITELIST_FILE=${WHITELIST}
EOF
cat > /etc/local.d/sshguard-iptables.start <<'EOF'
HOOK=$(mktemp)
cat > "$HOOK" <<'EOF'
#!/bin/sh
SSH_PORT=$(awk '/^Port / {print $2; exit}' /etc/ssh/sshd_config)
SSH_PORT=${SSH_PORT:-22}
for ipt in iptables ip6tables; do
command -v "$ipt" >/dev/null 2>&1 || continue
$ipt -N sshguard 2>/dev/null || true
$ipt -C INPUT -p tcp --dport "$SSH_PORT" -j sshguard 2>/dev/null \
|| $ipt -I INPUT -p tcp --dport "$SSH_PORT" -j sshguard
done
EOF
chmod +x /etc/local.d/sshguard-iptables.start
rc-update add local default 2>/dev/null || true
/etc/local.d/sshguard-iptables.start
install_boot_hook sshguard-iptables "$HOOK"
rm -f "$HOOK"
rc-update add sshguard default
rc-service sshguard restart || rc-service sshguard start
svc_enable_start sshguard || warn "Could not start sshguard; check sshguard.conf on this distro."
# ----------------------------------------------------------------------------
# 9b. Optional: SSH login notifier (pam_exec -> ntfy)
# ----------------------------------------------------------------------------
# Enabled when NTFY_URL is provided. On a bastion we default to notifying for
# the two SSH groups and tag the alert with this host's region.
if [[ -n "${NTFY_URL:-}" ]]; then
: "${NOTIFY_GROUPS:=ssh-admins ssh-jumpers}"
: "${NTFY_REGION:=$(host_region)}"
log "Installing SSH login notifier (ntfy)..."
install_login_notifier "$SCRIPT_DIR/ntfy-ssh-login.sh" || warn "Notifier install had issues."
fi
# ----------------------------------------------------------------------------
# 9c. Daily unattended updates (default ON -- recommended for an SSH-only
# bastion; set AUTO_UPDATE=0 to skip). New Alpine *branches* are reported, not
# auto-applied.
# ----------------------------------------------------------------------------
if [[ "${AUTO_UPDATE:-1}" == "1" && -f "$SCRIPT_DIR/auto-update.sh" ]]; then
log "Scheduling daily auto-update (reboot only when idle)..."
AUTO_REBOOT="${AUTO_REBOOT:-idle}" \
ALLOW_RELEASE_UPGRADE="${ALLOW_RELEASE_UPGRADE:-0}" \
NOTIFY="${NOTIFY:-1}" \
bash "$SCRIPT_DIR/auto-update.sh" install || warn "Could not schedule auto-update."
fi
# ----------------------------------------------------------------------------
# 10. Enable sshd
# ----------------------------------------------------------------------------
log "Enabling sshd at boot..."
rc-update add sshd default
SSHD_SVC="$(sshd_service)"
log "Enabling ${SSHD_SVC} at boot..."
svc_enable "$SSHD_SVC"
cat <<EOF
================================================================
JUMP HOST SETUP COMPLETE
JUMP HOST SETUP COMPLETE (${OS_ID})
Groups created:
ssh-admins -- full shell on the jump host (root added)
ssh-jumpers -- ProxyJump only, no shell
Add a jumper user:
adduser -D -s /sbin/nologin alice
addgroup alice ssh-jumpers
mkdir -p /home/alice/.ssh && chmod 700 /home/alice/.ssh
echo 'ssh-ed25519 AAA...' > /home/alice/.ssh/authorized_keys
chmod 600 /home/alice/.ssh/authorized_keys
chown -R alice:alice /home/alice/.ssh
Add a jumper user (using the installed tool):
sshuser add -u alice -r jumper -k "ssh-ed25519 AAA..."
Note the user's shell can be /sbin/nologin -- ProxyJump still works
because it never opens a session channel.
Or an admin:
sshuser add -u bob -r admin -k "ssh-ed25519 AAA..."
Allowed jump targets (PermitOpen):
${PERMIT_OPEN_LINE}
To change targets: edit JUMP_TARGETS and re-run, or edit the Match
To change targets: re-run with JUMP_TARGETS set, or edit the Match
block in /etc/ssh/sshd_config directly.
COPY THIS PRIVATE KEY TO YOUR CLIENT *NOW* (admin/root key):
@@ -366,10 +382,8 @@ Host fingerprint:
$(ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub)
Client usage examples:
# Admin shell on the jump host:
ssh -i ~/.ssh/id_ed25519_jump -p ${SSH_PORT} root@<jumphost>
# ProxyJump through to an internal target:
ssh -J root@<jumphost>:${SSH_PORT} -i ~/.ssh/id_ed25519_target user@<target>
@@ -390,11 +404,11 @@ Reload sshd now? [y/N]
EOF
read -r ans
if [[ "${ans,,}" != "y" && "${ans,,}" != "yes" ]]; then
warn "Skipping reload. Run 'rc-service sshd reload' manually when ready."
warn "Skipping reload. Reload ${SSHD_SVC} manually when ready."
exit 0
fi
fi
log "Reloading sshd..."
rc-service sshd reload || rc-service sshd restart
log "Reloading ${SSHD_SVC}..."
svc_reload "$SSHD_SVC"
log "Done."