Docs

Okta SSO and Provisioning

Suggest Edits
To simplify user access to Bright, you can configure Single Sign-On (SSO) integration with your Okta application. Either the OIDC or SAML protocol can be used to enable Okta SSO.

You can also take advantage of Okta provisioning feature to automatically synchronize users and groups between your Okta application and Bright organization.

The provisioning integration is built around an industry-standard protocol known as SCIM (System for Cross-domain Identity Management). This protocol is design for user management across multiple applications. It allows you to easily provision (add), deprovision (delete) and update (map) user data across multiple applications at once.

You can set up SCIM provisioning in Okta to automatically add the Okta application users and groups to your organization in the Bright App. The added users will be able to access the Bright App using Okta SSO.

Bright supports the following attribute mappings for SCIM provisioning:

  • userName
  • email
  • emailType
  • displayName

Enabling Okta SSO via OIDC protocol

Features

Okta integration with Bright allows users to link their Okta accounts with their Bright accounts and sign in to the Bright app via Okta SSO, using the SP-initiated flow.

Requirements

The Bright integration with Okta is available to Pro and Enterprise users only. To learn how to upgrade your plan, please read Manage Your Plan.

Step-by-step configuration guide

To enable Okta SSO for your Bright organization, follow these steps:

  1. Log in to Okta.
  2. Browse for the preconfigured Brightsec integration app in the Okta catalog and add it to your applications.
  3. When onboarding, in the General Settings tab, set your subdomain and click Next.

  1. In the Sign-On Options tab, select OpenID Connect.
1593
  1. In the Credentials Details section, set the Application username format to Email, and then click Done.
    The Brightsec integration app is set up.
  2. In the Assignments tab, assign users to the app.
    The assigned users will then get SSO access to the Bright app.
  3. In the Sign On tab, get the credentials of the created app to authorize it in the Bright app:
  • Copy the client ID and client secret values.
1896
  • Click OpenID Provider Metadata and copy its URL. The metadata URL format is <https://{org_slug}.okta.com/.well-known/openid-configuration>
1893
  1. Log in to the Bright app.
  2. In the left pane, select the Organization option, and go to the ORGANIZATION SETTINGS section.
  3. From the Single sign on (SSO) Authentication dropdown list, select Okta, and then click Connect.

  1. On the OKTA AUTHENTICATION page, do the following:
  • Select the Default Role the new members will be assigned to.
  • Select the OIDC protocol.
  • Enter the Client ID, Client Secret and Metadata URL copied from the Brightsec integration app in Okta.

  1. Click Save settings.
    After Okta SSO is set up, an email is sent to all the users of your Bright organization suggesting to confirm their accounts and link their Okta profiles to the Bright profiles. Once the accounts are linked, the users can log in to the Bright app using the Okta SSO option.
  2. (Optional) You can enforce SSO registration by selecting the Require your organization members to use SSO to access Bright checkbox. When this option is selected, only the registered users (current members of a Bright organization) with existing SSO accounts can access the Bright app.

🚧

Important

Strict enforcement of SSO for all organization members will require resetting the connection in case of an SSO break. If that happens, please contact the Bright technical support for assistance.

  1. On the login page of the Bright app, click Single Sign On (SSO).

  1. Enter your Bright organization name and click Continue.
  2. Select Sign in with Okta.
    You are redirected to the Okta login page.
  3. Enter your Okta credentials and click Sign In.

Known issues/troubleshooting

Please contact our support team at [email protected] if you encounter any issues with Bright/Okta integration.

Enabling Okta SSO via SAML protocol

Features

Okta integration with Bright allows users to link their Okta accounts with their bright accounts and sign in to the Bright app via Okta SSO, using the SP-initiated flow.

Requirements

The Bright integration with Okta is available to Pro and Enterprise users only. To learn how to upgrade your plan, please read Manage Your Plan.

Step-by-step configuration guide

To enable Okta SSO for your Bright organization, follow these steps:

  1. Log in to Okta.
  2. Browse for the preconfigured Brightsec integration app in the Okta catalog and add it to your applications.
  3. When onboarding, in the General Settings tab, set your subdomain and click Next.
1567
  1. In the Sign-On Options tab, select SAML 2.0.
1595
  1. In the Credentials Details section, set the Application username format to Email, and then click Done.
    The Brightsec integration app is set up.
  2. In the Assignments tab, assign users to the app.
    The assigned users will then get SSO access to the Bright app.
  3. In the Sign On tab, get the metadata of the created application to authorize it in the Bright app. For that, click Identity Provider Metadata and copy its URL.
1896
  1. Log in to the Bright app.
  2. In the left pane, select Organization, and go to the ORGANIZATION SETTINGS section.
  3. From the Single sign on (SSO) Authentication dropdown list, select Okta, and then click Connect.

  1. On the OKTA AUTHENTICATION page, do the following:
  • Select the Default Role the new members will be assigned to.
  • Select the SAML protocol.
  • Enter the Metadata URL copied from the Brightsec integration app in Okta.
1909
  1. Click Save settings.
    After Okta SSO is set up, an email is sent to all the users of your Bright organization suggesting to confirm their accounts and link their Okta profiles to the Bright profiles. Once the accounts are linked, the users can log in to the Bright app using the Okta SSO option.
  2. (Optional) You can enforce SSO registration by selecting the Require your organization members to use SSO to access Bright checkbox. When this option is selected, only the registered users (current members of a Bright organization) with existing SSO accounts can access the Bright app.

🚧

Important

Strict enforcement of SSO for all organization members will require resetting the connection in case of an SSO break. If that happens, please contact the Bright technical support for assistance.

  1. On the login page of the Bright app, click Single Sign On (SSO).

  1. Enter your Bright organization name and click Continue.
  2. Select Sign in with Okta.
    You are redirected to the Okta login page.
  3. Enter your Okta credentials and click Sign In.

Known issues/troubleshooting

Please contact our support team at [email protected] if you encounter any issues with Bright/Okta integration.

Enabling SCIM provisioning between Okta and Bright

Features

The following provisioning features are currently supported by Bright:

  • Push New Users. Users created in Okta and assigned to the Brightsec integration application in Okta are automatically added as members to the linked organization in the Bright app.
  • Push Profile Updates. Updates made to the user's profile through OKTA will be pushed to the Bright app.
  • Push User Deactivation. Deactivating the user or disabling the user's access to the Brightsec integration application through OKTA will deactivate the user in the Bright app.
    Note: For the Brightsec integration application in Okta, deactivating a user means removing access to login, but maintaining the user's Bright information as an inactive user.
  • Reactivate Users. User accounts can be reactivated for the Brightsec integration application in Okta.
  • Push Groups. Groups and their members in Okta can be pushed to the linked Bright organization.

Requirements

  • The Bright integration with Okta is available to Pro and Enterprise users only. To learn how to upgrade your plan, please read Manage Your Plan.
  • To configure the provisioning flow, first you need to enable Okta SSO for your Bright organization via the OIDC or SAML protocol. Please see the guides above for the detailed instructions.
  • For the provisioning setup, you will require to create an organization API key or a personal API key with the scim scope and copy its value.

Step-by-step configuration guide

Provisioning setup in the Bright app

  1. In the ORGANIZATION SETTINGS, select the option Sync the group & users from your SSO provider to Bright.

  1. Create an organization API key or a personal API key with the scim scope and copy its value.

Provisioning setup in Okta

  1. In your Brightsec integration app, open the Provisioning tab and click Configure API integration.

  1. Select the Enable API integration checkbox, and then enter the API token copied from the Bright app.

  2. Click Save.

  3. In the Provisioning to App section, enable the provisioning options you will need by selecting the relevant checkboxes, and then click Save.
    The provisioning setup is completed.

User provisioning

Once you complete the provisioning setup, every new user assigned to the Brightsec integration app will be automatically added to the relevant Bright organization.

Group provisioning

Group provisioning from Okta to the Bright app is only enabled by pushing every group manually.

To push a group to your Bright organization, follow these steps:

  1. Assign the group you want to push to the Brightsec integration app.

  2. In the Push Groups tab, click Push Groups.

  3. Select the group you want to push to your Bright organization and click Save.

If you need to deprovision a group from your Bright organization, delete the group from the Brightsec integration application in Okta, and then unlink this group in the Push Groups tab.

Known issues/troubleshooting

Bright does not support special symbols for userName. If the userName of an Okta user contains special symbols, they will be sanitized when signing in to a Bright organization via SSO. For example, “#John Do`e¥” will be signed in to Bright as "John Doe”.

Please contact our support team at [email protected] if you encounter any issues with Bright/Okta integration.

Updated 9 months ago