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

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

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

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

SSH キーの組を生成した後、公開キーをお使いの GitHub Enterprise Server インスタンスに追加して、アカウントの SSH アクセスを有効にする必要があります。

前提条件

お使いの GitHub Enterprise Server インスタンスのアカウントに新しい SSH キーを追加する前に、以下の手順を完了します。

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

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

お使いの GitHub Enterprise Server インスタンス上のアカウントに新しい SSH 認証キーを追加した後、SSH を使うようにローカルリポジトリを再構成できます。詳しくは、「リモートリポジトリを管理する」を参照してください。

注: 既定では、GitHub Enterprise Server 3.6 以降では、2022 年 8 月 1 日午前 0 時 (UTC) の期限の時点で、次の両方の条件を満たす SSH 接続は失敗します。

RSA キーは、2022 年 8 月 1 日午前 0 時 (UTC) の期日後に、お使いの GitHub Enterprise Server インスタンスのユーザーアカウントに追加されました。
SSH クライアントでは、SHA-1 ハッシュ関数を使用して接続試行に署名します。

GitHub Enterprise Server 3.6 以降では、DSA、HMAC-SHA-1、または CBC 暗号を使用する SSH 接続もサポートされていません。期限より前にアップロードされた RSA SSH キーは、キーが有効である限り、SHA-1 ハッシュ関数を使用して認証を続けることができます。使用する GitHub Enterprise Server のバージョンを見つける方法の詳細については、「GitHub Docs のバージョンについて」を参照してください。

サイト管理者は RSA-SHA-1 を使って接続の期限を調整でき、RSA-SHA-1 を使用するすべての接続をブロックできます。詳細については、サイト管理者に問い合わせるか、「インスタンスへの SSH 接続の構成」を参照してください。

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 フォルダーを探し、お気に入りのテキストエディターでファイルを開き、クリップボードにコピーできます。
```
$ 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. 任意のページで、右上隅にあるプロファイルの画像をクリックし、次に[**設定**]をクリックします。
サイドバーの [アクセス] セクションで、 SSH キーと GPG キーをクリックします。
[New SSH key](新しい SSH キー) または [Add SSH key](SSH キーの追加) をクリックします。
[Title] フィールドで、新しいキーを説明するラベルを追加します。たとえば、個人のラップトップを使っている場合、このキーに「個人用ラップトップ」といった名前を付けます。
キーの種類として、認証または署名のいずれかを選びます。コミット署名の詳細については、「コミット署名の検証について」を参照してください。
公開キーを [Key] フィールドに貼り付けます。
[Add SSH key](SSH キーの追加) をクリックします。
ダイアログが表示されたら GitHub Enterprise Server のアカウントへのアクセスを確認します。詳しくは、「Sudo モード」を参照してください。

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

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

現在、GitHub CLI を使って追加できるのは SSH 認証キーだけであり、SSH 署名キーを追加することはできません。

GitHub アカウントに SSH 認証キーを追加するには、ssh-key add サブコマンドを使って、公開キーを指定します。

gh ssh-key add KEY-FILE

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

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

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

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

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

この記事の内容

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

前提条件

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