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~/.sshliest und schreibt das Lab nicht. - Ein eigener
sshdauf127.0.0.1:2222spielt 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.logErwartet:
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-bastionErwartet:
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
ProxyJumpstattForwardAgent 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 $WEBFortschritt 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 -lErwartet (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 -kErwartet:
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 öffnenErwartet:
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.mdErwartet (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 1Erwartet (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 AppleLocaleErwartet (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.plistErwartet:
{
Greeting = "Hallo Lab";
}
{
"Greeting" => "Hallo Lab"
}
Achtung:
defaults writeauf echte Domains wirkt oft erst nachkillall Dock/killall Finder– und ohne Backup gibt es kein Undo. Erstdefaults 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 $KCErwartet:
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.plistErwartet:
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.plistErwartet:
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 entladenLesend kannst du jederzeit prüfen, ob der Dienst geladen ist:
launchctl print gui/$(id -u)/de.term-lab.heartbeat 2>&1 | head -2Erwartet (solange nicht aktiviert):
Bad request.
Could not find service "de.term-lab.heartbeat" in domain for user gui: 501
Tipp:
load/unloadsind veraltet.bootstrap/bootoutliefern 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 localforwardErwartet:
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;
ProxyCommandbindet sie in dieselbe~/.ssh/configein. ControlPersistnicht auf geteilten Maschinen: Wer an deinen Socket kommt, nutzt deine Session ohne Key.- launchd-Agents und
defaultsgehören ins Dotfiles-Repo (Tag 13). MDM-Profile können lokaledefaultsjederzeit überschreiben.