Integrate Postman Vault with 1Password

Postman Vault integrations are available on Postman Enterprise plans.

The 1Password integration is a beta feature.

1Password enables you to store sensitive data in a vault that's external from your Postman Vault. Once your Postman Vault is integrated with 1Password, you can link vault secrets with sensitive data stored in 1Password, and retrieve them when you send HTTP requests.

You can create 1Password integrations from the Canary build of the Postman desktop app if it's enabled for your Enterprise team. Contact your Customer Success Manager or Postman support if you'd like the 1Password integration enabled for your Enterprise team.

Learn more about Postman Vault integrations.

About the 1Password integration

When setting up an integration with 1Password, you need to authenticate with your 1Password account. Then you can link vault secrets with 1Password using the secret reference for each secret.

You can follow the steps to create a vault, add secrets to the vault, and create a service account in 1Password. Make sure the service account has at least read access to the 1Password vaults with secrets you want to link in Postman. You can also follow the steps to copy a secret reference URI from the 1Password desktop app.

To enable the option to copy a secret reference URI, download and install the 1Password desktop app on your computer (version 8 or later). From the 1Password desktop app, integrate with 1Password CLI. If you're using an earlier version of the 1Password desktop app, you must manually construct secret reference URIs.

Integrate with 1Password

When you create the integration, authorize Postman to access and retrieve secrets from 1Password, entering the service token for your 1Password account. Postman uses your service token to authenticate with 1Password, and the service token is valid in Postman forever.

You'll need to reauthenticate with 1Password each time you sign in to Postman.

To integrate with 1Password and authenticate with your 1Password account, do the following:

1. Open your Postman Vault, then select Settings. Optionally, you can create the integration when you add a vault secret.

2. Select Connect next to 1Password Account.

3. You'll be prompted to authorize Postman to access your 1Password account. Enter the Service Account Token on the Authenticate 1Password Account window. This is the encoded service account token that allows you to authenticate with 1Password.

   ops_<encoded-token>
   

4. Select Authenticate.

Link vault secrets with 1Password

Link a vault secret's value with a secret stored in 1Password. This enables you to retrieve a secret stored in 1Password directly from your local instance of Postman. Once you link a vault secret's value, reference the vault secret in your local instance of Postman, and the secret is retrieved from 1Password when you send the HTTP request that references the vault secret.

Secrets retrieved from 1Password aren't stored in your local instance of Postman or the Postman cloud. Learn more about Postman Vault integrations.

To link a secret's value from 1Password, do the following:

1. In Postman, enter a name for the vault secret, hover over the Value cell, then select the vault integration icon .

   

   If you've already integrated with an external vault, you can link a secret from a different external vault provider. Select the change external vault icon , then select an external vault.

2. Enter the Secret Reference URI on the Link secret window The secret reference URI is the URI of the secret in 1Password.

   op://<vault-name>/<item-name>[/<section-name>]/<field-name>
   

3. Select Use.

4. You can reference the vault secret in your local instance of Postman.

To view details about a secret you've retrieved from 1Password, select the vault integration icon next to a secret.

Next steps

After integrating Postman Vault with 1Password, you can reference vault secrets and manage your integrations:

• To learn how to reference vault secrets in your local instance of Postman, see Use vault secrets.
• To learn how to troubleshoot unresolved vault secrets, see Troubleshoot vault secrets.
• To learn how to manage your integrations, see Manage Postman Vault integrations.