Configure Okta Single Sign-On (SSO) for Symbol Security (OIN)

Learn how to configure SAML 2.0 Single Sign-On (SSO) between Okta and Symbol Security using the official Symbol Security application in the Okta Integration Network (OIN).

Prerequisites

Before you begin, ensure you have the following:

  • An active Okta tenant with Super Admin or Application Admin permissions.
  • A Symbol Security account with Company Admin or MSP/vCISO Partner Admin access.
  • Users assigned to the Symbol Security application in Okta must have matching email addresses in Symbol Security (or be provisioned via SCIM).

Supported Features

The Okta Symbol Security SAML 2.0 integration currently supports the following features:

  • SP-initiated SSO (Service Provider-initiated Single Sign-On)
  • IdP-initiated SSO (Identity Provider-initiated Single Sign-On)

(Note: For automated user and group lifecycle management, see our Setup SCIM Provisioning for Okta guide.)

Configuration Steps

Step 1: Retrieve SAML Settings from Symbol Security

  1. Sign in to the Symbol Security portal:
    • Single Company Admins: Click the menu icon in the top-right corner, select Settings, and navigate to the Single Sign-On (SSO) tab.
    • MSP/vCISO Partners: Navigate to the target Company Profile, open the General tab, and select Single Sign-On (SSO).
  2. Click Activate SSO to generate your Service Provider configuration details.
  3. Note your Tenant / Company SSO Identifier (if applicable in your OIN app settings) and keep this browser tab open—you will return here in Step 3 to upload your Okta Identity Provider metadata.

Step 2: Add Symbol Security in Okta

  1. Sign in to your Okta Admin Console.
  2. In the left navigation menu, go to Applications > Applications.
  3. Click Browse App Catalog.
  4. Search for Symbol Security, select the official integration, and click Add Integration.
  5. On the General Settings screen:
    • Enter an Application label (default: Symbol Security).
    • Click Next.
  6. On the Sign-On Options screen:
    • Select SAML 2.0 as the sign-on method.
    • Under Advanced Sign-on Settings, enter any required tenant identifier retrieved from Symbol Security in Step 1.
    • Ensure Application username format is set to Email.
    • Under Metadata details, copy the Metadata URL (or click View SAML setup instructions / download the IdP Metadata XML file).
    • Click Done.

Step 3: Upload Okta Metadata to Symbol Security

  1. Return to the Single Sign-On (SSO) settings page in Symbol Security.
  2. Save the Okta Metadata URL content as an .xml file on your computer (open the Metadata URL in a new browser tab, right-click the page, select Save As, and save it as metadata.xml).
  3. In Symbol Security, upload the metadata.xml file in the Identity Provider Metadata section.
  4. Click Save / Activate SSO to finalize the SAML connection.

Step 4: Assign Users in Okta

  1. In the Okta Admin Console, open your Symbol Security application.
  2. Navigate to the Assignments tab.
  3. Click Assign and choose Assign to People or Assign to Groups.
  4. Select the users or groups who should have access to Symbol Security, click Assign, verify their user details, and click Done.

SP-Initiated SSO

The sign-in process can be initiated directly from the Symbol Security login portal:

  1. Open an incognito/private browser window and navigate to the Symbol Security Login Page (https://app.symbolsecurity.com) or your custom URL.
  2. Enter the email address of a user assigned to the Symbol Security app in Okta.
  3. Symbol Security will automatically detect your domain’s SAML configuration and redirect you to the Okta Sign-In screen.
  4. Authenticate with your Okta credentials. Upon successful verification, you will be redirected back to your Symbol Security dashboard.

Troubleshooting & Support

  • Ensure the user’s primary email address in Okta matches their email address in Symbol Security.
  • Verify that the user is assigned to the Symbol Security app under the Assignments tab in Okta.
  • Need help? Contact Symbol Security Support at [email protected].