Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.futurex.com/llms.txt

Use this file to discover all available pages before exploring further.

Install the Futurex PKCS #11 shared library on the ADSS Server host.

​
Linux

1

Download the Futurex PKCS #11 package

Obtain the Futurex PKCS #11 package from FXTools for your platform architecture and OpenSSL version.
2

Extract the package

Extract the archive. It contains the following files:
FileDescription
libfxpkcs11.soFuturex PKCS #11 shared library
fxpkcs11.cfgPKCS #11 configuration file
PKCS11ManagerPKCS #11 management utility
configTestConfiguration test utility
3

Copy the library to the installation directory

Copy the library files to the system-wide installation path:
Shell
sudo mkdir -p /usr/local/lib/fxpkcs11
sudo cp libfxpkcs11.so /usr/local/lib/fxpkcs11/
sudo cp PKCS11Manager configTest /usr/local/lib/fxpkcs11/
4

Place the configuration file

Copy the configuration file to /etc:
Shell
sudo cp fxpkcs11.cfg /etc/fxpkcs11.cfg
By default, the Futurex PKCS #11 library looks for the configuration file at /etc/fxpkcs11.cfg. To use a custom location, set the FXPKCS11_CFG environment variable to the full path of the configuration file.
5

Verify the library is accessible

Confirm the library file is readable by the user running ADSS Server (typically root):
Shell
ls -la /usr/local/lib/fxpkcs11/libfxpkcs11.so
The library file exists and has read permissions for the ADSS Server process user.
The PKCS #11 library logs operations to /tmp/fxpkcs11.log by default. This log is useful for verifying HSM calls during testing.