【Git】Permission denied (publickey)を完全解決｜10パターン診断＆1Password SSH Agent時代のモダン運用

$ git clone git@github.com:user/repo.git
Cloning into 'repo'...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

# ■ 20秒：SSH鍵の存在確認
ls -al ~/.ssh
# id_ed25519.pub / id_rsa.pub があれば鍵は存在
# なければ「鍵未作成」確定 → ed25519で新規作成へ

# ■ 40秒：SSH接続テスト（verbose）
ssh -vT git@github.com
# 最後の数行を見ると原因がほぼ分かる：
#   "Offering public key:" → 鍵は送っている
#   "Authentications that can continue: publickey" → 鍵が拒否された
#   "no such identity" → 鍵がagentに読み込まれてない
#   "Permission denied (publickey)" → GitHub側に未登録

# ■ 60秒：リモートURL方式確認
git remote -v
# git@github.com:... → SSH方式（このエラー対象）
# https://github.com/... → HTTPS方式（別のエラー）

# ed25519（推奨）
ssh-keygen -t ed25519 -C "your_email@example.com"

# 出力例：
# Generating public/private ed25519 key pair.
# Enter file in which to save the key (~/.ssh/id_ed25519): [Enter]
# Enter passphrase (empty for no passphrase): [推奨: 設定]
# Enter same passphrase again: [Enter]

# 古い環境でRSAが必要なら4096bit必須
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

# 確認
ls -la ~/.ssh/
# id_ed25519      ← 秘密鍵（絶対に外部へ出さない）
# id_ed25519.pub  ← 公開鍵（GitHub等に登録する方）

# 公開鍵をクリップボードにコピー
# macOS
pbcopy < ~/.ssh/id_ed25519.pub

# Linux
xclip -selection clipboard < ~/.ssh/id_ed25519.pub

# Windows（Git Bash）
cat ~/.ssh/id_ed25519.pub | clip

# または表示してコピー
cat ~/.ssh/id_ed25519.pub

# GitHub
ssh -T git@github.com
# 成功例: Hi username! You've successfully authenticated...

# GitLab
ssh -T git@gitlab.com

# Bitbucket
ssh -T git@bitbucket.org

# Azure DevOps
ssh -T git@ssh.dev.azure.com

# ssh-agent 起動（Linux/Git Bash）
eval "$(ssh-agent -s)"

# 鍵をロード
ssh-add ~/.ssh/id_ed25519

# ロード済み鍵の確認
ssh-add -l

# 全鍵を削除
ssh-add -D

# 鍵を一時期間だけロード（1時間=3600秒）
ssh-add -t 3600 ~/.ssh/id_ed25519

# ~/.ssh/config に追加
cat >> ~/.ssh/config << "EOF"
Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519
EOF

# Keychainに鍵を追加（パスフレーズはKeychainに保存）
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

# 以降、再起動後も自動でssh-agentが使える

# ~/.config/systemd/user/ssh-agent.service
mkdir -p ~/.config/systemd/user/
cat > ~/.config/systemd/user/ssh-agent.service << "EOF"
[Unit]
Description=SSH key agent

[Service]
Type=simple
Environment=SSH_AUTH_SOCK=%t/ssh-agent.socket
ExecStart=/usr/bin/ssh-agent -D -a $SSH_AUTH_SOCK

[Install]
WantedBy=default.target
EOF

systemctl --user enable --now ssh-agent

# 環境変数を.bashrcに
echo 'export SSH_AUTH_SOCK="$XDG_RUNTIME_DIR/ssh-agent.socket"' >> ~/.bashrc

# PowerShellを管理者権限で起動
# OpenSSH Authentication Agentサービスを自動起動に
Set-Service -Name ssh-agent -StartupType Automatic
Start-Service ssh-agent

# 鍵をロード（PowerShell）
ssh-add $env:USERPROFILE\.ssh\id_ed25519

# Git for Windows のGit Bashは別のssh-agent実装を使う場合あり
# 統一するなら GIT_SSH 環境変数で OpenSSH を指定
$env:GIT_SSH = "C:\Windows\System32\OpenSSH\ssh.exe"

# ~/.ssh/config
cat > ~/.ssh/config << "EOF"
# 個人アカウント（デフォルト）
Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_personal
  AddKeysToAgent yes

# 会社アカウント（ホスト名を別名に）
Host github-work
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_work
  AddKeysToAgent yes

# プライベートGitHub Enterprise
Host github-enterprise
  HostName github.enterprise.example.com
  User git
  IdentityFile ~/.ssh/id_ed25519_ent
  Port 22
EOF

# 権限設定
chmod 600 ~/.ssh/config

# 会社のrepo（github-work alias使用）
git clone git@github-work:company/repo.git
# → ssh configで id_ed25519_work が使われる

# 個人のrepo（通常のgithub.com）
git clone git@github.com:personal/repo.git
# → id_ed25519_personal が使われる

# 既存remote URLを alias に変更
git remote set-url origin git@github-work:company/repo.git

# ユーザー名／メールもrepoごとに変える
cd company-repo
git config user.name "Work Taro"
git config user.email "taro@company.com"

# 1Password v8+ の Developer設定で SSH Agent を有効化
# 鍵を1Passwordに保存（アプリ内で新規作成 or 既存鍵インポート）

# ~/.ssh/config に以下を追加
cat >> ~/.ssh/config << "EOF"
Host github.com
  IdentityAgent "~/Library/Group Containers/2BUA8C4S2C.com.1password/t/agent.sock"
  IdentityFile ~/.ssh/id_ed25519_1password.pub
  IdentitiesOnly yes
EOF
# Windowsの場合のパス：
# IdentityAgent \\.\pipe\openssh-ssh-agent

# 接続時にTouch ID／Windows Hello等で認証される
ssh -T git@github.com

$ ssh -vT git@github.com

# 1. 使おうとしているconfig
debug1: Reading configuration data /Users/user/.ssh/config
# → このconfigパスを使っている

# 2. 接続先とポート
debug1: Connecting to github.com [140.82.x.x] port 22.

# 3. 試す鍵の順序
debug1: Will attempt key: /Users/user/.ssh/id_ed25519 ED25519
debug1: Offering public key: /Users/user/.ssh/id_ed25519 ED25519
# → この鍵を送っている

# 4. サーバーの応答
debug1: Authentications that can continue: publickey
# → GitHubが鍵を受け取ったが認証失敗（未登録か別ユーザーの鍵）

# 5. 最終結果
git@github.com: Permission denied (publickey).

# 専用の鍵ペアをCI用に生成
ssh-keygen -t ed25519 -f ~/.ssh/deploy_key -N ""

# 公開鍵をGitHubのリポジトリに登録
# Settings → Deploy keys → Add deploy key
# Title: "CI Deploy Key"
# Key: 公開鍵内容を貼り付け
# Allow write access: 必要なら有効化

# 秘密鍵をCI環境のSecretに登録
cat ~/.ssh/deploy_key
# → GitHub Actions: Settings → Secrets → DEPLOY_KEY

name: Deploy
on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: webfactory/ssh-agent@v0.9.0
        with:
          ssh-private-key: ${{ secrets.DEPLOY_KEY }}
      - uses: actions/checkout@v4
        with:
          ssh-key: ${{ secrets.DEPLOY_KEY }}

# 設定：HTTPSをSSHに書き換え
git config --global url."git@github.com:".insteadOf "https://github.com/"

# これで https://github.com/user/repo.git を渡しても
# 内部的に git@github.com:user/repo.git として扱われる

# 確認
git clone https://github.com/user/repo.git
# → 実際はSSH接続（認証にSSH鍵が使われる）

# 逆方向（SSH→HTTPS）も可能
git config --global url."https://github.com/".insteadOf "git@github.com:"

# 鍵生成
ssh-keygen -t ed25519 -C "your_email@example.com"

# agent起動＋ロード
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# 公開鍵コピー → GitHub Settings → SSH keys で登録
cat ~/.ssh/id_ed25519.pub | pbcopy    # macOS

# 接続テスト
ssh -T git@github.com

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_work -C "work@company.com"

# ~/.ssh/configに会社用Host追加（本文参照）
# 会社GitHub で公開鍵登録

# 会社repoをclone
git clone git@github-work:company/repo.git
cd repo
git config user.email "work@company.com"

# CI専用鍵を生成（パスフレーズなし）
ssh-keygen -t ed25519 -f /tmp/deploy_key -N ""

# 公開鍵 → GitHub repo Settings → Deploy keys
# 秘密鍵 → GitHub Actions Secrets (DEPLOY_KEY)

# workflow YAML で webfactory/ssh-agent アクション使用

# WSLに入る
wsl

# WSL内で鍵生成
ssh-keygen -t ed25519 -C "your_email@example.com"

# ~/.ssh の権限確認
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

# GitHub登録後 → 接続テスト
ssh -T git@github.com