Skip to main content
Perform the following tasks to install and configure the CertAgent and verify that it works properly.

Install and configure CertAgent

The Internet Explorer and Firefox browsers support the web-based interface used by CertAgent. Perform the following steps to install and configure CertAgent:
1
Double-click the Certagent.7.0.5.x64.exe file and follow the instructions in the setup wizard.
2
The setup wizard prompts for the listening port for the HyperSQL database to be created. If 9001 is already in use, you can also use 9002 or 9003.
3
CertAgent prompts you to create TLS ports and Admin and Public web interface credentials.
4
Provide the following information:
PKCS11 library pathSelect [ Browse ] and select the path for the fxpkcs11.dll file. The default FXPKCS11 installation location is C:/Program Files/Futurex.
HSM PartitionPrompt to select one of the partitions found in the CryptoHub
HSM PINThis is the CryptoHub identity password configured inside the <CRYPTO-OPR-PASS> tag in the fxpkcs11.cfg file.
Common Name (CN)Common Name (CN) for the CA Root certificate created by CertAgent
Organization NameOrganization Name for the CA Root certificate created by CertAgent
PKCS #12 PasswordPassword to be used for PKCS #12 files generated by CertAgent and the CryptoHub
Make note of the PKCS #12 password, admin TLS port (<admin port>), and public TLS port (<public port>) you enter during installation. This information is required to import the Certificates for the web browsers to access the CertAgent sites (Administrator Site, Public Site, CA Site).
5
Set the SA password and a user account with a password for the CertAgent database. Be sure to take note of these for future use.
The installer creates the credentials and finalizes the installation process.At the end of the installation, CertAgent creates a README.txt file. We strongly recommend that you read and follow the instructions for the post-installation steps.

Verify the installation

This section verifies that CertAgent is communicating correctly with the CryptoHub.
The following requires the certificates installed by CertAgent to be added to the trusted list of your web browser.
1
After the installation completes, log in to the CryptoHub web UI to verify the keys have successfully been generated.
2
You can also use the Futurex Command Line Interface (FXCLI) to validate the installation. After you connect, run the following commands to verify the keys exist on the CryptoHub.
FXCLI
  $ login user
    Username> Crypto1
    Password>safest
  [2020-05-05 18:35:17]   INFO   Successfully logged in as user 'crypto1' (Crypto Operator: 1/1).
  Successfully logged in as 'crypto1'.
  result: 
      status: success
      statusCode: 0
  connected: true
  status: "logged in"
  logins: 1
  remaining: 0
  [2020-05-05 18:35:17]   INFO   Successfully seeded local OpenSSL context with random data.
FXCLI
  $ keytable list
  result:
      status: success
      statusCode: 0
  slots:
      -   
          slot: 0
          type: "key"
          name: ""
          algorithm: RSA
          bits: 3072
          usage: Encrypt,Decrypt,Sign,Verify,Wrap,Unwrap
          majorKey: FTK
          kcv: "71AE"
          -  
              slot: 1
              type: "key"
              name: ""
              algorithm: RSA
              bits: 3072
              usage: Encrypt,Verify,Wrap
              majorKey: FTK
              kcv: "8C0D"
              -  
                  slot: 2
                  type: "certificate"
                  name: ""
                  algorithm: RSA
                  bits: 3072
                  usage: Sign,Verify,Wrap,Unwrap
                  majorKey: None
                  fingerprint: "3422798E22319E1E170E29837F9F0112CE1DFASA"
                  -
                      slot: 3
                      type: "key"
                      name: ""
                      algorithm: RSA
                      bits: 3072
                      usage: Encrypt,Decrypt,Sign,Verify,Wrap,Unwrap
                      majorKey: FTK
                      kcv: "70FE"
                      -
                          slot: 4
                          type: "key"
                          name: ""
                          algorithm: RSA
                          bits: 3072
                          usage: Encrypt,Decrypt,Wrap
                          majorKey: FTK
                          kcv: "1696"
                          -
                             slot: 5
                             type: "certificate"
                             name: ""
                             algorithm: RSA
                             bits: 3072
                             usage: Sign,Verify
                             majorKey: None
                             fingerprint: "83BC566A389AF4F34292VEA053B013A1A97BC968"
If all six keys are present, the installation succeeded.
3
Open a command terminal and go to the installation location of CertAgent. Then, run the command certagent setpin.
4
Go to the System PIN Entry page shown in the README.txt. Follow the link in the file.
5
In the web portal, you can use the displayed links to access the following sites:
  • The System Administrative Site
    • Admin controls over the system and server, including configuration settings. Must connect with the Admin certificate.
  • The CA Account Site
    • Allows the certificate enrollment, management, CRL, and other settings to be set when connected with the Admin certificate.
    • Allows CSRs to be approved, signed, revoked, and other certificate enrollment tasks to be completed when connected with the Operations certificate.
  • The Public Site
    • Enables users to enroll, upload, and retrieve certificates to and from the CryptoHub when connected with the Client certificate.
6
Using the Public Site, send a certificate signing request using the Enroll function. Using Internet Explorer, you can generate a key for a certificate to be signed by the CryptoHub. Firefox cannot generate a key for you.
7
After sending in a CSR, log in to the CA Account Site by using the Operations certificate, find the certificate in the pending section, and issue it.Proper configuration of the application with the CryptoHub enables you to issue the certificate and retrieve all from the web.