Okta SCIM provisioning with Bruno

This guide will walk you through setting up SCIM (System for Cross-domain Identity Management) provisioning with Bruno using Okta SWA (Secure Web Authentication).

Prerequisites: Before configuring Okta, you must first enable SCIM provisioning in Bruno and generate an API key. Follow the Enabling SCIM Provisioning section in the overview page to complete this setup and save your API key for use in the steps below.

Create your Okta App

  1. As an Okta admin, navigate to Applications and click Create App Integration
License portal login
  1. Select SWA - Secure Web Authentication and click Next
License portal login
  1. On the Create SWA Integration page, add the following values and click Finish:
    • App name: (Unique App Name - e.g. Bruno SCIM Integration)
    • App’s login page URL: https://license.usebruno.com/
License portal login

Configure your Okta App

  1. On your newly created application page, select the General tab
  2. Under App Settings, select Edit, and check the Provisioning option SCIM and click Save
License portal login
  1. Return to your Okta app, select the Provisioning tab, under SCIM Connection select Edit and configure the following values:
    • SCIM connector base URL: https://license.usebruno.com/scim/v2
    • Unique identifier field for users: email
    • Supported provisioning actions: Check the following options:
      • Import New Users and Profile Updates
      • Push New Users
      • Push Profile Updates
      • Push Groups
    • Authentication: set to HTTP Header
    • Under HTTP Header, for token: add the generated API Key value from the prerequisites step
License portal login
  1. Click Test Connector Configuration. If successful, a Connector configured successfully message dialogue appears.
License portal login
  1. Click Save to complete the Provisioning integration.

  2. Under the Provisioning tab, select the To Apps setting, edit and enable the following options and click Save:

    • Create Users
    • Update User Attributes
    • Deactivate Users
License portal login

Your SCIM integration is now complete. You can now begin assigning users to Bruno.

Assign people and groups to Bruno in Okta

  1. Under your created Bruno Application, navigate to the Assignments tab

  2. Select Assign and either Assign to People or Assign to Groups to provision Bruno license keys

License portal login License portal login
  1. Assigned Users will receive an email with their License Key
License portal login

Deprovision users from Bruno in Okta

  1. Under your created Bruno Application, navigate to the Assignments tab
License portal login
  1. Remove the desired users or groups, their license key(s) will be deactivated and they will receive an email notification
License portal login