basforge

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

    EN
    МануалLinuxSSH

    ssh-agent: пароль ключа один раз за сеанс, и почему не ForwardAgent

    Агент держит расшифрованный ключ в памяти и подписывает вход вместо файла: пароль ключа спрашивается один раз, а не при каждом ssh и git push. Пересылку агента на сервер не включаем — для прыжков есть ProxyJump, для git на сервере — deploy key.

    Как работает агент

    ssh web1 ──── «подпиши вызов сервера» ────→ ssh-agent ── ключ расшифрован, в памяти
         ↑                                               │
         └──────────────── подпись ←─────────────────────┘
    сервер проверяет подпись открытым ключом из authorized_keys

    Закрытый ключ из агента не выдаётся — ни ssh, ни кому-то ещё. Агент только подписывает то, что ему дали. Поэтому ssh, scp, git и редактор с удалённой разработкой пользуются одним ключом, а пароль ключа вводится один раз: при ssh-add или при первом входе с AddKeysToAgent yes («~/.ssh/config»).

    Где держать ключ

    Где Как живёт пароль Когда берём
    агент ОС: служба Windows, Keychain в macOS, агент сеанса в Linux Windows хранит добавленный ключ и после перезагрузки — пароль вводится один раз вообще. macOS и Linux — раз за вход в систему один компьютер, один-два ключа
    агент менеджера паролей: KeePassXC, 1Password, Bitwarden ключ лежит в хранилище, агент открывается вместе с ним ключи на нескольких компьютерах, хранилище и так синхронизируется
    аппаратный ключ, ed25519-sk закрытая часть не выходит из устройства; вход — касанием ноутбук, который могут украсть; доступ к важным серверам

    Дальше — агент ОС: он есть везде и ничего не стоит.

    Настройка

    1. Запускаем агент

      Windows. Служба ssh-agent есть в системе, но выключена. PowerShell от администратора:

      Get-Service ssh-agent | Set-Service -StartupType Automatic
      Start-Service ssh-agent
      Get-Service ssh-agent
      # Status   Name        DisplayName
      # Running  ssh-agent   OpenSSH Authentication Agent

      macOS. Агент запускается системой сам.

      Linux с рабочим столом. Агент запускает сеанс: GNOME Keyring или юнит ssh-agent у systemd. Проверка — echo $SSH_AUTH_SOCK не пустой.

      Сервер или консоль без рабочего стола. В текущей оболочке:

      eval "$(ssh-agent -s)"
      # Agent pid 41873
    2. Добавляем ключ

      ssh-add ~/.ssh/id_ed25519
      # Enter passphrase for /home/me/.ssh/id_ed25519:
      # Identity added: /home/me/.ssh/id_ed25519 (laptop-2026)

      В скобках — комментарий ключа из ssh-keygen -C («Ключи SSH»).

      На macOS ключ сохраняем ещё и в Keychain, чтобы пароль не спрашивался после перезагрузки:

      ssh-add --apple-use-keychain ~/.ssh/id_ed25519

      и в ~/.ssh/config для Host * добавляем UseKeychain yes.

    3. Git на Windows — на тот же ssh

      Git for Windows везёт свой ssh.exe, и службу Windows он не видит: git push будет снова спрашивать пароль ключа. Указываем системный:

      git config --global core.sshCommand C:/Windows/System32/OpenSSH/ssh.exe

      Пути — с прямыми слешами: так их понимают и git, и оболочки внутри него.

    4. Ограничиваем, если компьютер общий

      ssh-add -t 8h ~/.ssh/id_ed25519     # ключ уходит из агента через 8 часов
      ssh-add -c ~/.ssh/id_ed25519        # каждое использование — с подтверждением в окне
      ssh-add -D                          # убрать из агента все ключи

      -c требует программу подтверждения (ssh-askpass); без неё подпись молча отклоняется.

    Почему не ForwardAgent

    ssh -A или ForwardAgent yes пробрасывает агент на сервер: там появляется сокет, через который можно подписывать входы своим ключом — например, git pull с GitHub прямо с сервера.

    Подписывать через этот сокет может не только наша сессия. Root на сервере может открыть сокет нашей сессии (его путь — в $SSH_AUTH_SOCK) и, пока мы подключены, может войти нашим ключом на любой сервер и в любой репозиторий, куда этот ключ пускает. Ключ при этом не утекает — утекает возможность им пользоваться. Взломанный сервер — это и есть посторонний root.

    Задача Вместо пересылки агента
    до внутреннего сервера через внешний ProxyJump («~/.ssh/config»): соединение идёт насквозь, агент остаётся на компьютере
    git pull на сервере deploy key на сервере, только на чтение и на один репозиторий («Конфиги серверов в git»)
    скопировать файлы между двумя серверами scp -3 web1:/a web2:/b — через компьютер, или ключ бэкапа с restrict («Ключи SSH»)

    Если пересылка всё-таки нужна — только на одну команду и с подтверждением: ssh-add -c и ssh -A web1. На своих серверах её заодно закрываем: AllowAgentForwarding no («sshd_config»).

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

    Could not open a connection to your authentication agent.

    Причина
    Агент не запущен в этой сессии, или переменная SSH_AUTH_SOCK указывает на сокет, которого уже нет.
    Делаем
    Linux: eval "$(ssh-agent -s)" и ssh-add. Windows: служба ssh-agent — шаг 1.

    На Windows: Error connecting to agent: No such file or directory

    Причина
    Служба ssh-agent остановлена; в Windows она по умолчанию выключена (Disabled).
    Делаем
    Включаем автозапуск и запускаем — шаг 1, в PowerShell от администратора.

    Ключ в агенте, а git push всё равно спрашивает пароль ключа

    Причина
    Git for Windows запускает свой ssh.exe, который не видит службу Windows.
    Делаем
    git config --global core.sshCommand C:/Windows/System32/OpenSSH/ssh.exe.

    sign_and_send_pubkey: signing failed for ED25519 … agent refused operation

    Причина
    Ключ в агенте заблокирован или истёк его срок (ssh-add -t), либо ключ добавлен с подтверждением (-c), а окна для подтверждения нет.
    Делаем
    ssh-add -l — что в агенте; добавляем ключ заново ssh-add ~/.ssh/id_ed25519.

    Ключей в агенте много, сервер рвёт соединение: Too many authentication failures

    Причина
    Агент предлагает все ключи по очереди.
    Делаем
    IdentitiesOnly yes и IdentityFile для хоста («~/.ssh/config»).

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

    Что лежит в агенте:

    ssh-add -l
    # 256 SHA256:u7WTRQvHCGalFd0cVdGQ7Wm7cULmdHtHUpyj6Q0uXcA laptop-2026 (ED25519)

    Пусто — The agent has no identities.

    Вход идёт через агент, а не через файл: в отладке у ключа пометка agent.

    ssh -v web1 true 2>&1 | grep 'Offering'
    # debug1: Offering public key: /home/me/.ssh/id_ed25519 ED25519 SHA256:u7WT… explicit agent

    Пересылки агента на сервер нет:

    ssh web1 'echo ${SSH_AUTH_SOCK:-нет агента}'
    # нет агента