Skip to main content

GitHub アカウントへの新しい SSH キーの追加

新しい (または既存の) SSH キーを使用するように GitHub.com でアカウントを構成するには、そのキーをアカウントに追加する必要もあります。

Platform navigation

Tool navigation

アカウントへの SSH キーの追加について

SSH (Secure Shell プロトコル) を使用して、GitHub のリポジトリ内のデータにアクセスし、書き込みを行うことができます。 SSH 経由で接続する場合は、ローカル コンピューター上の秘密キー ファイルを使用して認証します。詳細については、「SSH について」を参照してください。

SSH を使ってコミットとタグに署名することもできます。 コミット署名の詳細については、「コミット署名の検証について」を参照してください。

SSH キー ペアを生成した後、公開キーを GitHub.com に追加して、アカウントの SSH アクセスを有効にする必要があります。

前提条件

GitHub.com のアカウントに新しい SSH キーを追加する前に、次の手順を実行します。

  1. 既存の SSH キーを確認する。 詳しくは、「既存の SSH キーの確認」をご覧ください。
  2. 新しい SSH キーを生成し、マシンの SSH エージェントに追加する。 詳しくは、「新しい SSH キーを生成して ssh-agent に追加する」をご覧ください。

アカウントへの新しい SSH キーの追加

SSH キーを追加し、認証またはコミット署名、またはその両方に使用できます。 認証と署名の両方に同じ SSH キーを使用する場合は、2 回アップロードする必要があります。

新しい SSH 認証キーを GitHub.com のアカウントに追加した後、SSH を使用するようにローカル リポジトリを再構成できます。 詳しくは、「リモートリポジトリを管理する」をご覧ください。

Note

GitHub は、2022 年 3 月 15 日に古いセキュリティで保護されていないキーの種類を削除することでセキュリティを強化しました。

それ以降、DSA キー (ssh-dss) はサポートされなくなりました。 GitHub の個人用アカウントに新しい DSA キーを追加することはできません。

2021 年 11 月 2 日以前の valid_after を持つ RSA キー (ssh-rsa) では、任意の署名アルゴリズムを引き続き使用できます。 その日以降に生成される RSA キーは、SHA-2 署名アルゴリズムを使用する必要があります。 SHA-2 署名を使用するには、一部の古いクライアントをアップグレードする必要があります。

Note

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

GitHub CLI を使用してアカウントに SSH キーを追加する前に、GitHub CLI に対して認証を行う必要があります。 詳細については、GitHub CLI ドキュメントの「gh auth login」を参照してください。

GitHub アカウントに SSH キーを追加するには、ssh-key add サブコマンドを使用して公開キーを指定します。 認証キーのためで、追加のスコープを要求するように求められた場合は、コマンド ラインの指示に従います。

gh ssh-key add KEY-FILE --type {authentication|signing}

新しいキーのタイトルを含めるには、-t または --title フラグを使用します。

gh ssh-key add KEY-FILE --title "personal laptop"

新しい SSH キーを生成して ssh-agent に追加する」の手順に従って SSH キーを生成した場合は、このコマンドを使用してアカウントにキーを追加できます。

gh ssh-key add ~/.ssh/id_ed25519.pub --type signing

SSH キーをアカウントに追加できましたか?

はい いいえ

参考資料