Set up SSO with Okta

FleetWorks supports single sign-on (SSO) using Okta using SAML 2.0.

Step 1: Create an App Integration in Okta

1. Navigate to the Applications dashboard in your Okta admin console.

2. Click Create App Integration.

   

Step 2: Choose SAML 2.0

1. In the Create a new app integration dialog, select SAML 2.0.

2. Click Next.

   

Step 3: Configure General Settings

1. Enter an App name (e.g., “FleetWorks”). This name is for your reference within Okta.
2. Optionally, upload our logo.
3. Click Next.

Step 4: Configure SAML Settings

Enter the following details exactly:

Setting	Value
Single sign-on URL	https://db.fleetworks.ai/v1/auth/sso/saml/acs
Use this for Recipient URL and Destination URL	Checked (✓)
Audience URI (SP Entity ID)	https://db.fleetworks.ai/v1/auth/sso/saml/metadata
Default RelayState	https://fleetworks.ai/command-center
Name ID format	EmailAddress
Application username	Email
Update application username on	Create and update

Step 5: Configure Attribute Statements

Attribute Statements allow Fleetworks to receive user information from Okta during login.

Required:

• Name: email
• Name format: (Unspecified)
• Value: user.email

You can add other optional mappings depending on your Okta setup.

Click Next.

Step 6: Obtain IdP Metadata URL

FleetWorks needs your Okta application’s metadata URL to complete the setup.

1. Go to the Sign On tab of your newly created FleetWorks application in Okta.

2. Scroll down to the SAML Signing Certificates section.

3. Find the certificate with an Active status (usually SHA-2).

4. Click the Actions dropdown for that certificate and select View IdP metadata.

   

5. This will open the metadata XML file in a new browser tab. Copy the URL from the address bar. It typically looks like https://<your-okta-domain>.okta.com/app/<app-id>/sso/saml/metadata.

6. Send this Metadata URL to your FleetWorks support contact.

Step 7: Wait for Confirmation

Your FleetWorks contact will use the Metadata URL to configure SSO on the FleetWorks side. Please wait for confirmation that this setup is complete (usually within 1-2 business days).

Step 8: Test Single Sign-On

Once you receive confirmation from FleetWorks:

1. Go to the FleetWorks login page (https://fleetworks.ai/login).
2. Choose the “Sign in with SSO” or “Sign in with Okta” option.
3. Enter your email address associated with your Okta account.
4. You should be redirected to Okta to authenticate, and then back to FleetWorks, successfully logged in.

If you encounter issues, please contact your FleetWorks support representative.