コマンドライン
PR

SSH鍵の作り方(ssh-keygen)と使い方|ed25519・GitHub登録を解説

SSH鍵の作り方(ssh-keygen)と使い方|ed25519・GitHub登録を解説
hr
記事内に商品プロモーションを含む場合があります

サーバーへのログインや、GitHub へのプッシュで「SSH 鍵を登録してください」と言われることがあります。SSH 鍵は、パスワードの代わりに使う「鍵ファイル」のペアで、ssh-keygen というコマンドで作ります。

この記事では、Windows 11 の PowerShell(Windows に入っている OpenSSH 9.5p2)と Git Bash(OpenSSH 9.9p2)で実際にコマンドを実行して、次のことを説明します。

  • 公開鍵と秘密鍵の違い、どちらを人に渡してよいか
  • ssh-keygen での鍵の作り方と、ed25519 と rsa の違い
  • パスフレーズと ssh-agent(入力を省く仕組み)
  • サーバー(authorized_keys)と GitHub への公開鍵の登録、~/.ssh/config の書き方
  • よくある間違いとエラーメッセージの意味

SSH 鍵とは?公開鍵と秘密鍵

SSH(エスエスエイチ)は、ネットワークの向こうにあるコンピューターに安全にログインしたり、ファイルを送ったりするための仕組みです。ログインの方法には「パスワード」と「鍵」があり、鍵を使う方法を公開鍵認証と呼びます。

ssh-keygen を実行すると、2 つのファイルが 1 組でできます。

種類ファイル名の例置く場所人に渡してよいか
秘密鍵id_ed25519(拡張子なし)自分のパソコンだけ絶対に渡さない
公開鍵id_ed25519.pubログインしたいサーバーや GitHub に登録する渡してよい

サーバーに公開鍵を預けておき、ログインのときに「この公開鍵とペアの秘密鍵を持っている」ことを、秘密鍵そのものは送らずに証明する仕組みです。ssh-keygen のマニュアルにも、公開鍵は「内容を秘密にする必要はない」、秘密鍵は「本人以外が読めるようにしてはいけない」と書かれています。

SSH 鍵の置き場所。手元の PC の .ssh フォルダーに、秘密鍵 id_ed25519 と公開鍵 id_ed25519.pub がある。秘密鍵は自分の PC だけに置き、絶対に渡さない。公開鍵は渡してよく、公開鍵だけをサーバーの authorized_keys に 1 行追記し、GitHub の SSH and GPG keys に登録する。ログインするときは、秘密鍵そのものは送らずに、ペアの秘密鍵を持っていることを証明する。
図 1:秘密鍵は手元に、公開鍵だけをサーバーと GitHub に登録する

パスワード認証とくらべると、推測されやすいパスワードを使わずにすむこと、サーバーにパスワードを打ち込まなくてよいことが利点です。その代わり、秘密鍵のファイルが漏れると、そのファイルを持つ人は誰でもあなたとしてログインできます。秘密鍵はパスワードと同じように守ってください。

ssh-keygen で SSH 鍵を作る

ssh-keygen が使えるか確かめる

Windows 11 には OpenSSH のクライアント(ssh、ssh-keygen など)が入っていて(筆者の環境では C:\Windows\System32\OpenSSH にありました)、PowerShell やコマンドプロンプトから使えます。Git for Windows を入れている場合は、Git Bash にも別の ssh-keygen が入っています。まず、バージョンを表示して確かめます。

ssh -V

筆者の環境(2026 年 10 月)では、次のように表示されました。上が PowerShell、下が Git Bash で実行した結果です。

OpenSSH_for_Windows_9.5p2, LibreSSL 3.8.2
OpenSSH_9.9p2, OpenSSL 3.2.4 11 Feb 2025

このように、PowerShell と Git Bash では別の OpenSSH が動いています。どちらで作った鍵も同じ形式なので、作った鍵はどちらからでも使えます。

鍵を作るコマンド

今おすすめされている ed25519 という種類の鍵を作ります。GitHub のドキュメントで案内されているのも次の形です。-C の後ろはコメント(鍵の目印)なので、自分のメールアドレスなどに置き換えてください。

ssh-keygen -t ed25519 -C "your_email@example.com"

同じコマンドを PowerShell で実行してもかまいません。オプションの意味は次のとおりです。

オプション意味省略したとき
-t鍵の種類(ed25519、rsa など)ed25519(OpenSSH 9.5 以降)
-Cコメント。公開鍵の末尾に付く「ユーザー名@コンピューター名」
-f保存するファイル名画面で聞かれる(既定は ~/.ssh/id_ed25519 など)
-b鍵の長さ(ビット数)。rsa で使うrsa は 3072 ビット
-Nパスフレーズを画面で聞かずに指定する画面で聞かれる

実際に、PowerShell と Git Bash の両方で -t を付けずに鍵を作り、ssh-keygen -l で種類を確かめたところ、どちらも「(ED25519)」でした。OpenSSH 9.5 のリリースノートに「ssh-keygen(1): generate Ed25519 keys by default.」とあるとおり、それより前のバージョンでは既定が rsa だったので、-t ed25519 は省略せずに書くのが確実です。

画面で聞かれること

コマンドを実行すると、次の 3 つを順に聞かれます。

  1. Enter file in which to save the key (…/.ssh/id_ed25519): 保存先です。そのまま Enter キーを押すと、かっこの中の場所(ホームフォルダーの .ssh フォルダー)に保存されます。Windows では C:\Users\<ユーザー名>\.ssh です。
  2. Enter passphrase (empty for no passphrase): パスフレーズ(秘密鍵を守る合言葉)です。Git Bash の 9.9p2 では「Enter passphrase for “保存先” (empty for no passphrase):」と表示されます。入力した文字は画面に表示されませんが、入力はされています。
  3. Enter same passphrase again: 確認のため、同じパスフレーズをもう一度入力します。

作り終わると、次のように表示されます(保存先と指紋は伏せています。randomart は指紋を絵にしたもので、毎回違う形になります)。

Your identification has been saved in (保存先)/id_ed25519
Your public key has been saved in (保存先)/id_ed25519.pub
The key fingerprint is:
SHA256:(43 文字の英数字・記号) your_email@example.com
The key's randomart image is:
+--[ED25519 256]--+
(以下、記号で描かれた絵)

「identification」が秘密鍵、「public key」が公開鍵です。

できたファイルを確かめる

公開鍵の中身は、次のコマンドで表示できます(PowerShell では Get-Content の別名として cat が使えます)。

cat ~/.ssh/id_ed25519.pub

公開鍵は 1 行のテキストで、「鍵の種類」「Base64 で書かれた鍵の本体」「コメント」が空白で区切られています。次は形を示すための例です。

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA…(省略)… your_email@example.com

ed25519 の公開鍵は、鍵の本体が 68 文字と短く、コメントを含めても 1 行に収まります。一方、秘密鍵のファイルは「—–BEGIN OPENSSH PRIVATE KEY—–」で始まります。この行で始まるファイルの中身は、どこにも貼り付けないでください。

鍵の指紋(フィンガープリント)は -l で表示できます。指紋は公開鍵から計算した SHA-256 のハッシュ値で、長い公開鍵を短く見比べるために使います。

ssh-keygen -l -f ~/.ssh/id_ed25519.pub

結果は「256 SHA256:(43 文字) your_email@example.com (ED25519)」の形で、先頭の 256 は鍵の長さ(ビット数)です。筆者が試したところ、公開鍵の Base64 部分を元のバイト列に戻して SHA-256 を計算し、それを Base64 にして末尾の「=」を取ると、ssh-keygen -l の値と一致しました。ハッシュ値の考え方は「ハッシュ生成ツール」のページでも解説しています。

PowerShell で実行するときの注意:この記事の Git Bash 向けのコマンドにある「~」(ホームフォルダー)は、PowerShell から ssh-keygen に渡すと、筆者の環境では「~/….pub: No such file or directory」となり認識されませんでした。PowerShell では「~/.ssh/」の部分を「$env:USERPROFILE\.ssh\」に置き換えてください。

ssh-keygen -l -f $env:USERPROFILE\.ssh\id_ed25519.pub

ed25519 と rsa の違い

ssh-keygen で作れる主な鍵の種類は ed25519 と rsa です。実際に作って大きさをくらべると、次のようになりました(コメントは 1 文字にそろえています)。

項目ed25519rsa(既定の 3072 ビット)rsa(-b 4096)
鍵の長さ256 ビット(固定)3072 ビット4096 ビット
公開鍵ファイルの大きさ83 バイト555 バイト727 バイト
秘密鍵ファイルの大きさ387 バイト2,578 バイト—
公開鍵の先頭ssh-ed25519ssh-rsassh-rsa

使い分けの目安は次のとおりです。

  • ふつうは ed25519:鍵が短く扱いやすく、OpenSSH 9.5 以降の既定です。GitHub のドキュメントもまず ed25519 を案内しています。ed25519 は長さが決まっているので、-b 4096 を付けても 256 ビットのままでした。
  • 相手が ed25519 に対応していないときは rsa:古いサーバーや機器では ed25519 が使えないことがあります。GitHub のドキュメントでは、その場合の代わりとして ssh-keygen -t rsa -b 4096 -C "your_email@example.com" が示されています。

パスフレーズは付けるべき?

パスフレーズを付けると、秘密鍵のファイルが暗号化されます。実際に、パスフレーズなしの秘密鍵の中身を確かめると暗号の方式が「none」でしたが、パスフレーズを付けたものは「aes256-ctr」で暗号化されていました。そのため、万一秘密鍵のファイルが盗まれても、パスフレーズが分からなければ使えません。

ssh-keygen のマニュアルでは、よいパスフレーズは 10〜30 文字で、簡単な文や推測しやすいものでないこと、とされています。また、パスフレーズを忘れると元に戻す方法はありません。その場合は鍵を作り直し、登録してある公開鍵も入れ替えます。

あとからパスフレーズを付けたり変えたりするには -p を使います。今のパスフレーズ(なければ空のまま Enter)と、新しいパスフレーズを 2 回聞かれ、最後に「Your identification has been saved with the new passphrase.」と表示されれば変更できています。

ssh-keygen -p -f ~/.ssh/id_ed25519

Microsoft Learn の OpenSSH の解説でも、パスフレーズを空にすることは一般にすすめられていません。自分のパソコンで使う鍵には付けておき、毎回の入力が面倒なら次の ssh-agent を使いましょう。

ssh-agent でパスフレーズの入力を省く

ssh-agent は、パスフレーズを入れて開いた秘密鍵をメモリー上で預かってくれるプログラムです。一度 ssh-add で鍵を登録すると、そのあとの接続ではパスフレーズを聞かれなくなります。

Windows(PowerShell)の場合

Windows では、ssh-agent は「サービス」(裏で動き続けるプログラム)として入っています。筆者のパソコンで状態を確かめたところ、初期状態では停止していて、スタートアップの種類は「Disabled(無効)」でした。

Get-Service ssh-agent

この状態で ssh-add -l(登録した鍵の一覧)を実行すると、「Could not open a connection to your authentication agent.」と表示されます。

サービスを使えるようにする手順は、Microsoft Learn の「Key-Based Authentication in OpenSSH for Windows」に書かれています。次の 2 つのコマンドは、管理者として開いた PowerShell で実行します(スタートボタンを右クリック →「ターミナル (管理者)」)。なお、サービスの設定を変えるため、筆者は実行しておらず、手順は Microsoft Learn の記載をもとにしています。

Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent

1 つ目でパソコンの起動時に自動で始まるようにし、2 つ目で今すぐ開始します(GitHub のドキュメントでは、自動ではなく「Manual(手動)」にする手順が示されています。どちらでも、Start-Service で開始すれば使えます)。そのあと、ふつうの PowerShell で鍵を登録します。

ssh-add $env:USERPROFILE\.ssh\id_ed25519

Git Bash の場合

Git Bash では、管理者権限なしで ssh-agent をその場で起動できます。

eval "$(ssh-agent -s)"

「Agent pid 3299」のように、起動した ssh-agent の番号が表示されます。続けて鍵を登録します。

ssh-add ~/.ssh/id_ed25519

パスフレーズを入力すると「Identity added: (秘密鍵のパス) (your_email@example.com)」と表示されます。ssh-add -l で、登録した鍵の指紋の一覧を確認できます。この方法で起動した ssh-agent は、その Git Bash の画面の中だけで使えます。

このように、Windows のサービスの ssh-agent と、Git Bash で起動した ssh-agent は別のものです。PowerShell で登録した鍵は Git Bash の ssh からは見えないことがあるので、ふだん使う ssh を、どちらか一方にそろえると迷いにくくなります。

公開鍵をサーバーに登録する(authorized_keys)

Linux などのサーバーに鍵でログインするには、サーバー側のユーザーのホームディレクトリにある ~/.ssh/authorized_keys に、公開鍵の 1 行を書き足します。sshd(SSH のサーバー側のプログラム)のマニュアルによると、このファイルは 1 行に 1 つの鍵を書き、空の行と「#」で始まる行はコメントとして無視されます。

# 自宅のノートパソコン
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA…(省略)… alice@laptop
# 会社のパソコン
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA…(省略)… alice@office

Git Bash には、この作業をまとめて行う ssh-copy-id が入っています(Windows の OpenSSH には入っていません)。パスワードでログインできるサーバーなら、次のように実行すると、パスワードを 1 回入力するだけで公開鍵が登録されます(ユーザー名とサーバー名は置き換えてください)。

ssh-copy-id -i ~/.ssh/id_ed25519.pub user@server.example.com

手で登録する場合は、サーバーにログインしたうえで、.ssh ディレクトリを作り、公開鍵の 1 行を authorized_keys の末尾に追加します。上書きの > ではなく、追記の >> を使うことに注意してください。> にすると、すでに登録してあるほかの鍵が消えてしまいます。そのあと、権限(パーミッション)を次のようにします。

ファイルマニュアル(ssh・sshd)でのすすめ数値
~/.ssh本人は読み書き・実行、ほかの人はアクセスできない700
~/.ssh/authorized_keys本人は読み書き、ほかの人はアクセスできない600
秘密鍵(~/.ssh/id_ed25519)本人は読める、ほかの人はアクセスできない600
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

sshd のマニュアルには、authorized_keys や ~/.ssh、ホームディレクトリがほかのユーザーから書き込める状態だと、sshd はそのファイルを使わない(StrictModes という設定が「no」でない限り)と書かれています。鍵を登録したのにパスワードを聞かれるときは、まずパーミッションを疑いましょう。700 や 600 が何を意味するかは「chmod計算ツール」で確かめられます。

GitHub に公開鍵を登録する

GitHub に SSH でプッシュするには、公開鍵を自分のアカウントに登録します。手順は GitHub のドキュメント(2026 年 10 月に確認)にもとづいています。

  1. 公開鍵をクリップボードにコピーします。Git Bash では clip < ~/.ssh/id_ed25519.pub、PowerShell では cat ~/.ssh/id_ed25519.pub | clip を実行します(どちらも GitHub のドキュメントに書かれているコマンドです)。.pub の付いたファイルであることを必ず確かめてください。
  2. GitHub の画面右上のプロフィール画像をクリックし、「Settings」をクリックします。
  3. 左のメニューの「Access」の中にある「SSH and GPG keys」をクリックします。
  4. 「New SSH key」(または「Add SSH key」)をクリックします。
  5. 「Title」に、どのパソコンの鍵か分かる名前(例:自宅のノートパソコン)を入力します。
  6. 鍵の種類は、認証用(Authentication)を選びます。署名用(Signing)は、コミットに署名するときに使うものです。
  7. 「Key」の欄に、手順 1 でコピーした公開鍵を貼り付けます。
  8. 「Add SSH key」をクリックします。パスワードなどの確認を求められたら、画面の指示に従って入力します。

登録できたら、接続を試します。

ssh -T git@github.com

初めて接続するときは「The authenticity of host ‘github.com (…)’ can’t be established.」と表示され、接続先の指紋と「Are you sure you want to continue connecting (yes/no)?」が出ます。これは「この相手が本物の github.com か確認してください」という意味です。GitHub が公開している ED25519 の指紋は次の値です(GitHub のドキュメント「GitHub’s SSH key fingerprints」より)。

SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU

表示された指紋がドキュメントの値と一致したときだけ「yes」と入力します。成功すると「Hi ユーザー名! You’ve successfully authenticated, but GitHub does not provide shell access.」と表示されます。GitHub はシェル(コマンドを打つ画面)を提供していないので、後半の文はエラーではありません。リモートリポジトリの URL は「git@github.com:ユーザー名/リポジトリ名.git」の形のものを使います。

~/.ssh/config で接続先をまとめる

接続先が増えると、ssh -i ~/.ssh/id_ed25519 -p 2222 ubuntu@192.0.2.10 のような長いコマンドを毎回打つことになります。~/.ssh/config に書いておくと、ssh myserver だけで同じ接続ができます。

Host myserver
    HostName 192.0.2.10
    User ubuntu
    Port 2222
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

Host *
    ServerAliveInterval 60
項目意味
Host自分で付ける呼び名。次の Host までの設定がこの名前に効く。「*」はすべての接続先
HostName本当の接続先(IP アドレスやドメイン名)
Userログインするユーザー名
Portポート番号(省略すると 22)
IdentityFile使う秘密鍵のファイル(~ でホームフォルダーを表せる)
IdentitiesOnlyyes にすると、IdentityFile で指定した鍵だけを使う
ServerAliveIntervalサーバーから何も届かない状態が指定した秒数続くと確認の通信を送り、接続が切れにくくする

書いた設定がどう読まれるかは、ssh -G 呼び名 で確かめられます(接続はせずに、最終的な設定を表示するだけです)。上の内容で ssh -G myserver を実行すると、「hostname 192.0.2.10」「user ubuntu」「port 2222」「identityfile ~/.ssh/id_ed25519」と表示されました。

注意したいのは、ssh_config のマニュアルにある「それぞれの設定は、最初に見つかった値が使われる」という決まりです。実際に、ファイルの先頭に「Host *」と「User admin」を書き、その下に myserver の「User ubuntu」を書いたところ、ssh -G の結果は「user admin」になりました。個別の接続先を上に、全体の設定(Host *)を下に書きましょう。

ssh の config の書く順番による違い。Host アスタリスクと User admin を先に書き、その下に Host myserver と User ubuntu を書くと、先に一致した User admin が使われ、ssh -G myserver の結果は user admin になる。Host myserver と User ubuntu を先に書き、その下に Host アスタリスクと User admin を書くと、結果は user ubuntu になる。
図 2:config は最初に見つかった値が使われる

config には接続先の情報が入るので、ssh のマニュアルでは「本人は読み書きでき、ほかの人は書き込めない」パーミッションにすることが求められています(Linux なら chmod 600 ~/.ssh/config)。

よくある間違い・トラブル

「Overwrite (y/n)?」で y を押して、使っている鍵を消してしまう

同じ名前の鍵がすでにあると、「(ファイル名) already exists.」「Overwrite (y/n)?」と聞かれます。ここで y を押すと、今の鍵は新しい鍵に置き換わり、元には戻せません。サーバーや GitHub に登録してある古い公開鍵では、ログインできなくなります。新しい鍵を別に作りたいときは n を押して、-f ~/.ssh/id_ed25519_github のように別の名前を付けます。別の名前にした鍵は、~/.ssh/config の IdentityFile で指定して使います。

PowerShell で -N “” を付けると「Too many arguments.」になる

パスフレーズなしの鍵を一度に作ろうとして、PowerShell 5.1(Windows に最初から入っている PowerShell)で ssh-keygen -t ed25519 -N "" -f test_key を実行すると、「Too many arguments.」と使い方の説明が表示され、鍵は作られませんでした。PowerShell 5.1 は、空の文字列 “” を外部のプログラムに渡さないためです。-N '""' と書くと、パスフレーズなしの鍵ができました。とはいえ、自分用の鍵は -N を使わず、画面でパスフレーズを入力するのがおすすめです。

「WARNING: UNPROTECTED PRIVATE KEY FILE!」と表示される

秘密鍵がほかのユーザーからも読める状態だと、ssh はこの警告と「It is required that your private key files are NOT accessible by others.」「This private key will be ignored.」を表示し、その鍵を使いません。Linux や macOS では chmod 600 ~/.ssh/id_ed25519 で直ります。

なお、Git Bash で Windows のフォルダーにあるファイルに chmod 600 を実行しても、筆者の環境では ls -l の表示は「-rw-r–r–」のまま変わりませんでした。Git Bash は Windows のファイルの権限(アクセス許可)を Linux のようには扱わないためです。chmod の練習や確認は、Linux のサーバー上で行いましょう。

「Permission denied (publickey).」でログインできない

サーバーが、あなたの送った鍵を受け入れなかったという意味です。次の順で確かめます。

  • サーバーや GitHub に登録したのが、使っている秘密鍵とペアの公開鍵か(ssh-keygen -l の指紋を、GitHub の「SSH and GPG keys」の画面に表示される指紋と見比べる)
  • 別の名前で作った鍵を、~/.ssh/config の IdentityFile か ssh -i で指定しているか
  • サーバー側の ~/.ssh(700)と authorized_keys(600)のパーミッション
  • ログインするユーザー名が正しいか(GitHub は必ず git)

ssh -v を付けて接続すると、どの鍵を試したかなどの詳しい経過が表示されます(-vvv まで重ねられます)。

秘密鍵を間違えて貼り付けてしまった

GitHub の入力欄やチャット、課題の提出フォームなどに、.pub の付いていないファイルの中身を貼ってしまった場合は、その鍵は漏れたものとして扱います。鍵を作り直し、古い公開鍵をサーバーの authorized_keys や GitHub の設定から削除してください。

よくある質問

公開鍵のファイルを消してしまいました

秘密鍵が残っていれば、ssh-keygen -y -f ~/.ssh/id_ed25519 で公開鍵を表示し直せます(パスフレーズを付けている場合は聞かれます)。表示された 1 行を .pub のファイルに保存すれば元どおりです。逆に、秘密鍵を失くした場合は公開鍵から作り直すことはできないので、新しい鍵を作ります。

1 つの鍵をいろいろなパソコンで使い回してもいいですか?

秘密鍵はコピーすれば使えますが、置き場所が増えるほど漏れる危険も増えます。パソコンごとに鍵を作り、それぞれの公開鍵を登録するのが一般的です。パソコンを手放すときは、そのパソコンの公開鍵だけを削除すれば済みます。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました