basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Git и SSH-ключи: deploy key, два аккаунта, подпись коммитов

    Три задачи, которые решаются ключами SSH и псевдонимами в ~/.ssh/config: сервер получает доступ к одному репозиторию и больше ни к чему, на одном компьютере живут два аккаунта GitHub, а коммиты подписываются тем же ключом, что и вход, — и GitHub ставит у них «Verified».

    Как GitHub узнаёт, кто пришёл

    Все ходят на один адрес — [email protected], пользователь всегда git. Кто именно пришёл, GitHub решает по ключу: ключ аккаунта — это аккаунт со всеми его репозиториями, deploy key — один репозиторий. Поэтому разные доступы на одном компьютере — это разные ключи, а выбирает ключ ~/.ssh/config через псевдонимы:

    git@github-infra:example-user/infra-web1.git   → Host github-infra → ключ infra_deploy → один репозиторий
    [email protected]:example-user/notes.git              → Host github.com   → id_ed25519        → личный аккаунт
    git@github-work:work-org/app.git                 → Host github-work  → id_work           → рабочий аккаунт

    Deploy key: сервер видит один репозиторий

    Сервер с git pull в /opt («Конфиги серверов в git») должен читать свой репозиторий — и только его. Ключ личного аккаунта открыл бы все репозитории, а при взломе сервера — их все сразу («Каждый ключ и токен — на один доступ»).

    1. Создаём ключ на сервере

      sudo ssh-keygen -t ed25519 -f /root/.ssh/infra_deploy -C "deploy web1 infra-web1" -N ""

      Без пароля (-N ""): git pull запускается без человека. Это допустимо, потому что ключ открывает один репозиторий, а запись можно не давать. Ключ — у root, потому что /opt принадлежит root.

    2. Добавляем в репозиторий

      sudo cat /root/.ssh/infra_deploy.pub
      # ssh-ed25519 AAAAC3Nza… deploy web1 infra-web1

      На GitHub: репозиторий, Settings, Deploy keys, Add deploy key. «Allow write access» — только если сервер будет делать push; по правилу «на сервере только git pull» не включаем.

    3. Псевдоним в ~/.ssh/config root

      # /root/.ssh/config
      Host github-infra
          HostName github.com
          User git
          IdentityFile /root/.ssh/infra_deploy
          IdentitiesOnly yes

      Проверяем вход: для deploy key GitHub здоровается именем репозитория:

      sudo ssh -T github-infra
      # Hi example-user/infra-web1! You've successfully authenticated, but GitHub does not provide shell access.
    4. Адрес репозитория — через псевдоним

      cd /opt
      sudo git remote set-url origin git@github-infra:example-user/infra-web1.git
      sudo git pull

    Два аккаунта на одном компьютере

    1. Второй ключ — для рабочего аккаунта

      ssh-keygen -t ed25519 -f ~/.ssh/id_work -C "work laptop-2026"

      .pub добавляем в рабочий аккаунт GitHub (Settings, SSH and GPG keys).

    2. Псевдоним

      # ~/.ssh/config — выше блока Host *
      Host github-work
          HostName github.com
          User git
          IdentityFile ~/.ssh/id_work
          IdentitiesOnly yes
      
      Host github.com
          IdentityFile ~/.ssh/id_ed25519
          IdentitiesOnly yes

      IdentitiesOnly yes у обоих: иначе агент предложит первый подошедший ключ, и GitHub пустит не тем аккаунтом.

    3. Рабочие репозитории — через псевдоним и со своей почтой

      git clone git@github-work:work-org/app.git ~/work/app

      Почта для всех репозиториев в ~/work/ — через includeIf в ~/.gitconfig («~/.gitconfig по блокам»):

      # ~/.gitconfig-work
      [user]
          email = [email protected]

    Подпись коммитов SSH-ключом

    С git 2.34 коммиты подписываются SSH-ключом, GPG не нужен. GitHub показывает у таких коммитов «Verified»: коммит сделал владелец ключа, а не кто-то, кто вписал чужое имя в user.name.

    1. Включаем подпись

      git config --global gpg.format ssh
      git config --global user.signingKey ~/.ssh/id_ed25519.pub
      git config --global commit.gpgSign true
      git config --global tag.gpgSign true

      user.signingKey — путь к открытой половине: подписывает агент закрытой («ssh-agent»), пароль ключа второй раз не спросят.

    2. Ключ подписи — в GitHub

      Settings, SSH and GPG keys, New SSH key, тип Signing Key. Тот же .pub, что для входа, но отдельной записью: ключ входа подписи не проверяет.

    3. Проверка подписи у себя

      Без списка доверенных ключей git log --show-signature пишет error: gpg.ssh.allowedSignersFile needs to be configured and exist for ssh signature verification и No signature, хотя подпись есть. Список — в файле:

      mkdir -p ~/.config/git
      echo "[email protected] namespaces=\"git\" $(cat ~/.ssh/id_ed25519.pub)" \
        >> ~/.config/git/allowed_signers
      git config --global gpg.ssh.allowedSignersFile ~/.config/git/allowed_signers

    Если не работает

    ERROR: The key you are authenticating with has been marked as read only.

    Причина
    Deploy key добавлен без «Allow write access», а с сервера делают git push.
    Делаем
    Так и задумано, если сервер только читает. Если сервер должен пушить — включаем запись у этого ключа в настройках репозитория.

    GitHub не даёт добавить ключ: Key is already in use

    Причина
    Один ключ — один deploy key одного репозитория или ключ одного аккаунта. Повторно его не принимают.
    Делаем
    Для второго репозитория — свой ключ и свой псевдоним в ~/.ssh/config.

    Push идёт под другим аккаунтом: Permission to work-org/app.git denied to example-user

    Причина
    ssh предложил первый подошедший ключ — личный. GitHub узнаёт аккаунт по ключу, а не по адресу.
    Делаем
    Псевдоним github-work с IdentityFile и IdentitiesOnly yes, и адрес репозитория — через него: git remote set-url origin git@github-work:work-org/app.git.

    Коммиты на GitHub подписаны чужим именем или без аватара

    Причина
    В коммите почта, которой нет в аккаунте: в рабочем репозитории осталась личная, или наоборот.
    Делаем
    includeIf с другой почтой для ~/work/ («~/.gitconfig по блокам»); проверка — git config user.email в каталоге репозитория.

    error: gpg failed to sign the data

    Причина
    Включена подпись (commit.gpgSign), а формат остался openpgp: git ищет gpg и ключ GPG.
    Делаем
    git config --global gpg.format ssh и user.signingKey — путь к .pub.

    У подписанных коммитов на GitHub — «Unverified»

    Причина
    Ключ добавлен в GitHub как ключ входа (Authentication), а для подписи нужна отдельная запись Signing Key. Или почта коммита не подтверждена в аккаунте.
    Делаем
    Settings, SSH and GPG keys, New SSH key, тип Signing Key — тот же .pub.

    Как проверить

    Каждый псевдоним приводит в свой аккаунт:

    ssh -T [email protected]
    # Hi example-user! You've successfully authenticated, but GitHub does not provide shell access.
    ssh -T github-work
    # Hi work-user! You've successfully authenticated, but GitHub does not provide shell access.

    Последний коммит подписан:

    git log --show-signature -1 --format='%h %s'
    # Good "git" signature for [email protected] with ED25519 key SHA256:u7WT…
    # 3e2d1c traefik: readTimeout 300s