openssl-agent

[brief]

OpenSSL key agent

This package contains the OpenSSL key agent and client utilities.

Note that this project is not affiliated with OpenSSL. OpenSSL is a
registered trademark owned by the OpenSSL Software Foundation used
with permission.

The aim of these utilities is to provide an openssl-rsautl(1) drop-in
replacement for performing cryptographic operations using a private key
that is unlocked for the session, similar to OpenSSH's ssh-agent(1).

The typical usage is as follows:

1. Start the OpenSSL key agent which prompts for a password/PIN for the
   specified private key. The agent then forks off the daemon which unlocks
   the key, opens a UNIX domain socket, and waits for cryptographic operation
   requests from the OpenSSL client.

   The agent also prints to stdout a shell script fragment that sets the
   environment variables necessary for locating the agent.

2. Source the script fragment printed by the agent into the shell.

3. Run the OpenSSL client to perform a cryptographic operation.

For example:

$ openssl-agent-pkcs11 "pkcs11:object=SIGN%20key" >agent.env
Enter PIN for PKCS#11:*******

$ source agent.env
Agent pid 14696

$ openssl-client rsautl -sign -keyform engine -engine pkcs11 \
-inkey "pkcs11:object=SIGN%20key" <<<test >signature

...

$ kill 14696

By default, openssl-agent-pkcs11(1) uses opensc-pkcs11 module, unless a
different one is explicitly specified in the private key URL (see RFC7512
Section "The PKCS #11 URI Scheme" for details).

To use opensc-pkcs11, make sure that the following packages are installed in
the system:

Debian/Ubuntu: opensc-pkcs11
Fedora/RHEL:   opensc

Note that for some Debian versions the opensc-pkcs11 package has the missing
libpcsclite1 dependency, so make sure it is also installed.

For more information see:

https://build2.org/

See the NEWS file for the user-visible changes from the previous release.

See the LICENSE file for the distribution conditions.

See the INSTALL file for the prerequisites and installation instructions.

See the doc/ directory for documentation.

Send questions, bug reports, or any other feedback to the users@build2.org
mailing list. You can post without subscribing. See https://lists.build2.org
for searchable archives, posting guidelines, etc.
license MIT
project build2
url build2.org
doc-url build2.org/doc.xhtml
src-url git.build2.org/cgit/openssl-agent/tree/
topics cryptographic tokencryptography
1 Version
version 0.17.0-a.0.20230705081920.453aeb447c82
repository https://stage.build2.org/1
depends 1; libbutl
requires 1; c++14