Okta Single Sign-On (SSO)
Overview
Single Sign-On (SSO) allows your employees to sign into Learn Amp using their existing Okta credentials. This eliminates the need for separate passwords and provides a seamless, secure authentication experience.
With Okta SSO enabled, users simply click "Sign in with Okta" and are authenticated using their organisation's identity provider—no additional Learn Amp password required.
Functionality Breakdown
Key Benefits
Simplified Access – One set of credentials for all your applications
Enhanced Security – Leverage Okta's security features including two-factor authentication
Centralised Control – Manage access from your Okta admin console
Real-time Reporting – Monitor authentication events through Okta's security dashboard
How It Works
Learn Amp uses OpenID Connect (OIDC) to authenticate users with Okta:
User clicks "Sign in with Okta" on the Learn Amp login page
User is redirected to Okta to enter their credentials
Okta validates the user and returns an authentication token
Learn Amp creates or updates the user session
User is signed into Learn Amp
💡 Tip: SSO can be used independently of user provisioning. You can enable SSO without automatic user creation—users would need to exist in Learn Amp first.
Pre-requisites
Before setting up Okta SSO, ensure you have:
Administrator access to your Okta account
Administrator access to your Learn Amp account
The Okta integration enabled for your account (contact us to request this)
Role Requirements
The following Learn Amp roles can configure Okta SSO:
Owner – Full access to all integration settings
Admin – Full administrative access to integration settings
Quick Start Guide
Step 1: Create the Okta App
Sign in to your Okta admin account at okta.com
Navigate to Applications → Applications
Click Create App Integration
Select OIDC - OpenID Connect
Select Web Application
Click Next
Step 2: Configure the App
Enter an App Integration Name (e.g., "Learn Amp")
Under Client acting on behalf of a user, enable:
Authorization Code
Refresh Token
Implicit (hybrid)
Step 3: Set Redirect URIs
Add the following Sign-in redirect URIs (replace <subdomain> with your Learn Amp subdomain):
https://<subdomain>.learnamp.com/en-US/okta/auth_callback
https://<subdomain>.learnamp.com/users/auth/okta/callbackStep 4: Configure Assignments
Choose who can access Learn Amp:
Allow everyone in your organization – All Okta users can sign in
Limit access to selected groups – Restrict to specific Okta groups
Skip for now – Configure access later
Click Save.
Step 5: Connect Learn Amp
Sign in to Learn Amp as an Owner or Admin
From the sidebar, select Settings → Integrations → Okta
Copy the Client ID and Client Secret from your Okta app
Enter your Okta domain as the API URL
Click Save, then Connect to Okta
Follow the prompts to authorise the connection
Testing SSO
Once configured, test the integration:
Sign out of Learn Amp completely
Navigate to your Learn Amp URL
Click Sign in with Okta
Enter your Okta credentials
Verify you're signed into Learn Amp successfully
💡 Tip: Test with a non-admin account first to ensure regular users can authenticate correctly.
Configuration Options
Forced SSO
You can configure Learn Amp to require SSO for all users, disabling password-based login. Contact Learn Amp support to enable this option.
SSO + Password Login
By default, both SSO and password login are available. Users can choose their preferred method.
FAQs
Q: Can users still log in with email and password?
Yes, by default both methods are available. If you want to enforce SSO-only login, contact Learn Amp support.
Q: What happens if a user doesn't exist in Learn Amp?
If SSO-only is configured (without provisioning), the user will see an error. To automatically create users, enable User Provisioning alongside SSO.
Q: Can I use SSO without user provisioning?
Yes. SSO and User Provisioning are independent features. You can enable SSO alone—users just need to exist in Learn Amp beforehand.
Q: What authentication details do I need from Okta?
You need: Client ID, Client Secret, and your Okta domain (API URL).
Q: Why am I redirected back to Okta in a loop?
This usually indicates a redirect URI mismatch. Verify your URIs in Okta match exactly, including the protocol (https) and subdomain.
Troubleshooting
Issue | Solution |
|---|---|
"Sign in with Okta" button not showing | The integration may not be enabled. Check Settings → Integrations → Okta is configured. |
Redirect loop after login | Verify redirect URIs in Okta match your Learn Amp subdomain exactly. |
User can authenticate but gets access error | The user may not exist in Learn Amp. Enable User Provisioning or create the user manually. |
SSO works but user details are wrong | User profile may need syncing. Enable User Provisioning to keep details in sync. |
404 error when clicking SSO link | The Okta integration may not be configured. Ask an admin to complete setup. |