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

1Passwordマニュアル｜GitHubシェルプラグインを活用し、1PasswordでGitHub CLIの認証を安全かつ簡単に行う方法をご紹介します。

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

GitHubシェルプラグインを使うと、1Passwordを使用してGitHub CLIを安全に認証できます。資格情報をプレーンテキストでSaveするのではなく、指紋、Apple Watch、またはシステム認証を使用してSaveします。

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

https://developer.1password.com/videos/github.mp4

必要条件

1. 1Passwordにサインアップしてください。

2. MacまたはLinux用の 1Password をインストールしてサインインします。

3. 1Password CLI 2.9.0 以降をインストールします。 1Password CLI を既にインストールしている場合は、インストールを更新する方法を確認してください。

4. 1Password CLI を 1Password アプリと統合します。

5. GitHub CLIをインストールする。

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

• Bash

• Zsh

• fish

ステップ 1: GitHub 個人アクセストークンのCreateとSave

1Password を使用して GitHub CLI を認証する前に、 GitHub 個人アクセス トークンをCreateする必要があります。1Password は、ユーザー名とパスワードの代わりに個人アクセス トークンを使用して GitHub CLI を認証します。

個人アクセス トークンを既にCreateしている場合は、手順 2 に進みます。

個人アクセス トークンをまだCreateしていない場合は、Createして1Password ブラウザ拡張機能を使用して1PasswordにすばやくSaveできます。

• ①ブラウザで 1Password を開いてロックを解除します。
• ②手順に従ってGitHub 個人アクセス トークンをCreateします。
• ③1Password が GitHub 個人アクセス トークンのアイテムをSaveするかどうかを尋ねたら、Save itemをクリックします。

• ④アイテムをSaveする保管庫を選択し、アイテムの名前と詳細を編集して、Save itemをクリックします。

GitHub 個人アクセス トークンを 1Password に保存するためのポップアップ画面。

ステップ2: デフォルトの資格情報

複数のGitHubアカウントを使う場合

個人アカウントと仕事用アカウントなど、複数の GitHub アカウントで GitHub シェル プラグインを使う場合は、複数のアカウントを使うようにプラグインを設定する方法を学習してください。

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

1. GitHubプラグインで使う 1Password アカウントにサインインします。

$ op signin

1. 特定のディレクトリでのみプラグインを設定したい場合は、そのディレクトリに変更します。

2. プラグインを設定するには、次のコマンドを実行します。

$ op plugin init gh

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

op plugin init コマンドと、アイテムをインポートまたは選択するためのオプションを表示するターミナル ウィンドウ。

ステップ 1.1: アイテムをインポートまたは選択する

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

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

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

トークン、アイテム名、ボールトなど、アイテムをインポートするために使用できるフィールドを表示するターミナル ウィンドウ。

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

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

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

1Password アカウント内の既存のアイテムを検索するオプションが表示されたターミナル ウィンドウ。

ステップ 1.2: デフォルトの資格情報スコープを設定する

資格情報を選択またはインポートすると、 GitHub の認証にその項目を使うタイミングを構成するように求められます。

資格情報をいつ使用するかを設定するためのオプションを表示するターミナル ウィンドウ。

• "Prompt me for each new terminal session"を選択すると、現在のターミナル セッションの期間中のみ資格情報が設定されます。ターミナルを終了すると、デフォルトは削除されます。

• "Use automatically when in this directory or subdirectories"を選択すると、他のディレクトリ固有のデフォルトが設定されていない限り、現在のディレクトリとその全てのサブディレクトリで資格情報がデフォルトになります。ターミナル セッションのデフォルトは、ディレクトリ固有のデフォルトよりも優先されます。

• "Use as global default on my system"を選択すると、資格情報が全てのターミナル セッションとディレクトリのデフォルトとして設定されます。ディレクトリ固有のデフォルトは、グローバル デフォルトよりも優先されます。

単一の GitHub アカウントを使う場合は、Use as global default on my systemを選択します。これにより、個人アクセス トークンが全てのターミナル セッションとディレクトリのデフォルトとして設定されます。

複数の GitHub アカウントを使う場合は、コンテキスト切り替えにディレクトリ固有のデフォルトを使う方法を学習します。

ステップ3: plugins.shファイルをsource化

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

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

フォルダーのファイル パスは、構成ディレクトリ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

ステップ4: CLIを使う

次回GitHubでコマンドを入力するときに、生体認証またはシステム認証による認証を求められます。

1Password CLI 生体認証ロック解除を使用して認証されている CLI。

ステップ5: インポートした資格情報をdiskから削除

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

$ rm ~/.config/gh/hosts.yml

次のステップ

1Password Shell プラグインは60 を超えるサードパーティの CLI をサポートしています。サポートされている CLI のリストを表示するには:

$ op plugin list

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

$ op plugin init

シームレスなコンテキスト切り替えのためにシェル プラグインを使うには、複数の環境または複数のアカウントでプラグインを構成する方法を学習します。

ヘルプを受ける

設定を検査する

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

$ op plugin inspect gh

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

コマンド op plugin examine の結果を表示するターミナル ウィンドウ。

資格情報を消去する

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

$ op plugin clear gh

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

1. ターミナルセッションのデフォルト

2. ディレクトリのデフォルト、現在のディレクトリから$HOME

3. グローバルデフォルト

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

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

参照

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

新しい項目をインポートするためにop pluginを使うのではなく、手動で 1PasswordにGitHub資格情報をSaveする場合は、フィールド名が以下の表と一致していることを確認してください。

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

1Passwordフィールド名	環境変数
Token	GH_TOKEN
Host (optional)	GH_HOST

Learn more

• Use shell plugins to switch between multiple environments
• Use shell plugins with multiple accounts
• Build your own shell plugins