ssh-keygenコマンドでSSH公開鍵認証を設定する方法｜鍵の生成からauthorized_keys設定まで

この記事のポイント

・ssh-keygen -t ed25519 で最新推奨アルゴリズムの鍵ペアを生成できる
・公開鍵は ssh-copy-id またはauthorized_keysに手動追記で登録する
・パーミッション設定（700/600）が間違うとPermission deniedになる
・パスフレーズ＋ssh-agentで安全性と利便性を両立できる

# ed25519アルゴリズムで鍵ペアを生成する（推奨）
$ ssh-keygen -t ed25519 -C "your_email@example.com"

Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519):   ← Enterで規定値
Enter passphrase (empty for no passphrase):                         ← パスフレーズを入力
Enter same passphrase again:
Your identification has been saved in /home/user/.ssh/id_ed25519
Your public key has been saved in /home/user/.ssh/id_ed25519.pub
The key fingerprint is:
SHA256:xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxX your_email@example.com

# ~/.ssh/ ディレクトリを確認する
$ ls -la ~/.ssh/
total 16
drwx------. 2 user user 4096 Apr 13 09:30 .
drwx------. 7 user user 4096 Apr 13 09:30 ..
-rw-------. 1 user user  411 Apr 13 09:30 id_ed25519      ← 秘密鍵（パーミッション600必須）
-rw-r--r--. 1 user user   97 Apr 13 09:30 id_ed25519.pub  ← 公開鍵（.pub付き）

# RSA 4096bit鍵を生成する（旧環境との互換性が必要な場合）
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

# ssh-copy-idで公開鍵をサーバーに登録する
$ ssh-copy-id -i ~/.ssh/id_ed25519.pub user@192.168.1.100

/usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "/home/user/.ssh/id_ed25519.pub"
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s)
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new key(s)
user@192.168.1.100's password:                      ← この1回だけパスワードが必要

Number of key(s) added: 1

Now try logging into the machine, with:   "ssh 'user@192.168.1.100'"

# クライアント側で公開鍵の内容を確認する
$ cat ~/.ssh/id_ed25519.pub
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIxxxxxx... your_email@example.com

# サーバー側で ~/.ssh/authorized_keys に追記する
$ mkdir -p ~/.ssh
$ echo "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIxxxxxx... your_email@example.com" >> ~/.ssh/authorized_keys

# パーミッションを設定する（重要）
$ chmod 700 ~/.ssh
$ chmod 600 ~/.ssh/authorized_keys

# 公開鍵認証で接続できることを確認する
$ ssh user@192.168.1.100
Enter passphrase for key '/home/user/.ssh/id_ed25519':   ← パスフレーズを設定した場合のみ表示
Last login: Sun Apr 13 09:30:00 2026 from 192.168.1.1
[user@server ~]$

# ssh-agentを起動して秘密鍵を登録する
$ eval "$(ssh-agent -s)"
Agent pid 12345

$ ssh-add ~/.ssh/id_ed25519
Enter passphrase for /home/user/.ssh/id_ed25519:   ← この1回だけ入力する
Identity added: /home/user/.ssh/id_ed25519 (your_email@example.com)

# 登録済みの鍵を確認する
$ ssh-add -l
256 SHA256:xXxXxXxXxXxXxXxX your_email@example.com (ED25519)

# ~/.ssh/config の設定例
Host web-server
    HostName 203.0.113.10
    User ec2-user
    IdentityFile ~/.ssh/id_ed25519_webserver

Host db-server
    HostName 203.0.113.20
    User dbadmin
    IdentityFile ~/.ssh/id_rsa_legacy
    Port 22022

# 秘密鍵のパーミッションを確認する（600でなければ修正）
$ ls -la ~/.ssh/id_ed25519
-rw-------. 1 user user 411 Apr 13 09:30 /home/user/.ssh/id_ed25519

# 権限が緩い場合は修正する
$ chmod 600 ~/.ssh/id_ed25519
$ chmod 700 ~/.ssh

# サーバー側で確認する（SSHでログインできる場合）
$ ls -la ~/.ssh/
drwx------. 2 user user 4096 Apr 13 09:30 .
-rw-------. 1 user user  411 Apr 13 09:30 authorized_keys   ← 600必須

$ ls -la ~ | grep .ssh
drwx------. 2 user user 4096 Apr 13 09:30 .ssh   ← 700必須

# /etc/ssh/sshd_config の設定を確認する
$ sudo grep -E "PubkeyAuthentication|AuthorizedKeysFile" /etc/ssh/sshd_config
PubkeyAuthentication yes              ← yesになっていること
AuthorizedKeysFile     .ssh/authorized_keys   ← 標準パス

# -vで詳細ログを出力して原因を特定する
$ ssh -v user@192.168.1.100
...
debug1: Trying private key: /home/user/.ssh/id_ed25519
debug1: Authentications that can continue: publickey,gssapi-keyex,gssapi-with-mic
debug1: No more authentication methods to try.
user@192.168.1.100: Permission denied (publickey).