WindowsでBitbucket用のSSHキーを設定する方法

編集済み 2 数週間前によって ExtremeHow 編集チーム

ビットバケットウィンドウズ SSHキーセキュリティ認証セットアップ Git バージョン管理開発ソフトウェア

翻訳が更新されました 2 数週間前

WindowsオペレーティングシステムでBitbucket用のSSHキーを設定することは、Gitワークフローのセキュリティと効率を向上させるプロセスです。リポジトリからコードをプッシュまたはプルするたびにパスワードを入力する代わりに、SSHキーを使用して認証を行うことができます。

SSHキーの理解

SSH（Secure Shell）は、セキュアでないネットワーク経由でネットワークサービスに安全にアクセスするために使用されるプロトコルです。SSHキーはパスワードよりもセキュアな代替手段を提供し、暗号化キーのペアを使用してデバイスをリモートサーバーと認証します。

SSH キーペアには、公開鍵 と 秘密鍵 の 2 つのキーが含まれています。公開鍵は他者と安全に共有できます。秘密鍵はコンピュータ上で安全かつ秘密に保たれます。キーを使用してBitbucketにアクセスしようとすると、Bitbucketアカウントに登録されている公開鍵と秘密鍵との一致を確認してあなたの身元を確認します。

前提条件

SSHキーを設定する前に、システムが次の要件を満たしていることを確認してください：

Windowsオペレーティングシステム。
Gitのインストール版、Gitコマンドを実行するためのコマンドラインインターフェースであるGit Bashを含む。
リポジトリを保存できるBitbucketアカウント。

ステップバイステップガイド

ステップ 1: SSH キーを生成する

WindowsマシンでSSHキーを生成する手順に従います：

コンピュータでGit Bashアプリケーションを開きます。スタートメニューで見つけるか、Windows検索を使用して検索できます。
新しいSSHキーペアを作成するために次のコマンドを入力します：
```
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
"your_email@example.com"を実際のメールアドレスに置き換えます。
コマンドを入力すると、生成されたキーを保存する場所を指定するように求められます。デフォルトでは、キーは/c/Users/YourUser/.ssh/id_rsaに保存されます。デフォルトの場所を受け入れるにはEnterキーを押すか、カスタムパスを選択できます。
次に、パスフレーズを入力するように求められます。パスフレーズはSSHキーに追加のセキュリティ層を追加します。設定することが強くお勧めされますが、パスフレーズなしで空白のままにすることもできます。パスフレーズを入力してEnterキーを押すか、パスフレーズなしで進むにはEnterキーを押します。

手順を正常に完了すると、id_rsaという名前の秘密鍵とid_rsa.pubという名前の公開鍵の2つのキーが作成されます。秘密鍵は常に安全に保管し、共有しないでください。次のステップで公開鍵を使用します。

ステップ 2: SSH キーを Bitbucket に追加する

公開SSH鍵の準備が整ったら、Bitbucketアカウントに追加して認証を有効にします：

まず、id_rsa.pubファイルの内容をコピーする必要があります。Git Bashを開き、次のコマンドを入力してキーを表示します：
```
cat ~/.ssh/id_rsa.pub
```
Git Bashに表示されたすべてのキー出力を選択し、右クリックしてコピーします。
ウェブブラウザを使用して、Bitbucketアカウントにログインします。
右上隅でアバターアイコンをクリックし、ドロップダウンメニューからBitbucket 設定を選択します。
左側のメニューでセキュリティセクション内のSSH キーを見つけ、それをクリックします。
キーの追加ボタンをクリックして、キーのラベルと先ほどコピーしたキーを入力するプロンプトを開きます。
キーを説明するラベルを入力します。例:My Windows PC。Keyラベルの付いたテキストボックスに公開鍵を貼り付けます。
最後に変更を保存します。あなたのSSHキーはBitbucketアカウントに関連付けられました！

ステップ 3: SSH 設定を確認する

Bitbucket に SSH キーを追加した後、SSH 設定を確認することをお勧めします。これにより、システムが正しく構成され、SSH認証が予想どおりに動作することが保証されます：

Git Bashに移動し、次のコマンドを入力して、BitbucketへのSSH接続を開始します：
```
ssh -T git@bitbucket.org
```
初めて接続する場合は、Bitbucketの信頼性に関するメッセージが表示されることがあります。yesと入力し、Enterキーを押して続行します。
SSHが正しく構成されている場合、接続を確認するウェルカムメッセージが表示されます。このステータスは、SSHキーが正常に設定され、使用する準備が整っていることを示します。

複数のSSHキーの管理

異なるBitbucketアカウントを持っている場合や、異なるデバイスからアクセスする必要がある場合、複数のSSHキーを管理することが可能です。こちらは簡単なガイドです：

同じssh-keygenコマンドを使用して追加のSSHキーペアを生成し、異なるファイル名で保存します。
各キーについて、.sshディレクトリ内に設定ファイルを作成します。
```
touch ~/.ssh/config
```
テキストエディタ（例えばNotepad）を使用してconfigファイルを編集し、異なるアカウントまたはシステムに使用する秘密鍵を指定します：
```
Host bitbucket-account1
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/id_rsa_account1

Host bitbucket-account2
    HostName bitbucket.org
    User git
    IdentityFile ~/.ssh/id_rsa_account2
```
IdentityFileフィールドを対応するキーファイルの場所に置き換えてください。

セキュリティの考慮事項

SSH秘密鍵を安全に保つことは非常に重要です。これらの鍵を持つと、Bitbucketリポジトリにアクセスできます。キーのセキュリティを確保するために、次の方法を検討してください：

秘密鍵を他人と共有しないでください。コンピュータ上で秘密かつ私的に保管してください。
SSHキーの作成時にパスフレーズを使用して、追加のセキュリティを提供します。
BitbucketアカウントでSSHキーを定期的に確認および管理し、使用していないキーは削除してください。
回復目的で秘密鍵ファイルをバックアップし、安全な場所に保管してください。

SSH問題のトラブルシューティング

SSH設定に問題が発生した場合は、次のトラブルシューティング手順を試してください：

ssh-agentが実行されており、キーが読み込まれていることを確認してください。エージェントを開始し、次のキーを読み込むことができます:
```
eval $(ssh-agent -s)
ssh-add ~/.ssh/id_rsa
```
Bitbucketの公開鍵が正しいことを確認します。タイプミスは認証の問題を引き起こす可能性があります。
.sshディレクトリと鍵ファイルのファイルパーミッションを確認してください。秘密鍵には、所有者以外が読み取り/書き込み権限を持たないようにしてください。
SSHログを確認して、可能なエラーメッセージや診断の詳細を調べます：
```
ssh -vT git@bitbucket.org
```
-vフラグは詳細モードを有効にし、接続試行に関するより多くの情報を提供します。

結論

WindowsでBitbucket用のSSHキーを設定することは、簡単な作業です。SSHを活用することで、Gitリポジトリを効果的に管理するために、パスワードのないセキュアな認証システムを確立できます。セキュリティのためのベストプラクティスを維持し、SSHキーを定期的に管理して、安全な開発環境を維持することを忘れないでください。適切に設定することで、コーディングワークフローはシームレスで安全になります。

記事の内容に誤りがある場合, あなたは

WindowsでBitbucket用のSSHキーを設定する方法

SSHキーの理解

前提条件

ステップバイステップガイド

ステップ 1: SSH キーを生成する

ステップ 2: SSH キーを Bitbucket に追加する

ステップ 3: SSH 設定を確認する

複数のSSHキーの管理

セキュリティの考慮事項

SSH問題のトラブルシューティング

結論

コメント

WindowsでBitbucket用のSSHキーを設定する方法

検索 ExtremeHow (ja)