> 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-the-1password-ssh-agent-with-wsl.md).
# WSLで1Password SSHエージェントを使う
### **WSLで1Password SSHエージェントを使う**
1Password Windows Subsystem for Linux（WSL）統合により、Windowsホストで実行されている1Password SSHエージェントを使って、SSHとGitコマンドを認証し、WSL内でGitコミットに署名できるようになります。
1Password統合はWSL 1とWSL 2の両方をサポートします。
### 必要条件
1. 1Passwordに[サインアップ](https://1password.com/pricing)してください。
2. [1Password for Windows](https://support.1password.com/get-the-apps/?windows)をインストールしてサインインしてください。
3. [1PasswordでSSH鍵を生Createまたはインポート](https://developer.1password.com/docs/ssh/manage-keys)してください。
4. Windowsホストに[1Password SSHエージェントを設定し、実行されていることを確認します。](https://developer.1password.com/docs/ssh/get-started/)
5. [Windows Subsystem for Linuxをお好みのLinuxディストリビューションと一緒にWindowsにインストール](https://learn.microsoft.com/windows/wsl/install)してください。
### **統合の仕組み**
WSLを使うと、[コマンドラインからWindows OpenSSHクライアント（ssh.exe）などのWindowsツールを実行できます](https://learn.microsoft.com/windows/wsl/filesystems#run-windows-tools-from-linux)。1Password WSL統合は、[相互運用性を活用します。](https://learn.microsoft.com/windows/wsl/filesystems#interoperability-between-windows-and-linux-commands)WSLに組み込まれており、SSHリクエストをWindows上の1Password SSHエージェントに転送します。
標準のOpenSSHエージェント転送のように SSH*エージェント*リクエストを転送する代わりに、WSLからWindowsで実行されているssh.exeプロセスにSSHリクエスト全体を効果的に転送できます。その後、ssh.exeプロセスはWindowsホスト上の1Password SSHエージェントを使ってリクエストを認証します。
[これは、SSH設定への変更は、](https://developer.1password.com/docs/ssh/agent/advanced)Windowsの%USERPROFILE%/.ssh/configファイルで行う必要がある（WSLインスタンス上のファイルではなく）ことも意味します。
### **SSHリクエストを転送させる**
* 1.次のコマンドを使って、**Windowsホスト上で**1Password SSHエージェントが実行されているかどうかを確認します。
PS C:\\> ssh-add.exe -l
結果の例：
256 SHA256:2zmxMpLy5MeIx18pBUkumptKkKinlghygOvV6URe8QI Git Authentication Key (ED25519)
* エージェントが実行中の場合、1つ以上のSSH鍵のリストが返されます。これらは、1PasswordにSaveしたSSH鍵であり、エージェントでSSHリクエストに使用できます。
* **2.WSLインスタンスで**次のコマンドを実行してWSLがSSHリクエストを正常に転送しているかどうかを確認します。
$ ssh-add.exe -l
結果の例：
256 SHA256:2zmxMpLy5MeIx18pBUkumptKkKinlghygOvV6URe8QI Git Authentication Key (ED25519)
Windowsホストでコマンドを実行したときと同じSSH鍵のリストが返されるはずです。その場合、WSLはSSHリクエストをWindowsホストに転送しています。\
ssh-add.exe -lコマンドの実行時にSSH鍵がリストされない場合は、[ヘルプを参照してください](https://developer.1password.com/docs/ssh/integrations/wsl/#troubleshooting)。
* 3.WSLにSSH鍵がリストされている場合は、コマンド内のsshをssh.exeに置き換えてSSHリクエストを実行してみてください。
例：\
$ ssh.exe -T
SSHリクエストを承認するため、1Passwordからのプロンプトが表示されます。
1Password SSHエージェントを使って、WindowsホストとWSLインスタンス間でSSHリクエストを転送できるようになりました。
### **ssh.exeを使うようにGitを設定する**
### 1Password SSHエージェントを使ってWSLでGitコマンドを認証するにはcore.sshCommandとしてssh.exeを使うようにGitを設定できます。
この変数をグローバルに設定するには、WSLで次のコマンドを実行します。
$ git config --global core.sshCommand ssh.exe
### **SSHでGitコミットに署名する**
⚠情報
1Password WSL統合によるSSH Gitコミット署名には、Git 2.34.0以降と64ビット版の Windows 10以降が必要です。Arm搭載のWindowsデバイスはサポートされていません。
Gitがssh.exeを使うように設定されている場合、統合を使ってWSLからGitコミットに署名することもできます。
WSLでSSHを使ってGitコミット署名をグローバルに設定するには：
1. Windowsホストで1Passwordアプリを開き、使う SSH鍵を開きます。
2. ⁝をクリックし［ Configure Commit Signing］を選びます。
3. 次のウィンドウで、［Configure for Windows Subsystem for Linux (WSL)］チェックボックスをオンにし、［Copy Snippet］をクリックします。
4. WSLインスタンスで、スニペットを\~/.gitconfigファイルに貼り付けます。
[単一のリポジトリーでSSH署名を設定する](https://developer.1password.com/docs/ssh/git-commit-signing#configure-commit-signing-in-a-single-repository)こともできます。
1PasswordはGit設定ファイルに次の変更を加えます。
* gpg.formatをsshに設定します。
* user.signingkeyを、コミットに署名するために選択した公開鍵に設定します。
* commit.gpgsignをtrueに設定すると、各コミットに-Sフラグを含める必要がなくなります。 *（オプション）*
* gpg.ssh.program1Passwordが提供するSSH署名バイナリーに設定します。
WSLでGitコミット署名を設定したら、Windowsホストと同じ手順を使って設定をテストできます。[公開鍵を登録し](https://developer.1password.com/docs/ssh/git-commit-signing/#step-2-register-your-public-key)、[コードをコミットして](https://developer.1password.com/docs/ssh/git-commit-signing/#step-3-commit-and-push-your-code)、[コミットが署名されていることを確認します](https://developer.1password.com/docs/ssh/git-commit-signing#step-4-verify-your-commit-signature)。
### **オプション：SSHコマンドのためのエイリアスを追加する**
Windowsホストで1Password SSHエージェントを使ってGit以外のSSHリクエストを認証する予定の場合は、オプションでssh.exeとssh-add.exeの代わりにコマンドラインでsshとssh-addを使用するエイリアスを[Bashプロファイル](https://linux.die.net/Bash-Beginners-Guide/sect_03_05.html)にCreateできます。
これは必須ではありませんが、全てのプラットフォームで同じSSHコマンドを使うと便利です。\~/.bashrcまたは\~/.bash\_aliasesファイルに、次のエイリアスを追加します。
$ alias ssh='ssh.exe'\
$ alias ssh-add='ssh-add.exe'
### **認証モデル** 1Password SSHエージェントは、他のプラットフォームと同様に、WSL統合で同じ[認証モデル](https://developer.1password.com/docs/ssh/agent/security#authorization-model)を使います。WSLセッションのSSH鍵リクエストを承認すると、現在のセッションのみがその鍵の使用を許可されます。新しいWSLセッションまたはタブを開くと、SSHリクエストを再度承認するように求められます。
[1Password SSHエージェント認証モデルの詳細をご覧ください。](https://developer.1password.com/docs/ssh/agent/security#authorization-model)
### **トラブルシューティング**
WSLでssh-add.exe -lコマンドを実行したときにcommand not foundエラーが表示される場合は、OpenSSHがPATHにない可能性があります。完全な実行可能パスを使って、コマンドを再度実行してみてください。
$ /mnt/c/Windows/System32/OpenSSH/ssh-add.exe -l
それでもエラーが表示される場合は、[相互運用性設定](https://learn.microsoft.com/windows/wsl/wsl-config#interop-settings)（\[interop]）がWSL設定ファイルでオンになっていることを確認してください。オンになっている場合、エントリーは次のようになります。
\[interop]\
enabled = true
代わりにenabled = falseが表示される場合は、enabled値をtrueに設定します。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://manual.dxable.com/1password/use-the-1password-ssh-agent-with-wsl.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.