Skip to content

1Password

Private Beta

Cloud Security is currently in Private Beta. Features, APIs, and configuration formats described here may change before general availability. Contact us if you would like access.

Collects the 1Password account directory — users and groups with membership — into the identity graph, unified by email with your cloud and IdP identities. Optionally, a 1Password Connect server adds vault (secret-store) inventory.

Auth model: the account's SCIM bridge and its bearer token. This is the same provisioning endpoint your identity provider uses; the collector reads it read-only.

Prerequisites

  • 1Password Business, with automated provisioning set up (hosted provisioning or a self-hosted SCIM bridge).
  • The SCIM base URL and its bearer token.
  • (Optional) a running 1Password Connect server plus a Connect token, if you want vault inventory.

Get the SCIM URL and bearer token

  1. Sign in to your 1Password account on the web as an owner/administrator.
  2. Open Integrations (the provisioning setup page).
  3. Copy the SCIM URL and the bearer token shown there.
Deployment SCIM base URL
Hosted provisioning https://provisioning.1password.com/scim/v2
Self-hosted SCIM bridge Your bridge's own URL, e.g. https://scim.example.com

Do not include a trailing slash. Use exactly the URL your identity provider is configured with — the collector appends /Users and /Groups to it, so a wrong base path shows up immediately as a failed scim_users check.

Why the two forms differ

Hosted provisioning serves SCIM under a /scim/v2 path, while a self-hosted bridge serves it at the root of its own domain (the address you open in a browser to reach the bridge's status page). Both are correct for their deployment — copy whichever your Integrations page shows.

This is the provisioning credential, not a new one

The bearer token and the scimsession file are cryptographically linked. If you ever regenerate credentials from the Integrations page, update both your identity provider and this secret.

Read-only by construction

The collector only issues GET /Users and GET /Groups. The SCIM token is account-scoped and all-or-nothing — 1Password does not offer a narrower read-only variant.

Optional: 1Password Connect for vault inventory

1Password Connect is a self-hosted server you deploy alongside your account. Follow 1Password's Connect documentation to deploy the server and issue an access token, then include connect_url and connect_token in the secret. The collector reads only GET /v1/vaults — vault names and metadata, never item contents. Without Connect configured, vault inventory is simply unobserved.

Create the credentials secret

{
  "scim_url": "https://provisioning.1password.com/scim/v2",
  "scim_token": "<bearer-token>",
  "connect_url": "https://connect.example.com",
  "connect_token": "<connect-token>"
}

connect_url / connect_token are optional; omit both if you are not running Connect.

limacharlie hive set --hive-name secret --key onepassword-scim \
    --input-file op-secret.json --enabled

Create the provider record

provider.yaml:

provider_type: 1password
onepassword_scim_url: "https://provisioning.1password.com/scim/v2"
credentials: hive://secret/onepassword-scim
internal_domains: [example.com]
refresh: 6h

In the web app: Add provider → 1Password, then set SCIM URL, Credentials, and Refresh interval.

Verify

limacharlie cloudsec provider test --input-file provider.yaml
Check Required Meaning if it fails
scim_users The bearer token was rejected or the SCIM URL is wrong — this both authenticates and reads the user directory. Nothing else is probed on failure.
scim_groups Group and membership inventory unavailable.
connect_vaults Vault (secret-store) inventory unavailable. Passes with a note when Connect is simply not configured.

Troubleshooting

provider test result Cause Fix
scim_users fails with 404 The base URL is missing (or wrongly carrying) the /scim/v2 path Copy the SCIM URL verbatim from the Integrations page
scim_users fails with 401 The bearer token is wrong, or credentials were regenerated Copy the current token from the Integrations page
scim_users fails to connect The SCIM bridge is not reachable from the public internet, or is behind an allowlist Self-hosted bridges must be reachable; confirm DNS and TLS
connect_vaults fails Connect URL/token wrong, or the Connect token has no vault access Verify the Connect server is running and the token grants read on the vaults you want inventoried