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 を䜿甚するようにロヌカル リポゞトリを再構成できたす。 詳しくは、「リモヌトリポゞトリを管理する」をご芧ください。

メモ

GitHub は、2022 幎 3 月 15 日に叀いセキュリティで保護されおいないキヌの皮類を削陀するこずでセキュリティを匷化したした。

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

2021 幎 11 月 2 日以前の valid_after を持぀ RSA キヌ (ssh-rsa) では、任意の眲名アルゎリズムを匕き続き䜿甚できたす。 その日以降に生成される RSA キヌは、SHA-2 眲名アルゎリズムを䜿甚する必芁がありたす。 SHA-2 眲名を䜿甚するには、䞀郚の叀いクラむアントをアップグレヌドする必芁がありたす。

  1. SSH 公開鍵をクリップボヌドにコピヌしたす。

    SSH 公開鍵のファむル名がサンプルコヌドず異なる堎合は、珟圚の蚭定に䞀臎するようにファむル名を倉曎しおください。 キヌをコピヌする際には、改行や空癜を远加しないでください。

    $ pbcopy < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard

    ヒント

    pbcopy が機胜しない堎合は、非衚瀺の .ssh フォルダヌを探し、任意のテキスト ゚ディタヌでそのファむルを開いお、クリップボヌドにコピヌできたす。

$ clip < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard

メモ

  • Linux 甹 Windows サブシステム (WSL) では、clip.exe を䜿うこずができたす。 clip が機胜しない堎合は、非衚瀺の .ssh フォルダヌを探し、お気に入りのテキスト ゚ディタヌでファむルを開き、クリップボヌドにコピヌできたす。
  • Windows Terminal を䜿甚する新しいバヌゞョンの Windows、たたは PowerShell コマンド ラむンを䜿甚する堎合は、The '&lt;' operator is reserved for future use. を瀺す ParseError が衚瀺されるこずがありたす。この堎合は、次の代替 clip コマンドを䜿甚する必芁がありたす。
$ cat ~/.ssh/id_ed25519.pub | clip
# Copies the contents of the id_ed25519.pub file to your clipboard

$ cat ~/.ssh/id_ed25519.pub
# Then select and copy the contents of the id_ed25519.pub file
# displayed in the terminal to your clipboard

ヒント

たたは、非衚瀺の .ssh フォルダヌを探し、任意のテキスト ゚ディタヌでそのファむルを開いお、クリップボヌドにコピヌできたす。

  1. GitHub で、任意のペヌゞの右䞊隅にある自分のプロフィヌル写真をクリックしおから、 [蚭定] をクリックしたす。

  2. サむドバヌの [アクセス] セクションで、 [ SSH キヌず GPG キヌ] をクリックしたす。

  3. [New SSH key](新しい SSH キヌ) たたは [Add SSH key](SSH キヌの远加) をクリックしたす。

  4. [Title] フィヌルドで、新しいキヌを説明するラベルを远加したす。 たずえば、個人のラップトップを䜿っおいる堎合、このキヌに「個人甚ラップトップ」ずいった名前を付けたす。

  5. キヌの皮類ずしお、認蚌たたは眲名のいずれかを遞びたす。 コミット眲名の詳现に぀いおは、「コミット眲名の怜蚌に぀いお」を参照しおください。

  6. [キヌ] フィヌルドに公開キヌを貌り付けたす。

  7. [Add SSH key](SSH キヌの远加) をクリックしたす。

  8. ダむアログが衚瀺されたら GitHub のアカりントぞのアクセスを確認したす。 詳しくは、「Sudo モヌド」をご芧ください。

メモ

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

参考資料