This guide outlines how to enable System for Cross-domain Identity Management (SCIM) to automate user provisioning and deprovisioning between your Identity Provider (IdP) and our application.

This guide outlines how to enable **System for Cross-domain Identity Management (SCIM)** to automate user provisioning and deprovisioning between your Identity Provider (IdP) and our application. 


## 1. Retrieve API Credentials 

To establish a connection, you first need to generate a unique SCIM endpoint and Bearer token. 

* Navigate to **Settings > Identity & Access**. 
* Locate the **Provisioning via Identity Provider (SCIM)** section. 
* Copy the **SCIM Base URL** and **API Token**. 


:::info
**Note**: Keep your API token secure. It will not be displayed again once you leave the page.

:::


 ![](https://brainfish-storage-prod.s3-accelerate.amazonaws.com/uploads/f52d8cbb-8bb7-42b5-b984-3c303f88fa0e/30db0095-180b-4cba-bad5-83726e3f39f2/Screenshot%202026-02-26%20at%2010.11.43.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAUPPN5IL35ODZAU6E%2F20260408%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260408T032843Z&X-Amz-Expires=3000&X-Amz-Security-Token=IQoJb3JpZ2luX2VjECsaCXVzLWVhc3QtMiJHMEUCIQD6fHQxxh56VSH5L1ZmmhcOnMWdQaBjNLgukn6NTB3DwgIgfBA%2Fp8tFUh0VWL8AMyqJ4PfHiYLs6uYaeq5pNYg%2F08Iq5QUI9P%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgwzMDgxMjU5NzUyODciDGrkRurssAY7GBVWUyq5BWkKXWN0kq5Z3y%2B8IYd9ZEpalLVnvtIZcJj401RV2Yz561X8BDiA74dO87Qz8b8uN53f3RS%2Fs5Bp02HQFTBoicyfz86f%2BDsTGeskSBisf2Hup44ex81snymC2%2Bz745vjZ6I5MIlcy%2FkuWqisdWpLjK5CnfVIWmm5BWvCiajyimSndCId1Q96r3MiGHhGA2awooaCyQNm6MPh4YvRRHXfbjZlA8SMXfVG3Ehq6ypcqNId4Nyo7drrVA79uoXNWuFPF%2BjcpyRd98F7S%2Fug6KlxCHOOMPTIaRDw9toYNF3tZaxfGqNXrRwqZchJzU6%2BsG42CoqGkDa2o%2B7TvkIIcN4xcrtPaMrloP0e4Pky6pCYUQ9QBMaOoWEpNdcAMIaY2WsjDzh8JX9caW2kXmUPXqM8vjq3mKa%2Bfg1QTG%2By%2BcDC1GfMx0w69r%2F1C6wAOGLrZLfj4QNoXtH3Wc6Sc26R%2FZGpUPo7GRbgGxtV0tsFDl3JNmvP22z%2Bl0TIEZ6abtJA4issbvpI1XALUsQiSVTtsnLC6GMlX1kqlFI1WRrysQk5jPCobwY6sd6NEwzkEUNSIN7ef4bLqqRYoytkePveZrJC2WKa4wc%2FbVpzfl46efKTghsMkLeXVVNgTbVl%2FiFrcba1bPURHIHjkMuijPm2Z3SxBpwtmDH9C4ciQaCOfPOqDGlxySpVoC1w5RYrAOH5FNDZmNd4WINsMNWEbX5HqDli8J5ea%2F6quTUKst3dZNhUWO8YXlry0Lrrn9HshjY%2Ba1XSRnO%2FpW35w3EVZUV5wb8DTXchzGEviCf97sQ%2FmydkV0%2BhQwukp06l7ismFgje85x8cBspdYJSnTaqw%2BrebijK2VGG9rkT8hfuiarlSEdaudptJUU4SQO1M9%2FmZjgCBqfCFYzFKqPcwhTfhJdprzy6Y58SgJSg5jkijskw1oLXzgY6kAHQ5EIqTwtj6i7j5O%2FLH1Y0GNMJvgL2QoD4PAhme%2FWtODDGyYiLuC1r6Hja83Jc8dmJeyKZ1raHHTkGho0EEKq8Je26XVSVXpG8sOOpYX%2FABcXytM1AD%2BaIC1lptTEp0iJZWiRhBM1T5GoibDDv1id775zcONleOsjvpWXv4mJ3PPdBg4Tz5%2FEzbAWWFvc%2Fpvw%3D&X-Amz-Signature=82430dc3746800881e4ade674fab0c32dff5622141e3d5cf5ff16566e954ed42&X-Amz-SignedHeaders=host&response-content-disposition=attachment " =1400x890")


## 2. Role Mapping and Permissions 

To ensure users are assigned the correct permissions upon synchronization, you must configure roles within your IdP that correspond to our system's access levels.

| **IdP Role Value**  | **Application Access Level** |
|----|----|
| `owner` | Owner role in your organization |
| `member` | Member role in your organization |



## 3. Attribute Mapping (Schema Configuration) 

For roles to sync correctly, you must map the user’s role attribute in your IdP (such as Okta, Azure AD, or OneLogin) to our specific custom schema extension. 

**Required Mapping Target:** `urn:ietf:params:scim:schemas:extension:cobalt:2.0:User:role`

SCIM Provisioning Setup Guide

Organization Overview

Your Cobalt Contract

Manage Users

Configure SAML SSO

How to Configure SAML 2.0 for Cobalt 

SAML Migration: Update Your Configuration

Configure Organization Settings

Organization

How to get started with Cobalt

Getting Started

Risk Advisories

Assets are what we pentest

Asset Types

Create an Asset

Assets

Preparation

Contents of a Pentest Report

Customize Your Report

Co-branded Reports

Reports

Remediate Findings

Finding States

Severity Levels

Findings

Set Up an In-House Pentest

Complete an In-House Pentest (For Pentesters)

In House Pentests

Pentest Expectations

Coverage Checklist

Pentest States

Pentest Process

Overview

Asset Details

Pentest Details

Scope & Test Period

Create a Pentest

Pentests

Engagements Overview

Digital Risk Assessment

Secure Code Review

Engagements

Insights

Planning

Cobalt Methodologies Overview

Web Methodologies

API Methodologies

External Network Methodologies

Internal Network Methodologies

Mobile Methodologies

Cloud Configuration Review Methodologies

Cloud Pentest Methodology

Desktop Methodologies

AI/LLM Methodologies

Digital Risk Assessment Methodology

Secure Code Review Methodologies

Methodologies

Attack Surface Monitoring (ASM)

Attack Surface

Best Practices

Integrations

Partial Scans: Reduced Scope

Scans

Sequence recorder

Targets

Target Authentication

DAST Scanner Overview

Extra Hosts

Blackout Period

DAST Scanner

Account Overview

Account Settings

Password Best Practices

Sign In to Cobalt

Troubleshoot Sign-in Issues

User Account

Collaboration Overview

Groups

Manage Pentest Collaborators

Manage Notifications

User Roles and Permissions

Collaborate on Pentests

Collaboration

Cobalt Credits

Track Your Credits

Cobalt PtaaS Tiers

Credits

Connect your applications

Create Azure DevOps Work Item for Findings

Create GitHub tickets for Findings

Create GitLab tickets for Findings

Send email notifications for Findings from Outlook

Send MS Teams notifications for Findings

Create Jira tickets for Findings

HTTP Connector

Import Assets from Google Sheets

Map Cobalt Pentest Finding Severity to Jira Issue Priority

Modify Jira Issue Summary to contain Pentest Title

How to Guides

Troubleshooting

Integration Builder

Jira Cloud Integration

Jira Data Center Integration

Push Cobalt Findings to Jira

Synchronize Cobalt Severity Levels with Jira

Switching to a New Jira Instance

Troubleshoot Your Jira Integration

Integrate Jira with Cobalt

Kenna Security

Vanta

Cobalt Integrations Overview

Slack

Microsoft Teams

Webhooks

DefectDojo

Carried Over Findings

Create Test Finding

Cobalt API Overview

Create a Personal Cobalt API Token

Get an Organization Token

Revoke Your Personal Cobalt API Tokens

Create or Modify an Asset

Import Findings to Google Sheets

Cobalt API

Glossary

November 2025 

March 2026

February 2026

January 2026

August 2025

July 2025

June 2025

May 2025

April 2025

March 2025

January 2025

December 2024

November 2024

October 2024

September 2024

August 2024

July 2024

June 2024

May 2024

April 2024

March 2024

January 2024

What's New

Cobalt Product Documentation

SCIM Provisioning Setup Guide

Share

Share

SCIM Provisioning Setup Guide

Share

Share