Cisco Cisco Expressway Maintenance Manual

You can use the 

 page to test the outcome of applying different Regex and 

Username format combinations to a certificate.

The 

 page (

) is 

used to check client certificates before enabling 

. You can:

 

n 

Test whether a client certificate is valid when checked against the Expressway's current trusted CA list 
and, if loaded, the revocation list (see 

).

 

n 

Test the outcome of applying the regex and template patterns that retrieve a certificate's authorization 
credentials (the username).

You can test against:

 

n 

a certificate on your local file system

 

n 

the browser's currently loaded certificate

 1.  Select the Certificate source. You can choose to:

 

l 

upload a test file from your file system in either PEM or plain text format; if so click Browse to select 
the certificate file you want to test

 

l 

test against the certificate currently loaded into your browser (only available if the system is already 
configured to use Certificate validation and a certificate is currently loaded)

 2.  Ignore the 

 section - this is only relevant if you are extracting 

authorization credentials from the certificate.

 3.  Click Check certificate.

 4.  The results of the test are shown in the 

 section.

 1.  Select the Certificate source as described above.

 2.  Configure the Regex and Username format fields as required. Their purpose is to extract a username 

from the nominated certificate by supplying a regular expression that will look for an appropriate string 
pattern within the certificate. The fields default to the currently configured settings on the 

 page but you can change them as required.

 

l 

In the Regex field, use the (?<name>regex) syntax to supply names for capture groups so that 
matching sub-patterns can be substituted in the associated Username format field, for example,
/(Subject:.*, CN=(?<Group1>.*))/m

.

The regex defined here must conform to 

.

 

l 

The Username format field can contain a mixture of fixed text and the capture group names used in the 
Regex. Delimit each capture group name with #, for example, prefix#Group1#suffix. Each 
capture group name will be replaced with the text obtained from the regular expression processing.

 3.  Click Check certificate.

The results of the test are shown in the 

 section. The Resulting string item is the 

username credential that would be checked against the relevant authorization mechanism to determine 
that user's authorization (account access) level.

 4.  If necessary, you can modify the Regex and Username format fields and repeat the test until the correct 

results are produced.
Note that if the Certificate source is an uploaded PEM or plain text file, the selected file is temporarily 

Cisco Expressway Administrator Guide (X8.2)     

Page 215 of 378

Maintenance

About security certificates