/onepassword-keyring

Implementation of 1Password as keyring backend

Primary LanguagePythonOtherNOASSERTION

OnePassword Keyring

Implementation of the Keyring backend code reading secrets from 1Password using 1password-cli.

Overview

The Keyring python package provides a handy single point of entry for any secret holding system.

This projects allows Keyring to read secrets from 1Password, a multiplatform cloud password manager. It is based on and forked from bitwarden-keyring by ewjoachim.

This backend assumes that it will be used in the context of a CLI application, and that it can communicate with the user using sdtin, stdout and stderr.

Requirements

This project uses the official 1Password CLI. You will need to install it and configure it before using this backend.

Installation and configuration

pip install onepassword-keyring

Usage

Use as a normal keyring backend. It is installed with priority 10 so it's likely going to be selected first.

onepassword-keyring will automatically ask for credentials when needed.

Caveats

This fork was made for personal use and is not guaranteed to work in all cases. Please use with caution, as I can't take responsibility for any issues that may arise from using this package.

onepassword-keyring was only tested with:

  • macOS, using the 1password-cli from brew

As mentioned, onepassword-keyring only works in the context of a CLI application with access to standard inputs and output.

Licensing

onepassword-keyring is published under the terms of the MIT License.

Acknowledgment

This package is forked from and heavily based on bitwarden-keyring by ewjoachim