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
Already have an Okta App for SSO? If you previously set up a Bruno Okta application for SAML SSO, you can reuse it for SCIM provisioning. Skip to the Configure your Okta App section to add provisioning to your existing application.
- As an Okta admin, navigate to Applications and click Create App Integration
- Select SWA - Secure Web Authentication and click Next
- 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/
Configure your Okta App
- On your newly created application page, select the General tab
- Under App Settings, select Edit, and check the Provisioning option SCIM and click Save
- 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 UpdatesPush New UsersPush Profile UpdatesPush Groups
- Authentication: set to HTTP Header
- Under HTTP Header, for token: add the generated API Key value from the prerequisites step
- SCIM connector base URL:
- Click Test Connector Configuration. If successful, a Connector configured successfully message dialogue appears.
-
Click Save to complete the Provisioning integration.
-
Under the Provisioning tab, select the To Apps setting, edit and enable the following options and click Save:
Create UsersUpdate User AttributesDeactivate Users
Your SCIM integration is now complete. You can now begin assigning users to Bruno.
Assign people and groups to Bruno in Okta
-
Under your created Bruno Application, navigate to the Assignments tab
-
Select Assign and either Assign to People or Assign to Groups to provision Bruno license keys
- Assigned Users will receive an email with their License Key
Deprovision users from Bruno in Okta
- Under your created Bruno Application, navigate to the Assignments tab
- Remove the desired users or groups, their license key(s) will be deactivated and they will receive an email notification
Related Resources
For more information about configuring SCIM provisioning with Okta, refer to these Okta documentation resources:
- Add SCIM provisioning to app integrations - Step-by-step guide for adding SCIM provisioning to Okta applications
- SCIM 2.0 protocol overview - Reference for SCIM 2.0 messages and provisioning operations
- On-premises provisioning with SCIM - Architecture and setup for SCIM provisioning
- Test SCIM connectors - Guide for testing SCIM connectors and servers
- Okta provisioning documentation - Comprehensive provisioning documentation and best practices