
وكيل SSH يقوم بإنشاء وإدارة مفاتيح مغلقة بـ TPM للمصادقة المرتبطة بالعتاد، ويدعم توليد المفاتيح، الاستيراد، التغليف، حماية PIN، والإرجاع الاحتياطي للوكيل.
ssh-tpm-agent هو وكيل متوافق مع ssh-agent يسمح بإنشاء المفاتيح
بواسطة وحدة النظام الموثوقة (TPM) للمصادقة تجاه خوادم ssh.
المفاتيح المختومة بـ TPM هي مفاتيح خاصة تُنشأ داخل وحدة النظام الموثوقة
(TPM) وتُختم في ملفات ذات لاحقة .tpm. وهي مرتبطة بالعتاد الذي تُنتج عليه
ولا يمكن نقلها إلى أجهزة أخرى.
يتيح لك ذلك استخدام عميل أصلي بدلاً من الاضطرار إلى تحميل مكتبات PKCS11 الموجودة جانبياً في ssh-agent و/أو عميل ssh.
يستخدم المشروع TPM 2.0 Key Files
المُنفَّذة عبر مشروع go-tpm-keyfiles.
ssh-agent عامل.ssh-agent أخرى للاحتياط.بدلاً من استخدام TPM مباشرةً، يمكنك استخدام --swtpm أو export SSH_TPM_AGENT_SWTPM=1 لإنشاء هوية مدعومة بـ
swtpm والتي ستُخزَّن تحت
/var/tmp/ssh-tpm-agent.
لاحظ أن swtpm لا يوفر أي خصائص أمان ويجب استخدامه فقط
للاختبار.
أبسط طريقة لتثبيت هذه الإضافة هي تشغيل ما يلي:
go install github.com/foxboron/ssh-tpm-agent/cmd/...@latest
بدلاً من ذلك، نزّل الملفات الثنائية المُجمَّعة مسبقًا.
# 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]
ملاحظة: بالنسبة إلى ssh-tpm-agent، يمكنك تحديد كلمة مرور مالك TPM باستخدام
علامات سطر الأوامر -o أو --owner-password، وهما الخياران المفضّلان.
بدلاً من ذلك، يمكنك استخدام متغير البيئة
SSH_TPM_AGENT_OWNER_PASSWORD.
مفيد إذا كنت تريد نسخ المفتاح احتياطيًا إلى تخزين آمن بعيد مع استخدام المفتاح يوميًا من TPM.
# 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 تشغيل ssh-tpm-agent عند حاجة نظامك إليه.
# 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
على جانب العميل، أنشئ مفتاحًا أساسيًا واحدًا ضمن تسلسل هرمي. سيستخدم هذا المثال التسلسل الهرمي للمالك مع SRK.
يجب نقل ملف الإخراج srk.pem إلى الطرف البعيد الذي
ينشئ المفتاح. يمكن القيام بذلك كجزء من تزويد العميل.
$ tpm2_createprimary -C o -G ecc -g sha256 -c prim.ctx -a 'restricted|decrypt|fixedtpm|fixedparent|sensitivedataorigin|userwithauth|noda' -f pem -o srk.pem
في الطرف البعيد نُنشئ مفتاح ssh من نوع p256، بدون كلمة مرور، ونلفّه باستخدام
ssh-tpm-keygen مع srk.pem من جهة العميل.
$ 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
على جانب العميل يمكننا فك تغليف wrapped_id_ecdsa إلى مفتاح قابل للتحميل.
$ ssh-tpm-keygen --import ./wrapped_id_ecdsa.tpm -f id_ecdsa.tpm
$ ssh-tpm-add id_ecdsa.tpm
يدعم ssh-tpm-agent أيضًا تخزين مفاتيح المضيف داخل TPM.
$ sudo ssh-tpm-keygen -A
2023/09/03 17:03:08 INFO Generating new ECDSA host key
2023/09/03 17:03:08 INFO Wrote /etc/ssh/ssh_tpm_host_ecdsa_key.tpm
2023/09/03 17:03:08 INFO Generating new RSA host key
2023/09/03 17:03:15 INFO Wrote /etc/ssh/ssh_tpm_host_rsa_key.tpm
$ sudo ssh-tpm-hostkeys --install-system-units
Installed /usr/lib/systemd/system/ssh-tpm-agent.service
Installed /usr/lib/systemd/system/ssh-tpm-agent.socket
Installed /usr/lib/systemd/system/ssh-tpm-genkeys.service
Enable with: systemctl enable --now ssh-tpm-agent.socket
$ sudo ssh-tpm-hostkeys --install-sshd-config
Installed /etc/ssh/sshd_config.d/10-ssh-tpm-agent.conf
Restart sshd: systemd restart sshd
$ systemctl enable --now ssh-tpm-agent.socket
$ systemctl restart sshd