The ood_auth_map scripts are all designed to take a URL-encoded authenticated username and map it to a local system username. In all cases the included scripts follow the given format:

bin/ood_auth_map.<TYPE> [OPTIONS] <REMOTE_USER>

Where TYPE can be either regex or mapfile.

A successful mapping will return the local username to STDOUT:

$ bin/ood_auth_map.mapfile

An unsuccessful mapping will return an empty string to STDOUT:

$ bin/ood_auth_map.regex -r '^(\w+)$'



The authenticated username can be specified as a URL-encoded string to avoid having to escape special characters in the shell.

For any of the provided scripts you can display a quick reference of the capabilities offered by that script with:

bin/ood_auth_map.<TYPE> --help