Skip to content

Commit d02d3cc

Browse files
authored
Merge pull request #442 from smallstep/carl/remove-pkcs11
Add OpenSSL to agent doc
2 parents 0b37b90 + 7a18912 commit d02d3cc

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

platform/smallstep-agent.mdx

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
updated_at: October 01, 2025
2+
updated_at: October 20, 2025
33
title: Smallstep Agent for Linux
44
html_title: Smallstep Agent for Device Management Guide
55
description: Deploy and configure Smallstep Agent on Linux. Automated device identity management and certificate renewal for enterprise Linux fleets.
@@ -236,11 +236,15 @@ If you get any errors, check the agent’s status:
236236
sudo systemctl status step-agent.service
237237
```
238238
239-
## **PKCS#11 Support**
239+
### OpenSSL and PKCS#11 Support
240240
241-
The Smallstep agent provides a PKCS#11 server that can be used for a variety of integration use cases, such as NetworkManager and `wpa_supplicant` connections or web browser certificates. The PKCS#11 server is exposed as a UNIX socket at `$XDG_RUNTIME_DIR/step-agent/step-agent-pkcs11.sock`.
241+
The Smallstep agent stores the certificate on the filesystem alongside a TPM TSS2-formatted file, which is a reference to a TPM-bound key. So, any software that integrates with OpenSSL's `tpm2-openssl` provider, or with the underlying `libtpm2-tss`, can use the TPM-bound key for TLS handshakes or other purposes.
242242
243-
### Example usage: Google Chrome
243+
Because PKCS#11 is a common integration point, the Smallstep agent also provides a PKCS#11 server
244+
for use with software like NetworkManager, `wpa_supplicant`, or web browsers.
245+
The PKCS#11 server is exposed as a UNIX socket at `$XDG_RUNTIME_DIR/step-agent/step-agent-pkcs11.sock`.
246+
247+
#### Example usage: Google Chrome
244248
245249
For this example, we’re using Ubuntu 24.04. The location of `p11-kit-client.so` may vary.
246250
@@ -260,7 +264,7 @@ In Chrome, you should now have access to certificates managed by Smallstep.
260264
261265
For regular usage, add `P11_KIT_SERVER_ADDRESS` to your environment more permanently. For example, you might add `P11_KIT_SERVER_ADDRESS=unix:path=$XDG_RUNTIME_DIR/step-agent/step-agent-pkcs11.sock` to your global `/etc/environment` file.
262266
263-
### Troubleshooting
267+
#### Troubleshooting
264268
265269
The agent produces a log file or journal entries in systemd, depending on how it is installed and run.
266270
@@ -272,3 +276,4 @@ pkcs11-tool --module /usr/lib/x86_64-linux-gnu/pkcs11/p11-kit-client.so \
272276
```
273277
274278
See the [p11-kit](https://p11-glue.github.io/p11-glue/p11-kit/manual/) documentation for more details.
279+

0 commit comments

Comments
 (0)