# 1Password

1Password is a password manager and enterprise credential vault that protects against credential theft, account takeover, and shadow IT. Connecting 1Password forwards sign-in attempts, item usage events, and audit events to Radiant Security via the 1Password Events API. Radiant uses this telemetry to surface credential misuse, anomalous vault access, and risky sign-in patterns during AI triage.

### Prerequisites

* [ ] Owner or Admin role in 1Password
* [ ] Administrator role in Radiant Security

### Issue an Events API token in 1Password

For vendor instructions, refer to 1Password's [Events API documentation](https://developer.1password.com/docs/events-api/).

{% stepper %}
{% step %}

#### Open the Integrations page

Sign in to the 1Password web app as an Owner or Admin. In the left sidebar, click **Integrations**. In the **Integrations** list, select **Other**.
{% endstep %}

{% step %}

#### Add an integration and name the token

Click **Add Integration**. Enter an identifiable name for the integration (e.g., `RadiantSecurity`), then enter an identifiable name for the token (e.g., `RadiantSecurityDataConnector`).
{% endstep %}

{% step %}

#### Grant event permissions

Grant the token permission to access the following event types:

* `auditevents`
* `itemUsages`
* `sign-in attempts`
  {% endstep %}

{% step %}

#### Issue and save the token

Click **Issue Token**, then click **Save in 1Password** and choose a vault to store the token in. Copy the token value: you will paste it into Radiant in the next section.

{% hint style="warning" %}
The token is shown only once at issuance. Save it to a 1Password vault before leaving this page.
{% endhint %}

Note the **Base URL** for your 1Password environment. You will need it in the next section.

| 1Password environment      | Base URL                           |
| -------------------------- | ---------------------------------- |
| 1Password.com (Business)   | `https://events.1password.com`     |
| 1Password.com (Enterprise) | `https://events.ent.1password.com` |
| 1Password.ca               | `https://events.1password.ca`      |
| 1Password.eu               | `https://events.1password.eu`      |
| {% endstep %}              |                                    |
| {% endstepper %}           |                                    |

### Add the data connector in Radiant Security

1. Sign in to [Radiant Security](https://app.radiantsecurity.ai/).
2. From the navigation menu, select **Settings** > **Data Connectors** and click **+ Add Connector**.
3. Search for and select **1Password**, then click **Data Feeds**.
4. Under **Select your data feeds**, select **1Password** and click **Credentials**.
5. Under **Credential Name**, enter a descriptive name (e.g., `1Password API`).
6. In the **Base URL** field, enter the URL that corresponds to your 1Password environment.
7. In the **API Token** field, paste the token you issued in 1Password.
8. Click **Add Connector** to save the configuration.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.radiantsecurity.ai/radiant-connectors/data-connectors/1password.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
