A route adapter allows you to direct users to the correct authentication method based on their username. A user enters their username and, based on that value, is directed to a specific URL.
Configure the UAS Settings
- Navigate to the UAS Settings screen.
- Select Add Authentication Adapter.
| Alias | This is a unique name for the adapter and is used in URLs. The alias will be stored as all lowercase letters and should not contain any special URL characters. |
| Enabled | This toggle determines whether the adapter is available for use. |
| Auth Type | ROUTE |
| Debug Enabled | This toggle determines whether debug statements are written to the logs for troubleshooting purposes. |
| Logo URL | Input the URL for any logo you would like to appear on the login page. |
| Username Prompt Text | Input the text that you want to appear where users should enter their usernames. By default, this will say "Username." |
| Submit Button Text | Input the text that you want to appear on the button that users will use to submit their usernames. By default, this will say "Submit." |
| Help Text | Input any text you want to appear on the page below the login details. This can be help text, general information, or any other text you want. This text is optional. There is a limit of 1000 characters. |
| Learn URL | This field should autopopulate with the URL of your Blackboard Learn system. |
| Default Route | Input the URL that users should be directed to by default. If users do not have one of the institutional roles or datasource keys specified later in this setup, they will be directed to this URL. |
| Route by |
|
| Routes |
|
- Select Save to save your configuration.
The URL for the configured adapter is https://{region}.extensions.blackboard.com/api/v2/authadapters/sites/{siteId}/auth/{alias}.
