SINGLE SIGN-ON INTO ODOO WITH OKTA WORKFORCE (SP Initiated SSO)

Introduction:

The Okta Workforce solution provides a secure and seamless single sign-on (SSO) experience, allowing employees to securely access Odoo without needing to remember multiple credentials. This integration enhances security, streamlines user management, and ensures a unified login experience across systems.

This guide explains how to configure Okta Workforce with Odoo, including creating a single sign-on application in Okta, collecting configuration details, and setting up Okta within Odoo for easy authentication.

Features:

• Allows direct sign-in to Odoo: Users can sign in to Odoo directly using their Okta credentials.
• Supports Service Provider (SP) Initiated SSO: Enables Odoo to act as a Service Provider within the SSO configuration, allowing users to start their login in Odoo and authenticate via Okta. This setup streamlines access control and enhances secure authentication.
• OIDC SSO:
  • The OpenID Connect (OIDC) authentication protocol lets you verify the identity of users attempting to gain access to endpoints protected by HTTPS.
  • While OAuth provides only authorization, OIDC delivers an added layer of security through authentication.
  • This combination of authentication and authorization means you can use OIDC for single sign-on (SSO), which allows users to retain a single login across multiple websites or applications.

Setup and Workflow:

1. Create an app for single sign-on with Odoo inside Okta admin console.

a. Log in to your Okta application side as an admin to access the admin console.



b. Once logged in as an admin user, create an app for single sign-on with Odoo.

2. Collect the configuration details for Odoo.

a. Acquire the client ID and client secret from the registered app.





Please note that the following details are required to configure inside Odoo to ensure single-sign on authentication.

1. Client ID (can be captured from the single-sign on app)
2. Client Secret (can be captured from the single-sign on app)
3. Authorization URI: https://<your-okta-domain>/oauth2/default/v1/authorize
4. Redirect URI: https://<your-odoo-domain>/authorization-code/callback
5. Issuer: https://<your-okta-domain>/oauth2/default/v1
6. Token URI: https://<your-okta-domain>/oauth2/default/v1/token
7. Userinfo URI: https://<your-okta-domain>/oauth2/default/v1/userinfo

3. Configure Okta Workforce in Odoo:

a. Once after collecting details from Okta, login inside Odoo and locate Settings->Users & Companies -> Okta Workforce.



b. Click on New to start creating the Okta configuration with the details collected from Okta.

4. Single Sign-on via Okta Workforce:

a. Once after clicking on login with Okta Workforce, it automatically redirects to the Okta sign-in page where you can enter your Okta credentials and sign into Okta.
b. After successfully signing into Okta, the system will automatically log you into Odoo as well.
c. If the Okta user is not present in Odoo prior to signing in, it will ask you to sign up into Odoo and then sign in.
d. If the Okta user is already present in Odoo, it will automatically authenticate and redirect into Odoo.

Test Cases

1. New User Registration and Landing Page

• If the user is new, they will be prompted to sign up, where they can set their password and complete the registration.
  

• After registration, the user will see a confirmation page indicating "Registration successful."
  

• Once signed up, the user is automatically assigned as a portal user.
  

2. Existing User Login and Landing Page

• For users who have already signed up, logging in will display the landing page as shown in the image below.
  

3. Internal User Landing Page

• Internal users, upon logging in, will be taken directly to the main Odoo dashboard.
  

Comments: If the Odoo website module is installed, users will land on the website portal page by default after signing up.