Configuring trust anchors on the server or cell level

You can configure a list of keystore objects that contain trusted root certificates to be used for certificate path validation of incoming X.509-formatted security tokens.

Before you begin

[AIX Solaris HP-UX Linux Windows] [z/OS] Prior to completing the steps to configure trust anchors, you must create the keystore file using the key tool. WebSphere® Application Server provides the key tool in the install_dir/java/jre/bin/keytool file.

[iSeries] Prior to completing the steps to configure trust anchors, you must create the keystore file using the keytool utility. The keytool utility is available using the QShell Interpreter.

About this task

This task provides the steps that are needed to configure a list of keystore objects that contain trusted root certificates. These objects are used for certificate path validation of incoming X.509-formatted security tokens. Keystore objects within trust anchors contain trusted root certificates that are used by the CertPath application programming interface (API) to determine whether to trust a certificate chain.

You can configure trust anchors on the server level and the cell level. In the following steps, use the first step to access the server-level default bindings and use the second step to access the cell-level bindings.

Procedure

  1. Access the default bindings for the server level.
    1. Click Servers > Server Types > WebSphere application servers > server_name.
    2. Under Security, click JAX-WS and JAX-RPC security runtime.
      Mixed-version environment: In a mixed node cell with a server using Websphere Application Server version 6.1 or earlier, click Web services: Default bindings for Web services security.mixv
  2. Click Security > Web services to access the default bindings on the cell level.
  3. Under Additional properties, click Trust anchors.
  4. Click one of the following to work with trust anchor configuration:
    New
    To create a trust anchor configuration. Enter a unique name for the trust anchor in the Trust anchor name field.
    Delete
    To delete an existing configuration.
    an existing trust anchor configuration
    To edit the settings for an existing trust anchor.
  5. Specify a password in the Key store password field that is used to access the keystore file.
  6. Specify the absolute location of the keystore file in the Key store path field. It is recommended that you use the USER_INSTALL_ROOT variable as a portion of the keystore path. To change this predefined variable, click Environment > WebSphere variables. The USER_INSTALL_ROOT variable might display on the second page of variables.
  7. Specify the type of keystore file in the key store type field. WebSphere Application Server supports the following keystore types:
    JKS
    Use this option if you are not using Java™ Cryptography Extensions (JCE) and your keystore file uses the Java Key Store (JKS) format.
    JCEKS
    Use this option if you are using Java Cryptography Extensions.
    JCERACFKS [z/OS]
    Use JCERACFKS if the certificates are stored in a SAF key ring (z/OS® only).
    PKCS11KS (PKCS11)
    Use this option if your keystore file uses the PKCS#11 file format. Keystore files that use this format might contain Rivest Shamir Adleman (RSA) keys on cryptographic hardware or might encrypt keys that use cryptographic hardware to ensure protection.
    PKCS12KS (PKCS12)
    Use this option if your keystore file uses the PKCS#12 file format.
  8. Click OK and Save to save your configuration.

Results

You have configured trust anchors at the server or cell level.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 10:04:34 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-mp&topic=twbs_conftrancsvrcell
File name: twbs_conftrancsvrcell.html