アカウントへの SSH キーの追加について
SSH (Secure Shell プロトコル) を使用して、GitHub のリポジトリ内のデータにアクセスし、書き込みを行うことができます。 SSH 経由で接続する場合は、ローカル コンピューター上の秘密キー ファイルを使用して認証します。詳細については、「SSH について」を参照してください。
SSH を使ってコミットとタグに署名することもできます。 コミット署名の詳細については、「コミット署名の検証について」を参照してください。
SSH キー ペアを生成した後、公開キーを GitHub.com に追加して、アカウントの SSH アクセスを有効にする必要があります。
前提条件
GitHub.com のアカウントに新しい SSH キーを追加する前に、次の手順を実行します。
- 既存の SSH キーを確認する。 詳しくは、「既存の SSH キーの確認」をご覧ください。
- 新しい 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