> For the complete documentation index, see [llms.txt](https://manual.dxable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.dxable.com/1password/use-1password-to-securely-authenticate-upstash-cli.md).

# 1PasswordでUpstash CLIを安全に認証する

### **1PasswordでUpstash CLIを安全に認証する** <a href="#mz7e3two8dv8" id="mz7e3two8dv8"></a>

Upstash CLIシェルプラグインを使うと、1Passwordを使用して[Upstash CLI](https://github.com/upstash/cli)を安全に認証できます。資格情報をプレーンテキストでSaveするのではなく、指紋、Apple Watch、またはシステム認証を使用してSaveします。

指示に従ってデフォルトの資格情報を設定し、plugins.shファイルを入手すると、生体認証を使用して Upstash CLI を認証するように求められます。

### 必要条件 <a href="#l9exukn9v1cb" id="l9exukn9v1cb"></a>

* ①1Passwordに[サインアップしてください。](https://1password.com/pricing)
* ②[Mac](https://support.1password.com/get-the-apps/?mac)または[Linux](https://support.1password.com/get-the-apps/?linux)用の 1Password 8 をインストールしてサインインします。
* ③[1Password CLI](https://app-updates.agilebits.com/product_history/CLI2) 2.22.0 以降をインストールします。 1Password CLI を既にインストールしている場合は、[インストールを更新する](https://developer.1password.com/docs/cli/reference/update/)方法を確認してください。
* ④[1Password CLI を 1Password アプリに接続します](https://developer.1password.com/docs/cli/app-integration/)。
* ⑤[Upstash CLI をインストールします。](https://github.com/upstash/cli)

次のシェルがサポートされています:

* Bash
* Zsh
* fish

### **ステップ 1: デフォルトの資格情報** <a href="#un8tkfbzr7il" id="un8tkfbzr7il"></a>

Upstash CLIシェル プラグインを使い始めるには:

* ①Upstash CLIプラグインで使う 1Password アカウントにサインインします。
* $ op signin
* ②特定のディレクトリでのみプラグインを設定したい場合は、そのディレクトリに変更します。
* ③プラグインを設定するには、次のコマンドを実行します。
* $ op plugin init upstash

Upstash CLI の認証情報を 1Passwordにインポートするか、認証情報がSaveされている保存済みの 1Password 項目を選択して、認証情報をいつ使うかを設定するように求められます。

#### **ステップ 1.1: アイテムをインポートまたは選択する** <a href="#a4i5297ghsrk" id="a4i5297ghsrk"></a>

**新しいアイテムをインポートする**

Upstash CLI の認証情報を 1PasswordにまだSaveしていない場合は、**Import into 1Password**を選択します。認証情報を入力し、新しい 1Password アイテムの名前を選択して、Save先の保管庫を選択します。

1Password がローカル開発環境で資格情報を検出すると、自動的にインポートするように求められます。

**保存済みのアイテムを選択**

Upstash CLI の認証情報を 1Passwordに既にSaveしている場合は、**Search in 1Password**を選択します。

関連するアイテムとそれらがSaveされている保管庫のリストが表示されます。資格情報が表示されない場合は、**Expand search**を選択して、アカウント内の全てのアイテムを参照します。

#### **ステップ 1.2: デフォルトの資格情報スコープを設定する** <a href="#rgj7v67w531a" id="rgj7v67w531a"></a>

資格情報を選択またはインポートすると、 Upstash CLI の認証にその項目をいつ使うかを設定するように求められます。

* **"Prompt me for each new terminal session"**&#x3092;選択すると、現在のターミナル セッションの期間中のみ資格情報が設定されます。ターミナルを終了すると、デフォルトは削除されます。
* **"Use automatically when in this directory or subdirectories"**&#x3092;選択すると、他のディレクトリ固有のデフォルトが設定されていない限り、現在のディレクトリとその全てのサブディレクトリで資格情報がデフォルトになります。ターミナル セッションのデフォルトは、ディレクトリ固有のデフォルトよりも優先されます。
* **"Use as global default on my system"**&#x3092;選択すると、資格情報が全てのターミナル セッションとディレクトリのデフォルトとして設定されます。ディレクトリ固有のデフォルトは、グローバル デフォルトよりも優先されます。

### **ステップ2: plugins.shファイルをsource化** <a href="#id-7g8wo99wxfob" id="id-7g8wo99wxfob"></a>

プラグインを使用できるようにするには、plugins.shファイルをソース化します。例:

$ source \~/.config/op/plugins.sh

フォルダーのファイル パスは、構成[ディレクトリ](https://developer.1password.com/docs/cli/config-directories/)opによって異なる場合があります。op plugin initは正しいファイル パスを含むソース コマンドを出力します。

シェル プラグインを初めてインストールする場合は、現在のターミナル セッションを超えてプラグインを永続化するために、RC ファイルまたはシェル プロファイルに source コマンドを追加する必要があります。例:

* Bash

$ echo "source \~/.config/op/plugins.sh" >> \~/.bashrc && source \~/.bashrc

* Zsh

$ echo "source \~/.config/op/plugins.sh" >> \~/.zshrc && source \~/.zshrc

* fish

$ echo "source \~/.config/op/plugins.sh" >> \~/.config/fish/config.fish && source \~/.config/fish/config.fish

### &#x20;<a href="#id-71i60n11ycfq" id="id-71i60n11ycfq"></a>

### **ステップ3: CLIを使用する** <a href="#gdqjy6rgymah" id="gdqjy6rgymah"></a>

次回Upstash CLIでコマンドを入力するときに、生体認証またはシステム認証による認証を求めるメッセージが表示されます。

### **ステップ4: インポートした資格情報をdiskから削除** <a href="#mpul20nahe3x" id="mpul20nahe3x"></a>

Upstash CLI認証情報を 1PasswordにSaveしたら、以前にディスクにSaveした全てのローカル コピーを削除できます。

### **次のステップ** <a href="#id-1se29v59wb8i" id="id-1se29v59wb8i"></a>

1Password Shell プラグインは[60 を超えるサードパーティの CLI を](https://developer.1password.com/docs/cli/shell-plugins/#get-started)サポートしています。サポートされている CLI のリストを表示するには:

$ op plugin list

別のプラグインを選択して開始するには:

$ op plugin init

シームレスなコンテキスト切り替えのためにシェル プラグインを使うには、[複数の環境](https://developer.1password.com/docs/cli/shell-plugins/environments/)または[複数のアカウント](https://developer.1password.com/docs/cli/shell-plugins/multiple-accounts/)でプラグインを構成する方法を学習します。

### **ヘルプを受ける** <a href="#id-8c7jmlb9y2wq" id="id-8c7jmlb9y2wq"></a>

#### **設定を検査する** <a href="#s6bctpgq839v" id="s6bctpgq839v"></a>

現在のUpstash CLI構成を検査するには:

$ op plugin inspect upstash

1Password CLI は、 Upstash CLIで使うために設定した資格情報とそのデフォルト スコープのリスト、およびUpstash CLI用に設定されたエイリアスのリストを返します。

#### **資格情報を消去する** <a href="#zh0imfwy34t4" id="zh0imfwy34t4"></a>

Upstash CLIで使用される資格情報をリセットするには:

$ op plugin clear upstash

次の優先順位に従って、一度に 1 つの構成をクリアできます。

* ①ターミナルセッションのデフォルト
* ②ディレクトリのデフォルト、現在のディレクトリから$HOME
* ③グローバルデフォルト

例えば、ディレクトリ内にいて$HOME/projects/awesomeProject、ターミナル セッションのデフォルト、$HOMEおよびのディレクトリのデフォルト$HOME/projects/awesomeProject、およびグローバル デフォルトの資格情報が構成されている場合、全てのデフォルトをクリアするには op plugin clear upstashを 4 回実行する必要があります。

グローバル デフォルト資格情報、ターミナル セッション デフォルト、および現在のディレクトリのデフォルトを同時にクリアするには、op plugin clear upstash --allを実行します。

### **参照** <a href="#ugbe1g4rqho5" id="ugbe1g4rqho5"></a>

1Password は、プラグイン コマンドに必要な資格情報を 1Password アカウントから直接環境変数に挿入することで、Upstash CLIで認証します。

新しいアイテムをインポートするためにop pluginを使用するのではなく、Upstash CLI認証情報を 1Passwordに手動でSaveした場合は、フィールド名が以下の表と一致していることを確認してください。

アイテムに必要な名前のフィールドが含まれていない場合は、保存済みのフィールドのいずれかの名前を変更するように求められます。

| 1Password**フィールド名** | **環境変数**          |
| ------------------- | ----------------- |
| API Key             | UPSTASH\_API\_KEY |
| Email               | UPSTASH\_EMAIL    |

[*このプラグインを提供してくれた*](https://github.com/1Password/shell-plugins/pull/316)*@siddhikhapare*[*に*](https://github.com/siddhikhapare)*感謝します。*[*独自のシェル プラグインを構築する*](https://developer.1password.com/docs/cli/shell-plugins/contribute)*方法を学びましょう。*