Skip to main content
This feature is only available as part of 1Password Unlock with SSO.
If your 1Password administrator has set up 1Password Unlock with SSO, you can sign in to 1Password CLI with your identity provider. If the 1Password account you sign in to with SSO doesn’t allow biometric unlock, you’ll be prompted to allow 1Password CLI access to the 1Password app when you sign in.

Requirements

Before you start, you’ll need to:
  1. Join your team, or switch to unlock with SSO.
  2. Install the latest version of 1Password for Mac, Windows, or Linux.
  3. Sign in to 1Password for Mac, Windows, or Linux using SSO.
  4. Install the latest Password CLI build.
Installing inside WSL? The desktop app integration authenticates over a local connection to the 1Password app on your Windows host, so it isn’t available to a CLI binary installed inside the Linux side of WSL. Install 1Password CLI on Windows, then call the Windows op.exe from your WSL shell (or add it to your WSL PATH) — the same approach used by the 1Password SSH agent WSL integration.

Step 1: Connect 1Password CLI with the 1Password app

To turn on the app integration and set up 1Password CLI to authenticate with your identity provider:
  1. Open and unlock the 1Password app.
  2. Select your account or collection at the top of the sidebar.
  3. Navigate to Settings > Developer. Open Developer settings if 1Password is installed on this device.
  4. Select Integrate with 1Password CLI.
  5. If you want to authenticate 1Password CLI with your fingerprint, turn on Touch ID in the app.

Step 2: Sign in with SSO

Once the 1Password app integration is turned on, open the terminal and type op signin. Use the arrow keys to select your SSO-enabled account from the list of all accounts added to your 1Password app. 1Password CLI will prompt you to authenticate.
After you sign in for the first time, 1Password CLI will automatically sign in to your most recently used account. If you want to sign in to a different account, you can use the --account flag or an environment variable.

Troubleshooting

  • Prompted for a Secret Key instead of SSO? This means the CLI is trying to sign in directly instead of through the app integration. Confirm the app integration is turned on (Step 1), then try again.
  • If the account doesn’t allow biometric unlock, you’ll be prompted to allow 1Password CLI access to the 1Password app the first time you sign in instead of using your fingerprint.
  • Managed devices: your organization’s administrator controls who has 1Password Unlock with SSO turned on. If you don’t see the option, check with your administrator.

Get help

If something isn’t working, join the discussion in our Developer community or ask in Developer Slack.

Learn more