> 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/plugin.md).

# プラグイン

### **プラグイン** <a href="#qwa9db121f8r" id="qwa9db121f8r"></a>

シェル プラグインを使うと、CLI 認証情報をプレーンテキストでSaveするのではなく、1Password でサードパーティの CLI を安全に認証できます。プラグインを構成すると、1Password CLI は指紋またはその他のシステム認証オプションを使用してサードパーティの CLI を認証するように要求します。

[シェル プラグインの詳細をご覧ください。](https://developer.1password.com/docs/cli/shell-plugins)

#### [**サブコマンド**](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#subcommands) <a href="#oqqwq1zd0108" id="oqqwq1zd0108"></a>

* [plugin clear](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#plugin-clear) : シェルプラグインの設定をクリアする
* [plugin init](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#plugin-init) : シェルプラグインを設定する
* [plugin examine](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#plugin-inspect) : 保存済みのシェルプラグインの設定を検査する
* [plugin list](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#plugin-list): 利用可能な全てのシェルプラグインを一覧表示します
* [plugin run](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#plugin-run) : 1Passwordから認証情報をプロビジョニングし、このコマンドを実行します

### **plugin clear** <a href="#fwoayin804nh" id="fwoayin804nh"></a>

**保存済み**のシェル プラグイン構成をクリアします。

$ op plugin clear \<plugin-executable> \[flags]

#### **Flags**[**​**](https://developer.1password.com/docs/cli/reference/management-commands/plugin/#plugin-clear-flags) <a href="#onnyd8unz3yf" id="onnyd8unz3yf"></a>

#### &#x20;<a href="#ipjis8f3as1v" id="ipjis8f3as1v"></a>

\--all Clear all configurations for this plugin that apply to this directory

and/or terminal session, including the global default.

-f, --force Apply immediately without asking for confirmation.

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

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

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

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

### **plugin init** <a href="#bnd404wioovo" id="bnd404wioovo"></a>

シェル プラグインを選択してインストールし、デフォルトの資格情報を設定します。Bash、Zsh、fish シェルがサポートされています。

$ op plugin init \[ \<plugin-executable> ] \[flags]

Shell プラグインには[1Password デスクトップ アプリの統合](https://developer.1password.com/docs/cli/shell-plugins/)が必要です。

利用可能な全てのプラグインを表示するには、 op plugin listを実行します。

**Configure your default credentials**

1Password CLI は、サードパーティの CLI で使う資格情報を選択またはインポートするように要求し、 plugins.shファイルをソースにしてプラグイン エイリアスを使用できるようにするコマンドを返します。

現在のターミナル セッションを超えてプラグインを使うには、RC ファイルまたはシェル プロファイルに source コマンド (例: \~/.bashrc、\~/.zshrc、\~/.config/fish/config.fish )を追加してください 。例:

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

**Configuration options**

1Password CLI が設定を記憶するかどうかを選択できます。いずれのオプションを選択しても、資格情報は 1Password アカウントから外部に漏れることはありません。

* 「新しいターミナル セッションごとにプロンプ​​トを表示する」では、現在のターミナル セッションの資格情報のみが設定されます。ターミナルを終了すると、デフォルトは削除されます。
* 「このディレクトリまたはサブディレクトリにいるときに自動的に使う」を選択すると、他のディレクトリ固有のデフォルトが設定されていない限り、現在のディレクトリとその全てのサブディレクトリで資格情報がデフォルトになります。ターミナル セッションのデフォルトは、ディレクトリ固有のデフォルトよりも優先されます。
* 「システム上のグローバル デフォルトとして使用」は、資格情報を全てのターミナル セッションとディレクトリのデフォルトとして設定します。ディレクトリ固有のデフォルトは、グローバル デフォルトよりも優先されます。

### **plugin inspect** <a href="#kg04b6hmw1am" id="kg04b6hmw1am"></a>

**保存済み**のシェル プラグインの構成を検査します。

$ op plugin inspect \[ \<plugin-executable> ] \[flags]

op plugin inspectを実行して、利用可能な全てのプラグインのリストからプラグインを選択したり、op plugin inspect \<plugin-executable>特定のプラグインを検査したりできます。

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

### **plugin list** <a href="#nuq0kpr1m3ll" id="nuq0kpr1m3ll"></a>

利用可能な全てのシェル プラグイン、その使用法、名前、および必須フィールドを一覧表示します。

$ op plugin list \[flags]

シェル プラグインを開始するには、op plugin init \<plugin-usage> を実行します。

### **plugin run** <a href="#n868rntm2nk5" id="n868rntm2nk5"></a>

1Password から資格情報をプロビジョニングし、このコマンドを実行します。

$ op plugin run \<command>... \[flags]

op plugin run1PasswordにSaveされている資格情報を基盤となる CLI に渡し、指定されたコマンドを実行します。デフォルトの資格情報を設定していない場合は、1Password CLI によって資格情報を含む項目を選択するように求められます。

その後、この CLI で自動的に認証され、現在のターミナル セッションでこのプラグインを今後呼び出すときに選択内容が記録されます。

デフォルトの資格情報を構成するには、「op plugin init --help」を参照してください。
