- SCIM to provision users into the Blindsight workspace from your IdP.
- OIDC + the device‑code flow to bind each device to a specific directory user.
SCIM provisioning
SCIM (System for Cross‑domain Identity Management) is how your IdP keeps the Blindsight workspace’s user list in sync with your directory. When you hire someone, they appear in Blindsight automatically. When you off‑board them, they’re disabled.Set it up
1
Add a SCIM provider in Blindsight
Open Runtime Security → Directory & SSO → SCIM and click
Issue token. Blindsight returns:
- A bearer token (shown once). Copy it.
- A base URL:
https://<cloud>/scim/v2.
2
Wire it in your IdP
In Entra, Okta, Google, or your IdP of choice, add a custom SCIM
application. Paste the base URL and bearer token. Map standard
SCIM attributes (
userName, emails[primary], name.givenName,
name.familyName, active).3
Assign users and groups
Assign the directory groups whose members should be provisioned
into Blindsight. Your IdP pushes them immediately.
4
Verify in Blindsight
Under Settings → Users, look for the SCIM source badge on
each row. Users land with
provisioning_source=scim and are
auto‑activated.Behavior
Group‑to‑role mapping
Under Directory & SSO → Group mappings, map IdP groups to Blindsight roles. Common pattern:
A user with multiple matching groups gets the highest role.
OIDC single sign‑on
OIDC is how employees sign into the Blindsight dashboard and how the DLP agent binds a device to a directory user.Configure your provider
1
Register Blindsight as an OIDC client
In your IdP, create a new app and copy the Where
client_id and
client_secret. Set the redirect URI to:<provider-uuid> is generated when you add the provider in
Blindsight.2
Add the provider in Blindsight
Runtime Security → Directory & SSO → OIDC providers → Add.
Provide:
client_idclient_secretdiscovery_url(e.g. for Entra:https://login.microsoftonline.com/<tenant>/v2.0/.well-known/openid-configuration)
3
Test the flow
Click Test sign-in on the provider card. Blindsight opens the
IdP, you authenticate, and it redirects back with a confirmation
page.
Supported providers
OIDC covers Entra, Okta, Google Workspace, and Ping. Any standards‑compliant OIDC IdP that publishes a discovery document works. SAML is schema‑ready in the backend but not enabled in this build.Device‑code identity binding
Once the agent is installed on a laptop, it needs to know which directory user is sitting at the machine. The agent runs the OIDC device‑code flow (RFC 8628):- The agent posts to
/agent/identity/start. - Blindsight returns a short verification code and opens the IdP sign‑in page in the user’s default browser.
- The employee signs in with their normal corporate credentials.
- The agent polls
/agent/identity/statusuntil the IdP confirms the binding. - The device row in Devices & Enrollment flips from
pendingtobound, with the directory user attached.
Re‑binding
A device can be re‑bound to a different directory user:- Automatically when SCIM marks the previous user inactive.
- Manually by an admin from Devices & Enrollment → device row → Force re‑bind.
Auto identity for non‑user devices
For devices that don’t have a human user (lab machines, build servers), the agent setsIdentity = auto when:
- The OS username matches a directory user email’s local part, and
- SCIM has already provisioned that user.
service so they’re
filtered out of the regular user fleet view.
Common workflows
On‑board a new employee
On‑board a new employee
- HR adds them to the directory.
- SCIM provisions them into Blindsight (~1 min).
- IT ships a managed laptop. On first boot, the agent enrolls and prompts for SSO identity binding.
- Employee signs in with corporate credentials. Device is
boundto their directory user.
Off‑board an employee
Off‑board an employee
- HR deactivates them in the directory.
- SCIM disables them in Blindsight.
- Their device is auto‑revoked. The agent stops processing traffic and flags the machine for reclaim.
Spin up a CI build host
Spin up a CI build host
- IT pushes the agent with the regular MDM policy.
- Set
Identitytoserviceand rename the device row toci-runner-04. - Traffic from the runner is attributed to
service:ci-runner-04so you can filter it out of user‑centric reports.

