> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 1Password

> Connect your 1Password account to Oleria to continuously discover non-human identities, vault access, and activity across your secrets manager.

Connect 1Password to Oleria to inventory the credential-bearing items your team stores in vaults — API keys, passwords, SSH keys, and database credentials — and the activity they generate. Oleria reads this data through 1Password's Service Accounts and Events Reporting APIs, mapping non-human identities (NHIs) to the vaults they reside in and to sign-in and item-usage activity. This page walks through generating both credentials in 1Password and connecting them to your Oleria workspace.

## What Oleria discovers

Once connected, Oleria continuously discovers and maps the following from your 1Password account:

* **Non-human identities (NHIs)** - credential-bearing items in your vaults — API keys, passwords, SSH keys, and database credentials stored in 1Password.
* **Resource instances** - the vaults in your 1Password account, the items they contain, and the access grants tied to each vault.
* **Activities** - audit events, sign-in attempts, and item usage reported through 1Password's Events Reporting API.

<Note>
  Oleria authenticates to 1Password using a Service Account (created in the steps below), but the NHIs it discovers are credential-bearing vault items — not the Service Account itself. 1Password's Events Reporting API is scoped to account-wide activity, not individual user profiles.
</Note>

## Prerequisites

* 1Password administrator access, to create a Service Account and an Events Reporting API token.
* Your 1Password Events Reporting region (United States, Europe, or Canada) - you'll need this when connecting in Oleria.

## Create a Service Account in 1Password

<Steps>
  <Step title="Open the Service Account wizard">
    Sign in to 1Password as an administrator, select **Developer** in the sidebar, then open the **Directory** tab. Under **Access Tokens**, select **Service Account**.

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-1.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=5f8f918361c58fda1dc2dce178bfbea4" alt="1Password Developer Directory tab with the Access Tokens section and the Service Account card" width="800" height="418" data-path="images/integrations/1password/step-1.png" />
  </Step>

  <Step title="Name the service account">
    Enter a descriptive name, for example `OleriaAccount`, then select **Next**.

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-2.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=4ee7b1824a3ba7aa4431667e14639708" alt="Create a Service Account wizard with the service account name field filled in" width="800" height="418" data-path="images/integrations/1password/step-2.png" />
  </Step>

  <Step title="Grant vault access">
    Select all the vaults you want Oleria to inventory and set **Read** access for each, then select **Next**.

    <Note>
      Leave **Allow creation of new vaults** unchecked - Oleria only needs read access to inventory existing vaults.
    </Note>

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-3.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=fd2991fe69bd55ed3db7af688d44d6c4" alt="Create a Service Account wizard Vault access step with the Choose vaults section" width="800" height="418" data-path="images/integrations/1password/step-3.png" />
  </Step>

  <Step title="Grant environment access">
    If the wizard shows an **Environment access** step, you can leave it unselected and select **Next** — Oleria doesn't use Environments.
  </Step>

  <Step title="Save the token">
    Select **Create Account**, then copy the generated authorization token immediately, or select **Save in 1Password** to store it in a vault.

    <Warning>
      1Password shows the Service Account token only once. Store it securely - if you lose it, you must create a new Service Account and update the integration in Oleria.
    </Warning>
  </Step>
</Steps>

## Create an Events Reporting API token in 1Password

<Steps>
  <Step title="Open Events Reporting">
    Select **Integrations** in the sidebar. In the **Events Reporting** section, select **Other**, since Oleria isn't a listed SIEM platform.

    <Note>
      If your account already has integrations configured, selecting **Integrations** may open directly to a **Directory** view instead.
    </Note>

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-4.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=80167230108bfc25aec7c955806f670b" alt="1Password Integrations page with the Events Reporting section and the Other option" width="800" height="418" data-path="images/integrations/1password/step-4.png" />
  </Step>

  <Step title="Name the integration">
    Enter a descriptive name, for example `OleriaEventReporter`, then select **Add Integration**.

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-5.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=b136932f8b038634132b8806c7978d5f" alt="Events Reporting wizard with the System Name field filled in" width="800" height="418" data-path="images/integrations/1password/step-5.png" />
  </Step>

  <Step title="Configure the token">
    Enter a **Token Name**, set **Expires After** (30, 90, 180 days, or **Never**), then turn on all three **Events to Report** toggles - **Sign-in attempts**, **Item usage events**, and **Audit events**. Select **Issue Token**.

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-6.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=d6def984031561676ffd04f69ff8f97b" alt="Events Reporting Set up token step with Sign-in attempts, Item usage events, and Audit events toggled on" width="800" height="418" data-path="images/integrations/1password/step-6.png" />
  </Step>

  <Step title="Save the token">
    Copy the generated token immediately, or select **Save in 1Password** to store it securely.

    <Warning>
      1Password shows the Events API token only once. Store it securely - if you lose it, you must create a new token and update the integration in Oleria.
    </Warning>
  </Step>

  <Step title="Note your Events Reporting region">
    Confirm which region your 1Password account reports events from - United States, Europe, or Canada. You'll select this region when connecting in Oleria.
  </Step>
</Steps>

## Connect 1Password to Oleria

<Steps>
  <Step title="Open the integration">
    Go to your Oleria workspace, select **Integrations** -> select **1Password**.
  </Step>

  <Step title="Complete the connection form">
    Select **Continue** and fill in the connection form:

    | Field                 | Notes                                                                                               |
    | :-------------------- | :-------------------------------------------------------------------------------------------------- |
    | Service Account Token | Required. The Service Account token you generated in 1Password.                                     |
    | Events API Token      | Required. The Events Reporting API token you generated in 1Password.                                |
    | Events Region         | Required. Your 1Password Events Reporting region - United States (us), Europe (eu), or Canada (ca). |

    <img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-7.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=27f20c243c1016290aff5aac2ccd60ec" alt="Oleria Connect with 1Password panel with the Service Account Token and Events API Token entered and Europe (eu) selected as the Events Region" width="800" height="418" data-path="images/integrations/1password/step-7.png" />
  </Step>

  <Step title="Save the integration">
    Select **Authenticate** to validate and save the integration. Oleria checks both tokens against 1Password before saving.
  </Step>
</Steps>

## Verify the integration

Confirm the 1Password instance appears in your Oleria workspace's connected integrations. After the first sync completes, you can review the discovered credential items, vault access, and activity in your Oleria workspace.

<img src="https://mintcdn.com/oleria/Uo61GapyLNpiFqql/images/integrations/1password/step-8.png?fit=max&auto=format&n=Uo61GapyLNpiFqql&q=85&s=a5fe8c235fc394a2d3b618e3e9c3904a" alt="Oleria workspace Connected integrations tab showing the 1Password integration" width="800" height="413" data-path="images/integrations/1password/step-8.png" />

<Note>
  If you rotate either credential, edit the integration in Oleria, paste the new token, and select **Update**. The next sync runs with the new credentials.
</Note>

## Contact us

For questions about this integration, contact us at [support@oleria.com](mailto:support@oleria.com).
