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:
- 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'.
- 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)
- 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
- 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.