Username transformations

Open

When a user logs in via Kerberos it may be that the format of the username does not match your existing username format in your Atlassian product. Then you may transform the username either by using regular expressions or by adding an additional domain name to the username lookup (selectable in the upper drop-down in the image above).

You may also select to Only lookup based on transformation which makes this the only username to look for in the user directories. If you turn this switch off also other versions of the username will be looked for.

Use the Test transformation to test your regular expressions and the Configuration tester to see what usernames will be looked up with your currently saved configuration.

Username transformations is useful if the username in your user directory has a different layout than the one you need to have in your app. Transformation will be performed before looking up user in user directory.

Configure username transformation for Kerberos either by adding additional domain name or use a regular expression.

Verify that the rules matches and transforms the username as expected before you save the configuration.

Add additional domain name

Configure one additional domain as a suffix that will be added to the username when searching for accounts in your app. Leave the field blank to remove the suffix.

Open

Use a regular expression

Enter regular expression in the fields “Transform” and “to”. Test your configuration with the Configuration tester before you save.

Only lookup based on transformation

The default behavior is that the transformation will be tried first and then additional lookups will be done with combinations of the username in uppercase and lowercase, and also with and without domain. Turn this switch on to only lookup based on the transformation rule.