Auth Settings
Each tenant can customize its authentication behavior, including which identity provider is used by default and how the login page behaves when multiple providers are available.
Accessing Auth Settings
Section titled “Accessing Auth Settings”- Navigate to Tenants and select the tenant.
- Open the Auth Settings tab.
Default Identity Provider
Section titled “Default Identity Provider”When a tenant has multiple authentication providers configured, you must designate one as the default IDP. The default IDP determines which provider is used when a user navigates to the tenant’s login page without specifying a provider.
- In the Auth Settings tab, locate the Default IDP dropdown.
- Select the desired provider from the list of configured providers.
- Click Save.
Login Behavior
Section titled “Login Behavior”The login behavior setting controls how the login page is presented to users when multiple authentication providers are available.
Available Options
Section titled “Available Options”| Behavior | Description |
|---|---|
| Show provider selection | Users see a list of available providers and choose which one to use for authentication. |
| Auto-redirect to default | Users are automatically redirected to the default IDP without seeing the login page. This provides a seamless SSO experience. |
Choosing the Right Behavior
Section titled “Choosing the Right Behavior”Use provider selection when:
- The tenant has multiple providers and users need to choose between them
- Some users authenticate via OIDC while others use RAMP Internal
- You want to provide fallback options for authentication
Use auto-redirect when:
- The tenant primarily uses a single OIDC or LDAP provider
- You want a seamless single sign-on experience
- All users authenticate through the same provider
Session Settings
Section titled “Session Settings”Auth settings may also include session-related configuration that controls how long user sessions remain valid and when re-authentication is required. These settings affect all users within the tenant regardless of which provider they use.
Applying Changes
Section titled “Applying Changes”After modifying auth settings:
- Review the configured settings.
- Click Save to apply changes.
- Changes take effect immediately for new login attempts. Existing sessions are not affected until they expire.
Next Steps
Section titled “Next Steps”With authentication configured, you can set up SMTP for email notifications, or proceed to manage users and groups within the tenant.