Current File(s): conf/c14n/x500-subject-c14n-config.xml

Format: Native Spring


The c14n/x500 post-login subject canonicalization flow extracts a username from a Java Subject that contains either a single X509Certificate in the public credentials set or a single X500Principal in the Principal set. It is primarily designed to work in conjunction with the X509 or X509Internal login flows.

General Configuration

Use conf/c14n/x500-subject-c14n-config.xml to configure this flow.

By default, the subject DN is searched for a "CN" RDN attribute (with OID You can configure alternative attributes to search for, or give preference to subjectAltName extensions (if an X509Certificate is present).

By default, the only transform applied to the result is a trim of leading or trailing whitespace. Case-folding and regular expression replacements can be added, per the reference section below.



The beans defined in conf/c14n/x500-subject-c14n-config.xml follow:

Bean IDTypeDefaultFunction
shibboleth.c14n.x500.SubjectAltNameTypesList<Integer> A list of subjectAltName extension types to look for
shibboleth.c14n.x500.ObjectIDsList<String> A list of attribute OIDs to search for in the subject DN
shibboleth.c14n.x500.LowercaseBooleanfalseWhether to lowercase the username
shibboleth.c14n.x500.UppercaseBooleanfalseWhether to uppercase the username
shibboleth.c14n.x500.TrimBooleantrueWhether to trim leading and trailing whitespace from the username
shibboleth.c14n.x500.TransformsPair<String,String> Pairs of regular expressions and replacement expressions to apply to the username