Install the Web Services PKCS #11 library

Linux

To install the nShield PKCS #11 library:

  1. Sign in as a user with root privileges.

  2. Change to the root directory.

  3. Extract the PKCS #11 tar to the root directory. This installs all the files required by PKCS #11 to /opt/nfast/webservices/pkcs11.

    tar –xzf /path/to/nShield-WebServicesClient-Linux-1.2.0.tar.gz

  4. If you are installing the PKCS #11 library for the first time, go to the /opt/nfast/webservices/pkcs11/conf folder and copy the example_pkcs11webservices.cfg file to pkcs11webservices.cfg.

    If you are reinstalling or updating the PKCS #11 library and do not want to overwrite your existing pkcs11webservices.cfg file, you can skip this step.

  5. If required, change the log file destination or grant permission to the appropriate user to write to the default log folder: /opt/nfast/webservices/pkcs11/log. For help changing the logging path, see Log file path on Linux.

Windows

To install the nShield PKCS #11 library:

  1. Ensure that Microsoft Visual C++ 2015-2022 Redistributable (x64) has been installed. A supported version is included in the installation media or can be downloaded from https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170.

  2. Sign in as Administrator or as a user with local administrator rights.

  3. Using the provided installation media, launch setup.msi manually.

  4. Follow the onscreen instructions.

  5. Accept the license terms and select Next to continue.

  6. Specify the installation directory and select Next to continue.

  7. If you are installing the PKCS #11 library for the first time, go to the C:\ProgramData\nCipher\webservices\pkcs11\conf folder and copy the example_pkcs11webservices.cfg file to pkcs11webservices.cfg.

    If you are reinstalling or updating the PKCS #11 library and do not want to overwrite your existing pkcs11webservices.cfg file, you can skip this step.

  8. If required, change the log file destination or grant permission to the appropriate user to write to the default log folder: C:\ProgramData\nCipher\webservices\pkcs11\log. For help changing the logging path, see Log file path on Windows.