As an admin, you can configure a Discovery Page directly from the Root Account Authentication page. This helps users choose the right login method when your account has more than one authentication option set up. Once enabled, it replaces the Discovery URL or first listed authentication method on login. You can build out the page before turning it on, and enabling it won't delete the Discovery URL you've already saved.
A Preview section displays a live example of the Discovery Page as login options are added in the configuration menu. The branding shown in the preview matches the Login Options branding configured in the Theme Editor.
A Configuration panel allows permitted admins to manage the login options available on the Discovery Page
Note: The same authentication provider can be used multiple times if needed. A maximum of 10 login options is supported.
Open Account
In Global Navigation, click the Admin link [1], then click the name of the account [2].
Open Authentication
In Account Navigation, click the Authentication link.
In the Authentication pages Discovery Page section, click the Configure button to set up a native Canvas Discovery Page.
Configure Discovery Page
To add and manage Login options, click the Add button [1]. You can preview a live example of the Discovery page as options are added [2].
Configure Sign-in Options
Each login option has three configurable settings:
- Login Button Text (Required) [1]: Defines the text displayed on the login button shown on the Discovery Page. Limited to 50 characters.
- Select Authentication Provider (Required) [2]: Defines the authentication method users are redirected to when the button is selected. The login URL for each Auth Provider is available on the main Authentication page.
- Button Icon (Default: None) [3]: Allows selection of a login icon for the button. Options include commonly used identity provider icons across Canvas customers, or no icon.
- If none of the available icons are preferred, an emoji can be used in the Login Button Text field as an alternative icon.
To save the login option, click the Done button [4].
Note: If required fields are incorrectly populated, clicking the Done button will highlight the errors and prevent saving. Resolve the identified errors, then select Done again to save the configuration.
Manage Options
You can edit [1], delete [2], and change the order of options [3].
Note: Selecting the down arrow on a card at the bottom of the Main Sign-in Options section moves the card to the More Sign-in Options section.
View More Sign in Options
If at least one login option is placed in the More Sign-in Options section, a More Sign-in Options link displays on the Discovery Page [1]. Selecting the link reveals the additional options.
To save the configuration, click the Save button [2].
Save Discovery Page
A prompt message indicates that discovery page configuration is complete. To apply and persist the changes, click the Save button [2].
Enable Use Discovery Page
To use the Discovery Page instead of the Discovery URL or the first listed authentication method, enable the Use Discovery Page toggle [1]. Then, click the Save button [2].
Note: Enabling this setting does not remove a populated Discovery URL. Instead, traffic is redirected to the Discovery Page rather than the Discovery URL.
