Creating and activating client certificate name filters

A certificate name filter enables you to associate many client certificates with one user ID based on the unique user information in the certificate, such as the user's affiliation. You can create one or more certificate name filters to map a large number of client certificates to a limited number of user IDs, which helps you reduce administrative costs.

Procedure

To create and activate a certificate name filter:

  1. Create a certificate name filter by issuing the RACDCERT MAP command, as shown in the following example:
    RACDCERT MAP ID(USRT001) -
       SDNFILTER('O=IBM.L=San Jose.SP=CA.C=US')
       WITHLABEL('IBMers') TRUST

    This creates a new certificate name filter based on the subject's distinguished name in the certificate. The filter associates user ID USRT001 to any user presenting a certificate with subject name 'O=IBM®, L=San Jose, ST=CA, C=US'.

  2. Activate the SETROPTS RACLIST processing for the DIGTNMAP class.

    Using the RACDCERT MAP command to create a certificate name filter automatically generates a mapping profile in the DIGTNMAP class that represents the new filter. Both the DIGTNMAP class and the SETROPTS RACLIST processing for the DIGTNMAP class must be active before you can complete the creation of the new certificate name filter. Issue the following command to activate the SETROPTS RACLIST processing for the DIGTNMAP class:

    SETROPTS CLASSACT(DIGTNMAP) RACLIST(DIGTNMAP)
  3. Refresh the DIGTNMAP class.

    Once SETROPTS RACLIST processing for the DIGTNMAP class is active, you must refresh the DIGTNMAP class for the certificate name filter to take effect. Issue the following command to refresh the DIGTNMAP class:

    SETROPTS RACLIST(DIGTNMAP) REFRESH
  4. Register a client CA certificate to use with the certificate name filter.

    During the SSL handshake phase of establishing a secure connection, AT-TLS retrieves certificate information from RACF® if client authentication is specified. In order for AT-TLS to retrieve the client CA certificate and private keys from RACF, the client CA certificate must be connected to the server key ring. You can use the new certificate name filter to register the client CA certificate to RACF, connect to the server key ring, and map to the user ID CERTAUTH as trusted by issuing the following command:

    RACDCERT CERTAUTH ADD('USRT001.CLIENT.CRT') TRUST
    RACDCERT ID(SYSDSP) CONNECT(CERTAUTH LABEL('LABEL00000001')
    RING(DB2SERVERKEYRING) USAGE(CERTAUTH))

    This registers the client CA certificate to RACF and maps it to the ID CERTAUTH as TRUST. It the adds the certificate to key ring DB2ASERVERKEYRING (owned by ID SYSDSP) and and indicates it is used for certificate authority purposes. As a result, when a remote client establishes a secure connection with Db2, AT-TLS is able to authenticate the client from the client CA certificate in RACF. Because the certificate name filter is active, user ID USRT001 is returned by AT-TLS to Db2.