Okta setup

Control access to BugSnag using Okta.

BugSnag’s integration with Okta provides:

• Authentication and authorization (SAML)
• User and group/team provisioning and deprovisioning (SCIM)

Setup SAML

To configure SAML (Organization admin access required):

1. In your Insight Hub dashboard, select Single sign-on from your organization settings (shortcut: go):

   • Copy the SAML endpoint URL to your clipboard.

2. In Okta Admin, select Applications then Browse App Catalog and search for “Bugsnag SAML”. Select Add Integration.

3. In General Settings:

   • SAML Endpoint URL – Paste the URL copied from BugSnag.
   • Select Next, assign users as required, then Done.

4. In the Sign On tab:

   • Under SAML Signing Certificates, select Actions and copy the link to the IdP metadata to your clipboard (the URL not the metadata itself)
   • Select Next.

5. In your Insight Hub dashboard:

   • Paste the IdP metadata URL in the SAML/IdP Metadata field.
   • Select Auto-provision collaborators if you would like accounts to be automatically created for new users when they first log in (see SCIM for full provisioning and deprovisioning support).
   • Select whether users will be granted access to all current projects or no projects by default. Users will only be added up to your plan’s collaborator limit. After provisioning, access to projects can be managed by any Admin.
   • Select Enable SSO.

6. Users assigned to the app in Okta can now log in to your Insight Hub dashboard.

Setup provisioning and deprovisioning (SCIM)

The following provisioning and deprovisioning features are supported:

• Create users
• Update user names and email addresses
• Deactivate users
• Push groups

To configure access (Organization admin access required):

1. In your Insight Hub dashboard, select Personal auth tokens from the user settings (shortcut: gu) of an organization administrator:

   • Generate a new auth token which will be used for SCIM.

2. Select Single sign-on from your organization settings (shortcut: go):

   • Copy the SCIM Base URL.

3. In Okta Admin, open the configuration for the BugSnag application and in the Provisioning tab.

   • Enter the SCIM base URL and auth token in the Integration section.
   • Ensure the provisioning options are enabled in the To App section.

4. In the Sign On tab:

   • Ensure Application username format is set to Email.

Session Timeout

If a SessionNotOnOrAfter value is present in the SAML authentication response, it will be used to set the timeout of the BugSnag session.

Please see the Okta documentation for information about setting SessionNotOnOrAfter in your SAML responses.

Known issues

None.