Opening a cryptographic token using the key management utility (iKeyman)

 

Opening a cryptographic token using the key management utility (iKeyman)

Verify that your cryptographic token device is installed and functions properly. Create a cryptographic token, following the instructions provided by the manual of the cryptographic device.

From your cryptographic token device documentation, identify the token library. For example, the IBM 4758 PCI Cryptographic Card uses CRYPTOKI.DLL as the PKCS#11-type token library (see http://www.ibm.com/security/cryptocards/library.shtml for details).

Note: Hardware cryptography devices and cryptographic tokens are not supported in WebSphere Application Server for OS/400.

Read the documentation located in the http://www.ibm.com/developerworks/java/jdk/security/142/ikmuserguide.pdf file for further information about using the key management utility (iKeyman).

Important: To use iKeyMan for key management with a cryptographic token device, edit the ${WAS_INSTALL_ROOT}/java/jre/lib/security/java.security file. Uncomment the line containing com.ibm.crypto.pkcs11.provider.IBMPKCS11.

You can use the key management utility to open a cryptographic token. Once opened, you can manage your keys and certificates just like you do with keystore and truststore files:

  1. Start the key management utility, if it is not already running.

  2. Click Key DataBase File > Open .

  3. Click Cryptographic Token from the list of key database types.

  4. Fill in the information for File Name and Location, or browse for the cryptographic device library.

  5. Click OK to open the library.

  6. Type in the slot number in the next panel. This is the number of the slot in which you previously created the cryptographic token.

  7. Enter the password. This is the password configured for the cryptographic token that you created.

ResultAll of the personal and signer certificates are stored on the cryptographic token card. With the token open, you can create or request digital certificates and receive CA-signed certificates.

 

What to do next

Use a cryptographic token device as a key database to manage keys and certificates for an SSL connection. Once the cryptographic token is open, you can add or delete keys and certificates. Configure the cryptographic token settings in WebSphere Application Server.

Related tasks
Configuring to use cryptographic tokens
Managing digital certificates

Related reference
Cryptographic token support


Searchable topic ID: tsec_ikeycrypto