Configuring DWA to use smart cards

IBM® Engineering Requirements Management DOORS® - Web Access (DWA) uses public key infrastructure (PKI) cards, common access cards (CAC), or Windows user authentication to verify that users are allowed to run DWA.

Before you begin

You must implement smart card authentication for IBM Engineering Requirements Management DOORS (DOORS) before you can use smart card authentication in DWA. See Configuring smart cards and certificates.

About this task

To configure DWA so that users can log in by using smart cards, you must edit the server.xml file, which is in the server/conf/ folder. The server.xml file is an Apache Tomcat file. For instructions to configure the server.xml file, see the Apache Tomcat documentation for enabling client authentication using the SSL Connector's clientAuth and related attributes.

To support encryption by using smart cards, you must have a keystore and certificate for Secure Sockets Layer (SSL) and a truststore certificate for DWA. Add references to the keystore and certificates in the server.xml file.

Procedure

  1. Open the server.xml file in an editor.
  2. Add these references to the SSL keystore:
    keystoreFile="path_file"
    keystorePass="password" 
  3. Add these references to the truststore certificate:
    truststoreFile="other_path_file"
    truststorePass="other_password"  
  4. Save and close the server.xml file.

What to do next

Configure the DOORS database server and client as described in Configuring smart cards and certificates.

Feedback