Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 12: SSH und macOS-Kommandos

Ziel: SSH-Verbindungen über eine saubere Konfiguration steuern und macOS-Eigenheiten aus dem Terminal nutzen. · Dauer: ca. 90 min · Voraussetzung: Tag 11

Briefing

  • Alles läuft mit ssh -F ~/term-lab/ssh/config. Deine echte ~/.ssh liest und schreibt das Lab nicht.
  • Ein eigener sshd auf 127.0.0.1:2222 spielt Bastion und Zielserver. Die macOS-Freigabe „Entfernte Anmeldung“ bleibt aus.
  • ssh -G <host> zeigt die effektive Konfiguration, ohne zu verbinden. Das ist dein Debugger.
  • Für macOS gilt: Lesen ist frei, Schreiben (defaults write, launchctl) nur bewusst und mit Backup (Tag 13).
Mac ──ssh──► lab-bastion (127.0.0.1:2222) ──ProxyJump──► lab-app (127.0.0.1:2222)
 │  ControlMaster: eine TCP-Verbindung, Socket ~/term-lab/ssh/cm-<hash>
 └─ ssh-agent (Lab-Socket) mit Lab-Key id_lab

Drill 1: Lab-Key und Beispielkonfiguration

mkdir -p ~/term-lab/ssh && chmod 700 ~/term-lab/ssh && cd ~/term-lab/ssh
ssh-keygen -q -t ed25519 -f id_lab -N '' -C 'lab-key (Lab-Wert)'
cp $BUCH/ssh/config config
ssh -G -F config app-web01 | grep -E '^(hostname|user|proxyjump|controlpersist) '

Erwartet:

user deploy
hostname app-web01.internal.example.com
controlpersist 600
proxyjump bastion

-N '' heißt: keine Passphrase. Das ist nur für den Lab-Key in Ordnung. Echte Keys bekommen eine Passphrase, die der Schlüsselbund sich merkt (Drill 5).

Warum %h.internal.example.com? Host app-* passt auf jeden Namen mit diesem Präfix, %h setzt ihn ein. Ein Block bedient so hundert Server.

Achtung: Bei SSH gewinnt der erste gefundene Wert. Spezielle Host-Blöcke gehören nach oben, Host * ans Ende.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Ein Übungs-sshd auf localhost

Ein sshd läuft auch ohne Root, wenn er einen hohen Port und eigene Schlüssel nutzt:

ssh-keygen -q -t ed25519 -f hostkey -N '' -C lab-host
cp id_lab.pub authorized_keys && chmod 600 authorized_keys
cat > sshd_config <<EOF
Port 2222
ListenAddress 127.0.0.1
HostKey $HOME/term-lab/ssh/hostkey
AuthorizedKeysFile $HOME/term-lab/ssh/authorized_keys
PasswordAuthentication no
KbdInteractiveAuthentication no
UsePAM no
StrictModes no
PidFile $HOME/term-lab/ssh/sshd.pid
EOF
/usr/sbin/sshd -t -f ~/term-lab/ssh/sshd_config && echo "sshd_config ok"
/usr/sbin/sshd -f ~/term-lab/ssh/sshd_config -E ~/term-lab/ssh/sshd.log
tail -1 sshd.log

Erwartet:

sshd_config ok
Server listening on 127.0.0.1 port 2222.

Der Heredoc ohne Anführungszeichen (<<EOF) setzt $HOME beim Schreiben ein, denn sshd_config kennt keine Tilde. Auch -f braucht einen absoluten Pfad: sshd wechselt nach / und startet sich pro Verbindung neu – mit relativem Pfad bricht jeder Login ab. Jetzt die Lab-Hosts an die Konfiguration anhängen:

cat >> config <<'EOF'

Host lab-bastion
  HostName 127.0.0.1
  Port 2222
  IdentityFile ~/term-lab/ssh/id_lab

Host lab-app
  HostName 127.0.0.1
  Port 2222
  IdentityFile ~/term-lab/ssh/id_lab
  ProxyJump lab-bastion
EOF
alias lssh='ssh -F ~/term-lab/ssh/config'
lssh -o StrictHostKeyChecking=accept-new lab-bastion 'echo hallo von $(hostname -s)'

Erwartet:

Warning: Permanently added '[127.0.0.1]:2222' (ED25519) to the list of known hosts.
hallo von <dein-mac>

Die Blöcke stehen hinter Host *. Das ist hier in Ordnung, weil Host * weder HostName noch Port setzt. ControlMaster und known_hosts aus Host * gelten trotzdem.

Fortschritt speichern? Kostenlos registrieren

Drill 3: ControlMaster

Die erste Verbindung öffnet einen Master-Socket, alle weiteren nutzen ihn mit:

ls ~/term-lab/ssh/cm-*
lssh -O check lab-bastion
time (lssh lab-bastion true)
time (lssh -o ControlPath=none lab-bastion true)

Erwartet (gekürzt):

/Users/<du>/term-lab/ssh/cm-3138ceb4c1d01333e4071a34291d27c4ce972f7a
Master running (pid=6855)
( lssh lab-bastion true; )  0,00s user 0,00s system 30% cpu 0,007 total
( lssh -o ControlPath=none lab-bastion true; )  0,01s user ... 0,051 total

Lokal sind es 7 statt 51 Millisekunden. Bei einem echten Server mit Bastion werden aus einer Sekunde Handshake ein paar Millisekunden. Das merkst du bei git fetch, scp, rsync und Ansible sofort.

%C im ControlPath ist ein Hash aus Host, Port und User. So bleibt der Pfad kurz, denn Unix-Sockets vertragen nur rund 100 Zeichen.

lssh -O exit lab-bastion

Erwartet:

Exit request sent.

Fortschritt speichern? Kostenlos registrieren

Drill 4: ProxyJump und Port-Forwarding

lab-app ist nur über die Bastion erreichbar – zumindest laut Konfiguration:

lssh lab-app 'echo via jump: $SSH_CONNECTION'
lssh -G lab-app | grep -E '^(proxyjump|hostname|port) '

Erwartet:

via jump: 127.0.0.1 52383 127.0.0.1 2222
hostname 127.0.0.1
port 2222
proxyjump lab-bastion

Ad hoc, ohne Konfiguration, geht dasselbe mit -J:

lssh -J lab-bastion -p 2222 -i ~/term-lab/ssh/id_lab 127.0.0.1 'echo J ok'

Erwartet:

J ok

Sicherheit: Nutze ProxyJump statt ForwardAgent yes. Mit Agent-Forwarding kann ein Root auf der Bastion deinen Agent für eigene Logins missbrauchen. ProxyJump reicht nur verschlüsselte Bytes durch.

Port-Forwarding (hohe Ports, damit nichts mit deinen Diensten auf 8000/8080 kollidiert):

mkdir -p ~/term-lab/www && echo "hallo aus dem Lab" > ~/term-lab/www/index.html
python3 -m http.server 18080 --bind 127.0.0.1 -d ~/term-lab/www >/dev/null 2>&1 &
WEB=$!
lssh -f -N -L 19080:127.0.0.1:18080 lab-bastion
curl -s http://127.0.0.1:19080/

Erwartet:

hallo aus dem Lab

-f -N schickt ssh ohne Remote-Befehl in den Hintergrund. Weil ControlMaster auto greift, wird diese Verbindung zum Master. lssh -O forward -L 19081:127.0.0.1:18080 lab-bastion hängt später weitere Tunnel an, ohne neu zu verbinden.

lssh -O exit lab-bastion
kill $WEB

Fortschritt speichern? Kostenlos registrieren

Drill 5: ssh-agent und Schlüsselbund

macOS startet für dich einen Agent über launchd. Das Lab nutzt einen eigenen, damit deine echten Keys nicht auftauchen:

eval "$(ssh-agent -a ~/term-lab/ssh/agent.sock)"
ssh-add -l
ssh-add -t 1h ~/term-lab/ssh/id_lab
ssh-add -l

Erwartet (Fingerprint gekürzt):

Agent pid 13021
The agent has no identities.
Identity added: /Users/<du>/term-lab/ssh/id_lab (lab-key (Lab-Wert))
Lifetime set to 3600 seconds
256 SHA256:… lab-key (Lab-Wert) (ED25519)

-t 1h lässt den Key nach einer Stunde verfallen. Am Ende den Lab-Agent beenden:

ssh-agent -k

Erwartet:

unset SSH_AUTH_SOCK;
unset SSH_AGENT_PID;
echo Agent pid 13021 killed;

Für echte Keys mit Passphrase übernimmt Apples OpenSSH den Schlüsselbund. Das schreibt in deinen Login-Schlüsselbund, deshalb hier nur zum Lesen:

man ssh-add | col -b | grep -A2 -- '--apple-use-keychain'

Erwartet:

     --apple-use-keychain
         When adding identities, each passphrase will also be stored in
         the user's keychain.  When removing identities with -d, each

Dazu gehören in der echten ~/.ssh/config AddKeysToAgent yes und UseKeychain yes (stehen schon in der Beispielkonfig). Dann fragt macOS die Passphrase einmal und nie wieder.

Tipp: Mit dem 1Password-SSH-Agent verlassen private Keys den Tresor nie. Er wird per IdentityAgent "~/Library/Group Containers/2BUA8C4S2C.com.1password/t/agent.sock" eingebunden; jede Nutzung bestätigst du per Touch ID. Der Block steht auskommentiert in $BUCH/ssh/config.

Fortschritt speichern? Kostenlos registrieren

Drill 6: open, pbcopy/pbpaste, mdfind, caffeinate

cd ~/term-lab/projekt
git log --oneline -3 | pbcopy
pbpaste | wc -l
pbpaste | tr a-z A-Z | pbcopy
pbpaste | head -1
open .                       # Finder im aktuellen Ordner
open -R README.md            # Datei im Finder markieren
open -a TextEdit README.md   # mit bestimmter App öffnen

Erwartet:

       3
2E4E6AA CHORE: CONFIG, MANIFESTE, REPORT

pbcopy/pbpaste verbinden Pipes mit der Zwischenablage. Zusammen mit y in Neovim (Tag 11) und dem tmux-Copy-Mode (Tag 8) gibt es nur noch eine Zwischenablage.

Spotlight im Terminal:

mdfind -count 'kMDItemFSName == "*.md"'
mdfind -onlyin ~/term-lab 'kMDItemFSName == "*.go"'
mdls -name kMDItemKind -name kMDItemContentType README.md

Erwartet (gekürzt, kann je nach Indexstand abweichen):

9546
/Users/<du>/term-lab/projekt/cmd/shop/main.go
/Users/<du>/term-lab/projekt/internal/cart/cart.go
kMDItemContentType = "dyn.ah62d4rv4ge8043a"
kMDItemKind        = "Markdown document"

Frisch angelegte Dateien indiziert Spotlight erst nach einer Weile. Bis dahin liefern mdfind nichts und mdls nur (null). Für sofortige Ergebnisse bleibt fd (Tag 6).

caffeinate hält den Mac wach, solange ein Befehl läuft:

caffeinate -i make test      # kein Ruhezustand während der Tests
caffeinate -d -t 3600 &      # Display eine Stunde an
time caffeinate -i -t 1

Erwartet (gekürzt):

caffeinate -i -t 1  0,00s user 0,00s system 0% cpu 1,051 total

Fortschritt speichern? Kostenlos registrieren

Drill 7: defaults, networkQuality, say, osascript, security

defaults liest und schreibt die Einstellungen der Apps. Das Skript aus dem Buch liest nur und schlägt die passenden write-Befehle vor:

$BUCH/macos/defaults-lesen.sh | head -5
defaults read -g AppleLocale
defaults read-type -g AppleLocale

Erwartet (Werte hängen von deinem Mac ab):

Domain                   Key                      Ist-Wert
com.apple.dock           autohide                 (Standard)
  Setzen mit: defaults write com.apple.dock autohide -bool true
com.apple.dock           show-recents             (Standard)
  Setzen mit: defaults write com.apple.dock show-recents -bool false
de_DE
Type is string

Schreiben übst du an einer eigenen plist-Datei statt an einer echten Domain:

defaults write ~/term-lab/demo.plist Greeting -string "Hallo Lab"
defaults read ~/term-lab/demo.plist
plutil -p ~/term-lab/demo.plist

Erwartet:

{
    Greeting = "Hallo Lab";
}
{
  "Greeting" => "Hallo Lab"
}

Achtung: defaults write auf echte Domains wirkt oft erst nach killall Dock/killall Finder – und ohne Backup gibt es kein Undo. Erst defaults export com.apple.dock dock-backup.plist, dann ändern (Tag 13).

Weitere Helfer, alle nur lesend oder lokal:

sw_vers --productVersion
sysctl -n machdep.cpu.brand_string
networkQuality -M 8 | tail -4
say -v '?' | grep de_DE | head -2
say -v Anna "Build fertig"
osascript -e 'return (1 + 1) as text'
osascript -l JavaScript -e 'Math.max(3, 7)'

Erwartet (gekürzt, auf dem Testrechner):

15.6.1
Apple M4
Uplink capacity: 15.146 Mbps
Downlink capacity: 52.026 Mbps
Responsiveness: Medium (227.622 milliseconds | 263 RPM)
Idle Latency: 30.415 milliseconds | 1972 RPM
Anna                de_DE    # Hallo! Ich heiße Anna.
Eddy (Deutsch (Deutschland)) de_DE    # Hallo! Ich heiße Eddy.
2
7

Responsiveness ist die Latenz unter Last. Sie erklärt ruckelige Calls besser als die reine Bandbreite. Und make test; say fertig holt dich zurück, wenn ein langer Lauf vorbei ist.

security spricht mit dem Schlüsselbund. Im Lab mit einem eigenen Schlüsselbund, der nicht in der Suchliste landet:

KC=~/term-lab/lab.keychain-db
security create-keychain -p lab-kc-pass-1234 $KC
security add-generic-password -a lab -s term-lab-api -w 'sk-lab-master-1234' $KC
security find-generic-password -a lab -s term-lab-api -w $KC
security delete-keychain $KC

Erwartet:

sk-lab-master-1234

Im echten Leben lädst du so Tokens in Variablen, statt sie in Dotfiles zu schreiben: export GITHUB_TOKEN=$(security find-generic-password -s github-cli -w).

Fortschritt speichern? Kostenlos registrieren

Drill 8: Ein launchd-Agent

launchd ersetzt auf dem Mac cron. Ein User-Agent ist eine plist-Datei. Das Beispiel schreibt alle 5 Minuten einen Zeitstempel:

mkdir -p ~/term-lab/launchd && cd ~/term-lab/launchd
sed "s/USERNAME/$(id -un)/" $BUCH/macos/de.term-lab.heartbeat.plist \
  > de.term-lab.heartbeat.plist
plutil -lint de.term-lab.heartbeat.plist
plutil -extract Label raw de.term-lab.heartbeat.plist
plutil -extract StartInterval raw de.term-lab.heartbeat.plist

Erwartet:

de.term-lab.heartbeat.plist: OK
de.term-lab.heartbeat
300

plutil -lint findet Tippfehler, bevor launchd sie stillschweigend ignoriert:

sed 's|</dict>||' de.term-lab.heartbeat.plist > kaputt.plist
plutil -lint kaputt.plist

Erwartet:

kaputt.plist: Close tag on line 28 does not match open tag dict

Aktivieren ist ein bewusster Schritt außerhalb des Labs. Die Befehle zum Nachschlagen (im Buch nicht ausgeführt):

cp de.term-lab.heartbeat.plist ~/Library/LaunchAgents/
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/de.term-lab.heartbeat.plist
launchctl print gui/$(id -u)/de.term-lab.heartbeat | head
launchctl kickstart -k gui/$(id -u)/de.term-lab.heartbeat   # sofort ausführen
launchctl bootout gui/$(id -u)/de.term-lab.heartbeat        # wieder entladen

Lesend kannst du jederzeit prüfen, ob der Dienst geladen ist:

launchctl print gui/$(id -u)/de.term-lab.heartbeat 2>&1 | head -2

Erwartet (solange nicht aktiviert):

Bad request.
Could not find service "de.term-lab.heartbeat" in domain for user gui: 501

Tipp: load/unload sind veraltet. bootstrap/bootout liefern klare Fehlermeldungen. Seit macOS 13 meldet zudem „Anmeldeobjekte“ in den Systemeinstellungen jeden neuen Hintergrunddienst.

Fortschritt speichern? Kostenlos registrieren

Shortcut-Tabelle

Taste/Befehl Wirkung Merkhilfe
Enter ~ . hängende SSH-Session beenden Tilde-Punkt = Schluss
Enter ~ # weitergeleitete Verbindungen anzeigen # = Anzahl
Enter ~ ? alle Escape-Sequenzen ? = Hilfe
ssh -G host effektive Konfig ohne Verbindung G = Get
ssh -O check/exit host Master prüfen/beenden O = Operation
⌘⇧. im Finder versteckte Dateien zeigen Punkt = Dotfiles
cmd \| pbcopy Ausgabe in die Zwischenablage pasteboard
open -R datei Datei im Finder zeigen R = Reveal

Kontrollpunkt

cd ~/term-lab/ssh
alias lssh='ssh -F ~/term-lab/ssh/config'
ok() { if eval "$1" >/dev/null 2>&1; then echo "✔ $2"; else echo "✘ $2"; fi; }
ok '[ "$(stat -f %Lp id_lab)" = 600 ]' "Lab-Key hat 0600"
ok 'kill -0 "$(cat sshd.pid)"' "Übungs-sshd läuft"
ok 'lssh -o BatchMode=yes lab-app true' "Login über ProxyJump"
ok 'lssh -G lab-app | grep -qx "proxyjump lab-bastion"' "ProxyJump konfiguriert"
ok 'lssh -G lab-bastion | grep -q "^controlpath .*/ssh/cm-"' "ControlPath im Lab"
ok 'plutil -lint ~/term-lab/launchd/de.term-lab.heartbeat.plist' "plist gültig"
ok '! launchctl print gui/$(id -u)/de.term-lab.heartbeat' "Agent nicht geladen"

Erwartet:

✔ Lab-Key hat 0600
✔ Übungs-sshd läuft
✔ Login über ProxyJump
✔ ProxyJump konfiguriert
✔ ControlPath im Lab
✔ plist gültig
✔ Agent nicht geladen

Challenge

Leg einen Host lab-web an, der beim Verbinden automatisch den lokalen Port 19080 auf den Webserver aus Drill 4 (Port 18080) weiterleitet. curl localhost:19080 soll „hallo aus dem Lab“ liefern, ohne dass du -L tippst.

Hinweis: Was -L auf der Kommandozeile ist, heißt in der Konfiguration LocalForward.

Lösung

cat >> ~/term-lab/ssh/config <<'EOF'

Host lab-web
  HostName 127.0.0.1
  Port 2222
  IdentityFile ~/term-lab/ssh/id_lab
  LocalForward 19080 127.0.0.1:18080
  ControlPath none
EOF
python3 -m http.server 18080 --bind 127.0.0.1 -d ~/term-lab/www >/dev/null 2>&1 &
WEB=$!
lssh -f -N lab-web
curl -s http://127.0.0.1:19080/
lssh -G lab-web | grep localforward

Erwartet:

hallo aus dem Lab
localforward 19080 [127.0.0.1]:18080

ControlPath none gibt dem Tunnel eine eigene Verbindung. Sonst würde er sich an den Master von lab-bastion hängen, denn beide haben denselben Host, Port und User.

Aufräumen – Tunnel, Webserver und Übungs-sshd stoppen:

pkill -f 'ssh -F .*-N lab-web'
kill $WEB
kill "$(cat ~/term-lab/ssh/sshd.pid)"

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Keys mit Passphrase plus Schlüsselbund oder Hardware (1Password, Secretive, YubiKey). Keine Keys ohne Passphrase auf Laptops.
  • Statt known_hosts-Pflege: SSH-Zertifikate (@cert-authority) – zum Beispiel signiert von Vault/OpenBao mit kurzer TTL.
  • Bastion-Zugänge laufen in vielen Firmen über Teleport, AWS SSM oder Boundary; ProxyCommand bindet sie in dieselbe ~/.ssh/config ein.
  • ControlPersist nicht auf geteilten Maschinen: Wer an deinen Socket kommt, nutzt deine Session ohne Key.
  • launchd-Agents und defaults gehören ins Dotfiles-Repo (Tag 13). MDM-Profile können lokale defaults jederzeit überschreiben.