
SSH-Agent, der TPM-gesiegelte Schlüssel für hardwaregebundene Authentifizierung erstellt und verwaltet, und dabei Schlüsselerzeugung, -import, -Wrapping, PIN-Schutz und Proxy-Fallback unterstützt.
ssh-tpm-agent ist ein ssh-agent-kompatibler Agent, der es ermöglicht, Schlüssel
durch das Trusted Platform Module (TPM) für die Authentifizierung gegenüber SSH-Servern zu erstellen.
TPM-versiegelte Schlüssel sind private Schlüssel, die innerhalb des Trusted Platform Module
(TPM) erstellt und in Dateien mit der Endung .tpm versiegelt werden. Sie sind an die Hardware gebunden, auf der sie
erzeugt werden, und können nicht auf andere Maschinen übertragen werden.
Dies ermöglicht es Ihnen, einen nativen Client zu verwenden, anstatt bestehende PKCS11-Bibliotheken in den ssh-agent und/oder ssh-Client nachladen zu müssen.
Das Projekt verwendet TPM 2.0 Key Files,
implementiert durch das Projekt go-tpm-keyfiles.
ssh-agent.ssh-agent-Servern für Fallbacks.Anstatt das TPM direkt zu nutzen, können Sie --swtpm verwenden oder export SSH_TPM_AGENT_SWTPM=1 setzen, um eine Identität zu erstellen, die durch
swtpm gestützt wird und unter
/var/tmp/ssh-tpm-agent gespeichert wird.
Beachten Sie, dass swtpm keine Sicherheitseigenschaften bietet und nur zum
Testen verwendet werden sollte.
Der einfachste Weg, dieses Plugin zu installieren, ist die Ausführung des Folgenden:
go install github.com/foxboron/ssh-tpm-agent/cmd/...@latest
Alternativ kannst du die vorgefertigten Binärdateien herunterladen.
# Create key
$ ssh-tpm-keygen
Generating a sealed public/private ecdsa key pair.
Enter file in which to save the key (/home/fox/.ssh/id_ecdsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/fox/.ssh/id_ecdsa.tpm
Your public key has been saved in /home/fox/.ssh/id_ecdsa.pub
The key fingerprint is:
SHA256:NCMJJ2La+q5tGcngQUQvEOJP3gPH8bMP98wJOEMV564
The key's randomart image is the color of television, tuned to a dead channel.
$ cat /home/fox/.ssh/id_ecdsa.pub
ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBOTOsMXyjTc1wiQSKhRiNhKFsHJNLzLk2r4foXPLQYKR0tuXIBMTQuMmc7OiTgNMvIjMrcb9adgGdT3s+GkNi1g=
# Using the socket
$ ssh-tpm-agent -l /var/tmp/tpm.sock
$ export SSH_AUTH_SOCK="$(ssh-tpm-agent --print-socket)"
$ ssh [email protected]
Hinweis: Für ssh-tpm-agent können Sie das TPM-Besitzerpasswort über die
Kommandozeilen-Flags -o oder --owner-password angeben, die bevorzugt werden.
Alternativ können Sie die Umgebungsvariable
SSH_TPM_AGENT_OWNER_PASSWORD verwenden.
Nützlich, wenn Sie den Schlüssel in einem entfernten sicheren Speicher sichern möchten, während Sie den Schlüssel täglich aus dem TPM verwenden.
# Create a key, or use an existing one
$ ssh-keygen -t ecdsa -f id_ecdsa
Generating public/private ecdsa key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in id_ecdsa
Your public key has been saved in id_ecdsa.pub
The key fingerprint is:
SHA256:bDn2EpX6XRX5ADXQSuTq+uUyia/eV3Z6MW+UtxjnXvU fox@framework
The key's randomart image is:
+---[ECDSA 256]---+
| .+=o..|
| o. oo.|
| o... .o|
| . + .. ..|
| S . . o|
| o * . oo=*|
| ..+.oo=+E|
| .++o...o=|
| .++++. .+ |
+----[SHA256]-----+
# Import the key
$ ssh-tpm-keygen --import id_ecdsa
Sealing an existing public/private ecdsa key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in id_ecdsa.tpm
The key fingerprint is:
SHA256:bDn2EpX6XRX5ADXQSuTq+uUyia/eV3Z6MW+UtxjnXvU
The key's randomart image is the color of television, tuned to a dead channel.
Socket-aktivierte Dienste ermöglichen es dir, ssh-tpm-agent zu starten, wenn er von deinem System benötigt wird.
# Using the socket
$ ssh-tpm-agent --install-user-units
Installed /home/fox/.config/systemd/user/ssh-tpm-agent.socket
Installed /home/fox/.config/systemd/user/ssh-tpm-agent.service
Enable with: systemctl --user enable --now ssh-tpm-agent.socket
$ systemctl --user enable --now ssh-tpm-agent.socket
$ export SSH_AUTH_SOCK="$(ssh-tpm-agent --print-socket)"
$ ssh [email protected]
# Start the usual ssh-agent
$ eval $(ssh-agent)
# Create a strong RSA key
$ ssh-keygen -t rsa -b 4096 -f id_rsa -C ssh-agent
...
The key fingerprint is:
SHA256:zLSeyU/6NKHGEvyZLA866S1jGqwdwdAxRFff8Z2N1i0 ssh-agent
$ ssh-add id_rsa
Identity added: id_rsa (ssh-agent)
# Print looonnggg key
$ ssh-add -L
ssh-rsa AAAAB3NzaC1yc[...]8TWynQ== ssh-agent
# Create key on the TPM
$ ssh-tpm-keygen -C ssh-tpm-agent
Generating a sealed public/private ecdsa key pair.
Enter file in which to save the key (/home/fox/.ssh/id_ecdsa):
Enter passphrase (empty for no passphrase):
Confirm passphrase:
Your identification has been saved in /home/fox/.ssh/id_ecdsa.tpm
Your public key has been saved in /home/fox/.ssh/id_ecdsa.pub
The key fingerprint is:
SHA256:PoQyuzOpEBLqT+xtP0dnvyBVL6UQTiQeCWN/EXIxPOo
The key's randomart image is the color of television, tuned to a dead channel.
# Start ssh-tpm-agent with a proxy socket
$ ssh-tpm-agent -A "${SSH_AUTH_SOCK}" &
$ export SSH_AUTH_SOCK="$(ssh-tpm-agent --print-socket)"
# ssh-tpm-agent is proxying the keys from ssh-agent
$ ssh-add -L
ssh-rsa AAAAB3NzaC1yc[...]8TWynQ== ssh-agent
ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNo[...]q4whro= ssh-tpm-agent
$ ssh-tpm-agent --no-load &
2023/08/12 13:40:50 Listening on /run/user/1000/ssh-tpm-agent.sock
$ export SSH_AUTH_SOCK="$(ssh-tpm-agent --print-socket)"
$ ssh-add -L
The agent has no identities.
$ ssh-tpm-add $HOME/.ssh/id_ecdsa.tpm
Identity added: /home/user/.ssh/id_ecdsa.tpm
$ ssh-add -L
ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBJCxqisGa9IUNh4Ik3kwihrDouxP7S5Oun2hnzTvFwktszaibJruKLJMxHqVYnNwKD9DegCNwUN1qXCI/UOwaSY= test
Auf der Client-Seite wird ein Primärschlüssel unter einer Hierarchie erstellt. Dieses Beispiel verwendet die Owner-Hierarchie mit einem SRK.
Die Ausgabedatei srk.pem muss an das Remote-Ende übertragen werden, das
den Schlüssel erstellt. Dies könnte im Rahmen der Client-Bereitstellung erfolgen.
$ tpm2_createprimary -C o -G ecc -g sha256 -c prim.ctx -a 'restricted|decrypt|fixedtpm|fixedparent|sensitivedataorigin|userwithauth|noda' -f pem -o srk.pem
Am entfernten Ende erstellen wir einen p256-SSH-Schlüssel ohne Passwort und umhüllen ihn mit
ssh-tpm-keygen mit dem srk.pem von der Client-Seite.
$ ssh-keygen -t ecdsa -b 256 -N "" -f ./ecdsa.key
# OR with openssl
$ openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:prime256v1 -out ecdsa.key
# Wrap with ssh-tpm-keygen
$ ssh-tpm-keygen --wrap-with srk.pub --wrap ecdsa.key -f wrapped_id_ecdsa
Auf der Client-Seite können wir wrapped_id_ecdsa zu einem ladbaren Schlüssel entpacken.
$ ssh-tpm-keygen --import ./wrapped_id_ecdsa.tpm -f id_ecdsa.tpm
$ ssh-tpm-add id_ecdsa.tpm
ssh-tpm-agent unterstützt auch das Speichern von Host-Schlüsseln im TPM.