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. Okta dashboard: Create App Integration button

​
Step 2: Choose SAML 2.0

  1. In the Create a new app integration dialog, select SAML 2.0.
  2. Click Next. Okta dashboard: Create new app integration dialog

​
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:
SettingValue
Single sign-on URLhttps://db.fleetworks.ai/v1/auth/sso/saml/acs
Use this for Recipient URL and Destination URLChecked (✓)
Audience URI (SP Entity ID)https://db.fleetworks.ai/v1/auth/sso/saml/metadata
Default RelayStatehttps://fleetworks.ai/command-center
Name ID formatEmailAddress
Application usernameEmail
Update application username onCreate 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. Okta dashboard: Attribute Statements configuration screen 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. Okta dashboard: SAML Signing Certificates, Actions button highlighted
  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.