1password
Visualize 1Password audit logs, vaults, and user activities in the JupiterOne graph. Track audit events, item usage, sign-in attempts, and secrets, and map users to their associated actions and vaults. Monitor changes and unusual behavior through custom queries and alerts.
- Installation
- Authorization
- Data Model
- Types
- Release Notes
1Password Integration Installation in JupiterOne
Overview
This guide walks you through how to connect your 1Password Business or Enterprise account with JupiterOne to monitor and manage your security data.
The integration pulls data from 1Password using two components:
- Events API — retrieves security-related activity (sign-ins, item access, audit events) and sends it to JupiterOne.
- Connect Server — allows JupiterOne to read vault and item information from your 1Password account.
Prerequisites
- A 1Password Business account.
- Owner or Administrator access in 1Password (required to generate tokens).
- Access to JupiterOne with permission to configure integrations.
Set Up in 1Password
You will generate two tokens: one for the Events API and one for the Connect Server.
Generate an Events API Token
This token lets JupiterOne collect audit events, item usage events, and sign-in attempt events.
- Sign in to your account at 1password.com.
- Check the URL to identify your region. For example, if your account is at
https://my.1password.com, your region is1password.com. - In the sidebar, select Integrations.
- On the Integrations page, select the Directory tab.
- In the Events Reporting section, choose your SIEM connector. If JupiterOne is not listed, select Other.
- Enter a name for the integration and select Add Integration.
- Configure the bearer token:
- Token Name: enter a name (for example, "JupiterOne Events").
- Expires After: optionally set an expiry.
- Events to Report: enable all three event types — sign-in attempts, item usage events, and audit events.
- Select Issue Token. Copy the token and save it securely — you will need it in JupiterOne.
Based on your region, use the corresponding Events API Base URL:
| Region | Base URL |
|---|---|
1password.com | https://events.1password.com |
ent.1password.com | https://events.ent.1password.com |
1password.ca | https://events.1password.ca |
1password.eu | https://events.1password.eu |
Generate a Connect Server Token
The Connect Server lets JupiterOne access vaults and items. You must deploy a 1Password Connect Server in your own infrastructure first.
What is a Connect Server?
A lightweight 1Password service you run in your own infrastructure. It exposes a REST API that JupiterOne calls to read vault contents.
- Sign in to your account at 1password.com.
- Go to Developer in the left navigation.
- Open the Connect Servers tab and select New Connect Server.
- Enter a name for the server (for example, "JupiterOne").
- Select Add Vaults and choose the vaults this server should be able to read.
- Select Add Environment.
- Configure the access token:
- Token Name: enter a name (for example, "JupiterOne Connect").
- Expires After: optionally set an expiry.
- Select the vaults this token should access.
- Select Issue Token. Copy the token and save it securely.
- Follow the 1Password Connect Server deployment guide to deploy the Connect Server in your infrastructure and obtain its Base URL.
Data Volume Configuration
Control how much historical data is ingested from 1Password.
Ingestion Windows
| Field | Description | Default | Options |
|---|---|---|---|
| Reporting Event Historical days | Number of days of past event data to ingest. Increasing this value ingests more events and increases data volume in JupiterOne. | 30 | 30, 60, 90, 120 |
Configure Integration in JupiterOne
-
In JupiterOne, go to Integrations in the left navigation.
-
Find and select the 1Password integration tile.
-
Select Add Configuration and complete the fields:
Field Description Reporting Event Access Token The Events API bearer token you generated above. Reporting Event Base Url The Events API base URL for your region (see table above). Connect Server Base Url The URL where your Connect Server is running. Optional — omit if you are not using the Connect Server. Connect Server Access Token The Connect Server bearer token you generated above. Optional — required only if you provide a Connect Server Base Url. -
Select Create Configuration to save.
JupiterOne will begin pulling data from 1Password on the polling interval you configure.
Next Steps
Now that your integration instance is configured, it will run on the polling interval you set, populating data in JupiterOne. See the Instance management guide to learn more about working with integration instances.
Permissions
IAM permissions that must be granted to the integration principal for data ingestion.
Show Permissions (3)
auditeventsitemusagessigninattempts
Endpoints
API endpoints that the integration makes requests to.
Show Endpoints (14)
https://events.1password.ca/api/v2/auditeventshttps://events.1password.ca/api/v2/itemusageshttps://events.1password.ca/api/v2/signinattemptshttps://events.1password.com/api/v2/auditeventshttps://events.1password.com/api/v2/itemusageshttps://events.1password.com/api/v2/signinattemptshttps://events.1password.eu/api/v2/auditeventshttps://events.1password.eu/api/v2/itemusageshttps://events.1password.eu/api/v2/signinattemptshttps://events.ent.1password.com/api/v2/auditeventshttps://events.ent.1password.com/api/v2/itemusageshttps://events.ent.1password.com/api/v2/signinattempts{onePasswordConnectServerBaseUrl}/v1/vaults{onePasswordConnectServerBaseUrl}/v1/vaults/{vaultId}/items
Licenses
Product licenses or SKUs required in the target environment.
Show Licenses (1)
1Password Business
Documentation Links
Links to provider documentation relevant to setup and configuration.
Show Documentation Links (4)
Per-Step Breakdown
Detailed authorization requirements for each ingestion step.
Show all steps (6)
| Step | Endpoints | Licenses |
|---|---|---|
| Fetch Audit Event Actor Details | - | - |
| Fetch Audit Event Aux Details | - | - |
| Fetch Audit Event Object Details | - | - |
| Fetch Item Usage Users | - | - |
| Fetch Secrets | {onePasswordConnectServerBaseUrl}/v1/vaults/{vaultId}/items | 1Password Business |
| Fetch Signin Attempt Target Users | - | - |
Entities
The following entities are created:
| Resources | Entity _type | Entity _class |
|---|---|---|
| Audit Event | one_password_audit_event | Record |
| Audit Event Actor Details | one_password_audit_event_actor_details | User |
| Audit Event Aux Details | one_password_audit_event_aux_details | User |
| Audit Event Object Details | one_password_audit_event_object_details | User |
| Item Usage Event | one_password_item_usage_event | Record |
| Item Usage User | one_password_item_usage_user | User |
| Secret | one_password_secret | Secret, NHI |
| Signin Attempt Event | one_password_signin_attempt_event | Record |
| Signin Attempt Target User | one_password_signin_attempt_target_user | User |
| Vault | one_password_vault | Vault |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
|---|---|---|
one_password_audit_event | UPDATED | one_password_audit_event_aux_details |
one_password_audit_event | UPDATED | one_password_audit_event_object_details |
one_password_audit_event_actor_details | PERFORMED | one_password_audit_event |
one_password_audit_event_actor_details | PERFORMED | one_password_vault |
one_password_item_usage_user | PERFORMED | one_password_item_usage_event |
one_password_signin_attempt_target_user | PERFORMED | one_password_item_usage_event |
one_password_vault | HAS | one_password_secret |
One Password Audit Event
one_password_audit_event inherits from Record
| Property | Type | Description | Specifications |
|---|---|---|---|
accountUUID | string | ||
action | string | ||
actorAccountUUID | string | ||
actorType | string | ||
actorUUID | string | ||
auxId | string | ||
auxInfo | string | ||
auxUUID | string | ||
city | string | ||
country | string | ||
latitude | number | ||
longitude | number | ||
objectType | string | ||
objectUUID | string | ||
region | string | ||
sessionDeviceUUID | string | ||
sessionIP | string | ||
sessionLoginOn | number | ||
sessionUUID | string |
One Password Audit Event Actor Details
one_password_audit_event_actor_details inherits from User
| Property | Type | Description | Specifications |
|---|---|---|---|
mspUserAccountId | string | ||
mspUserType | string |
One Password Audit Event Aux Details
one_password_audit_event_aux_details inherits from User
One Password Audit Event Object Details
one_password_audit_event_object_details inherits from User
One Password Item Usage Event
one_password_item_usage_event inherits from Record
| Property | Type | Description | Specifications |
|---|---|---|---|
action | string | ||
appName | string | ||
appVersion | string | ||
city | string | ||
country | string | ||
ipAddress | string | ||
itemUUID | string | ||
latitude | number | ||
longitude | number | ||
mspAccountUUID | string | ||
osName | string | ||
osVersion | string | ||
platformName | string | ||
platformVersion | string | ||
region | string | ||
usedVersion | number | ||
userUUID | string | ||
vaultUUID | string |
One Password Item Usage User
one_password_item_usage_user inherits from User
One Password Secret
one_password_secret inherits from Secret, NHI
| Property | Type | Description | Specifications |
|---|---|---|---|
favorite | boolean | ||
fileNames | array of strings | ||
lastEditedBy | string | ||
sectionLabels | array of strings | ||
vaultId | string | ||
vaultName | string | ||
version | number |
One Password Signin Attempt Event
one_password_signin_attempt_event inherits from Record
| Property | Type | Description | Specifications |
|---|---|---|---|
appName | string | ||
appVersion | string | ||
category | string | ||
city | string | ||
country | string | ||
details | string | ||
ipAddress | string | ||
latitude | number | ||
longitude | number | ||
mspAccountUUID | string | ||
osName | string | ||
osVersion | string | ||
platformName | string | ||
platformVersion | string | ||
region | string | ||
sessionUUID | string | ||
targetUserUUID | string | ||
type | string |
One Password Signin Attempt Target User
one_password_signin_attempt_target_user inherits from User
One Password Vault
one_password_vault inherits from Vault
| Property | Type | Description | Specifications |
|---|---|---|---|
attributeVersion | number | ||
contentVersion | number | ||
description | string | ||
itemsCount | number | ||
type | string |
Release Notes
- 2025-10-01 — Added relationships linking audit event actors to the vaults they performed actions on, enabling vault access activity queries.
- 2025-09-09 — New 1Password integration: ingests audit events, sign-in attempts, and item usage events with actor user relationships; optionally ingests vaults and secrets via the Connect Server API.