1Password Connection

Setup 1Password Connect Server

If you already have a Connect Server for your vault you may skip this step.

1. Input a name for your Connect Server
2. Click "Choose Vaults" and select the vaults you want to connect
3. For each selected vault, click Edit Access and Enable All
4. Click "Add Environment"

1. Input a name and expiration for the token
2. Click "Choose Vaults" and select the vaults you want to connect
3. For each selected vault, click Edit Access and Enable All
4. Click "Issue Token"

Download the Credentials File and set up your Connect Server.

Follow this guide to deploy a Connect Server.

Make sure to save the Access Token for later use.

Create 1Password Connection in Hanzo KMS

In your Hanzo KMS dashboard, navigate to the Integrations tab in the desired project, then select App Connections.

Click the + Add Connection button and select the 1Password Connection option from the available integrations.

Complete the 1Password Connection form by entering:

• A descriptive name for the connection
• An optional description for future reference
• The URL at which your 1Password Connect Server instance is hosted
• The Access Token from earlier steps

After clicking Create, your 1Password Connection is established and ready to use with your Hanzo KMS project.

To create an 1Password Connection, make an API request to the Create 1Password Connection API endpoint.

Sample request

curl    --request POST \
        --url https://app.kms.hanzo.ai/api/v1/app-connections/1password \
        --header 'Content-Type: application/json' \
        --data '{
            "name": "my-1password-connection",
            "method": "api-token",
            "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
            "credentials": {
                "instanceUrl": "https://1pass.example.com",
                "apiToken": "<YOUR-API-TOKEN>"
            }
        }'

Sample response

{
  "appConnection": {
      "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
      "name": "my-1password-connection",
      "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
      "description": null,
      "version": 1,
      "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
      "createdAt": "2025-04-23T19:46:34.831Z",
      "updatedAt": "2025-04-23T19:46:34.831Z",
      "isPlatformManagedCredentials": false,
      "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
      "app": "1password",
      "method": "api-token",
      "credentials": {
        "instanceUrl": "https://1pass.example.com"
      }
  }
}