1Password CLI

1Password CLI は、1Password の Vault と開発者向けシークレットをターミナルにもたらします。op コマンドは、スクリプトに認証情報をハードコーディングすることなく、制御された認証情報へのアクセスを必要とする開発者、管理者、自動化を対象としています。

主な機能

• コマンドライン コマンドを使用して Vault とアイテムを検索および管理します。
• op:// 参照を通じてシークレットを読み取り、op run で子プロセスに読み込むか、op inject で構成テンプレートに代入します。
• 1Password デスクトップ アプリを通じて認証します（サポートされている生体認証を含む）。または、ヘッドレス自動化のために、選択した Vault または Environments にスコープされたサービス アカウント トークンを使用します。
• Bash、Zsh、Fish 用のシェル補完を生成します。別個の 1Password Shell Plugins が、サポートされているサードパーティ開発ツールとの認証を統合します。

インストールと初回使用

macOS では、brew install --cask 1password-cli でこの Homebrew cask をインストールし、op --version を確認します。Homebrew は op を自身のバイナリ ディレクトリにリンクし、シェル補完を生成します。デスクトップ認証では、1Password デスクトップ アプリをインストールしてサインインし、Settings → Developer → Integrate with 1Password CLI を有効にしてから、op vault list を試します。複数のアカウントがある場合、op signin でアカウントを選択します。サービス アカウントは、共有ビルドおよびヘッドレス サーバー向けの推奨される代替手段です。自動化に必要なアクセスのみを構成してください。

システム、依存関係、競合

公式の macOS 入門ガイドでは、macOS Big Sur 11 以降と Bash、Zsh、sh、Fish を指定しています。公式ダウンロードは Apple Silicon および Intel Mac をサポートします。Windows および Linux ビルドは別途提供されています。Windows のドキュメントでは PowerShell を使用します。Linux デスクトップ統合には、1Password for Linux、PolKit、および実行中の PolKit 認証エージェントが必要です。デスクトップ アプリ統合には、対応するインストール済みの 1Password アプリと、資格のあるサインイン済みアカウントが必要です。これはサービス アカウント認証とは異なります。このカタログ エントリは、デスクトップ アプリではなく macOS CLI をインストールします。Homebrew は、この cask に対して追加の formula 依存関係を宣言しておらず、1password-cli@1 および 1password-cli@beta との競合を宣言しています。これらの代替 cask も op を提供するため、これと併せてインストールしないでください。

アカウント、費用、ライセンス

個人用 Vault を使用するには、1Password アカウントとサブスクリプションが必要です。サービス アカウント アクセスは、アカウントで利用可能な機能と権限によって異なります。サブスクリプション プラン、トライアル、およびビジネス条件は 1Password によって定義されます。CLI は、1Password の適用される条件の下で配布されるプロプライエタリ ソフトウェアです。別個のオープンソース Shell Plugins プロジェクトは、完全な CLI のライセンスを規定するものではありません。完全な CLI の公開ソース リポジトリは確認されていません。

op run の出力マスキングはベスト エフォートであり、シークレットが隠蔽されることを保証しません。シークレットのログ記録や、生成されたシークレットを含むファイルのコミットは避けてください。

公式リファレンス: CLI の概要、はじめに、リリース ノート、および利用規約。