1Password setup

Documentation Index

Fetch the complete documentation index at: https://support.configview.com/llms.txt

Use this file to discover all available pages before exploring further.

ConfigView pulls 1Password data through three separate credentials that you create in your own 1Password account. Each one unlocks a different slice of data: The credentials are intentionally separate because 1Password issues them through three different admin surfaces, each with its own scope. ConfigView can run with any subset — if you only have the Events Reporting API enabled, just create that one and enable only the Events scripts. You will end up with 5 secrets in ConfigView (OP_EVENTS_HOST, OP_EVENTS_TOKEN, OP_SCIM_URL, OP_SCIM_TOKEN, OP_SERVICE_ACCOUNT_TOKEN) when all three parts are complete.

---

​

Part 1: Events Reporting API

Set up an Events Reporting integration so ConfigView can pull sign-in attempts, item usages, and audit events.

---

​

Step 1: Create the Events Reporting Integration

1. Sign in to your 1Password account as an Owner or Administrator at https://my.1password.com
2. Click Integrations in the sidebar
3. Under Events Reporting, click Add Integration and choose Other
4. Name: ConfigView
5. Pick which event streams to enable. ConfigView uses all three:
   • Sign-in attempts
   • Item usages
   • Audit events
6. Click Add Integration
7. Copy the bearer token that appears. You will not be able to see it again — store it somewhere safe.

Note: The Events Reporting API requires a Business or Enterprise plan. If you do not see Events Reporting under Integrations, contact your 1Password account rep to confirm your plan tier.

---

​

Step 2: Note your Events API host

The Events API host depends on your 1Password tenancy: Copy the host that matches your tenancy.

---

​

Step 3: Add the Events secrets to ConfigView

1. Go to your ConfigView dashboard: https://{companyname}.configview.com/admin/secret/
2. Click Add Secret and create:
   • OP_EVENTS_HOST: the host from Step 2 (e.g. https://events.1password.com)
   • OP_EVENTS_TOKEN: the bearer token from Step 1
3. Click Save

---

​

Part 2: SCIM Bridge

Set up SCIM Bridge access so ConfigView can pull users, groups, and group membership.

Skip this section if you do not have a SCIM Bridge deployed. SCIM Bridge is an optional 1Password component used for IdP provisioning (Okta, Azure AD, etc.). If you have not deployed it, skip to Part 3.

---

​

Step 1: Locate (or create) the SCIM bearer token

If your SCIM Bridge is already provisioning users from your IdP, a bearer token already exists. You can either reuse it or create a dedicated one for ConfigView. To create a dedicated token:

1. Sign in to your SCIM Bridge admin UI (e.g. https://scim.yourcompany.com) using the recovery code
2. Click Generate to produce a new bearer token
3. Copy the token — store it somewhere safe

To reuse the existing token: retrieve it from wherever your IdP integration stores it (Okta admin, Azure AD enterprise app, etc.).

---

​

Step 2: Note your SCIM Bridge URL

This is the public URL of your SCIM Bridge deployment, e.g. https://scim.yourcompany.com. No trailing slash; ConfigView normalizes it either way.

---

​

Step 3: Add the SCIM secrets to ConfigView

1. Go to: https://{companyname}.configview.com/admin/secret/
2. Click Add Secret and create:
   • OP_SCIM_URL: your SCIM Bridge URL (e.g. https://scim.yourcompany.com)
   • OP_SCIM_TOKEN: the bearer token from Step 1
3. Click Save

---

​

Part 3: Service Account (vault inventory)

Set up a 1Password service account so ConfigView can list vaults, items metadata, and per-vault permissions via the op CLI.

ConfigView reads metadata only — item titles, tags, vault membership. It never reads or stores secret values from your vaults. To enforce this, scope the service account read-only and grant access only to the vaults you want inventoried.

---

​

Step 1: Create the Service Account

1. Sign in to your 1Password account as an Owner at https://my.1password.com
2. Click Integrations in the sidebar
3. Under Service Accounts, click Create Service Account (or Other → Service Account)
4. Name: ConfigView
5. Pick the vaults the service account should have access to. ConfigView will inventory exactly these — anything you don’t grant remains invisible.
6. For each vault, choose the Read Items permission only.
7. Click Create Account
8. Copy the service account token (starts with ops_...). You will not be able to see it again — store it somewhere safe.

Note: If you want ConfigView to inventory every vault in your account, grant the service account access to all vaults. New vaults created after this point will not be visible until you explicitly grant the service account access to them.

---

​

Step 2: Add the Service Account secret to ConfigView

1. Go to: https://{companyname}.configview.com/admin/secret/
2. Click Add Secret
3. Secret name: OP_SERVICE_ACCOUNT_TOKEN
4. Secret value: Paste the ops_... token you copied
5. Click Save

---

​

Step 4: Enable the 1Password scripts in ConfigView

1. Go to: https://{companyname}.configview.com/admin/cron/
2. You should see 1password in the list of available apps
3. Select the scripts you want to run. Each script depends on a specific credential — enable only what you have:

4. Click Save

Note: Group Members depends on Groups; Vault Items / Vault Users / Vault Groups all depend on Vaults. ConfigView wires these dependencies automatically — parent scripts always run first.

---

​

Step 5: Verify

1. Go to: https://{companyname}.configview.com/admin/status/
2. Run the 1Password health check
3. The corresponding sections should pass for whichever credentials you configured:
   • Events API: secret + token introspection
   • SCIM Bridge: secret + /Users and /Groups endpoints
   • Service Account: secret + op whoami

If a check fails:

• Events API 401 Unauthorized — Token expired or revoked. Re-issue from Part 1 Step 1 and update the OP_EVENTS_TOKEN secret.
• SCIM Bridge connection refused — OP_SCIM_URL is wrong, or your SCIM Bridge is not reachable from the ConfigView satellite. Confirm the URL in a browser first.
• Service Account op binary not found — The op CLI is not installed on the satellite. Contact your ConfigView administrator (or support) to install it. The Events and SCIM scripts do not require the op binary.
• Service Account service account not authorized for this vault — Grant the service account access to that vault in 1Password (Part 3 Step 1), or accept that the vault will not appear in the inventory.

---

​

Data Tables

Once the scripts run, the corresponding tables will be created in your database. All tables include a run_at column for historical tracking.