1Password collector

Overview

The 1Password collector pulls data from the 1Password Events API and forwards to Devo.

Devo collector features

Feature	Details
Allow parallel downloading (`multipod`)	`not allowed`
Running environments	`collector server`
Populated Devo events	`standard`

Data sources

Source	Description	API Path	Collector Service Name	Devo Table	Available from release
Item Usage	Returns information about items in shared vaults that have been modified, accessed, or used. Events include the name and IP address of the user who accessed the item, when it was accessed, and the vault where the item is stored.	`/api/v1/itemusages`	`item_usage`	`TBD`	`v1.0.0`
Sign-in Attempts	Returns information about sign-in attempts. Events include the name and IP address of the user who attempted to sign in to the account, when the attempt was made, and -- for failed attempts -- the cause of the failure.	`/api/v1/signinattempts`	`sign_in_attempts`	`TBD`	`v1.0.0`

Vendor setup

Generate a bearer token

To issue a bearer token:

Sign in to your account on Password Manager for Families, Businesses, Teams | 1Password and click Integrations in the sidebar.
Choose the Events Reporting integration where you want to issue a token and click “Add a token”.
Enter a name for the bearer token and choose when it will expire. Select or deselect the event types the token has access to, then click Issue Token.
Click Save in 1Password and choose which vault to save your token to. Then click View Integration Details.

Additional Information: Get started with 1Password Events Reporting | issue or revoke bearer tokens

Identify Your 1Password server

The URL of the server that hosts your 1Password account is required in order to make requests to the 1Password Events API.

If your account is on:	Your Events API URL is:
Password Manager for Families, Businesses, Teams \| 1Password	`https://events.1password.com` (1Password Business) `https://events.ent.1password.com` (1Password Enterprise)
Pricing & free trial \| 1Password	`https://events.1password.ca`
European pricing & free trial \| 1Password	`https://events.1password.eu`

Additional Information: Get started with 1Password Events Reporting | Servers

Minimum configuration required for basic pulling

Although this collector supports advanced configuration, the fields required to retrieve data with basic configuration are defined below.

This minimum configuration refers exclusively to those specific parameters of this integration. There are more required parameters related to the generic behavior of the collector. Check setting sections for details.

Setting	Details
`base_url`	The URL of the server that hosts your 1Password account
`token`	Access token created in the 1Password console.

See the Accepted authentication methods section to verify what settings are required based on the desired authentication method.

Run the collector

We use a piece of software called Collector Server to host and manage all our available collectors. If you want us to host this collector for you, get in touch with us and we will guide you through the configuration.