github和ssh-agent

在用ssh访问github的时候,需要设置ssh的代理程序 ssh-agent。

因为git的安全连接需要ssh提供,而ssh为其他程序提供安全连接的功能由 ssh-agent 完成。

SSH 只是一种协议,其开源实现有 OpenSSH,并且存在服务端(sshd) 和 客户端 (ssh),Windows 中的客户端有 PuTTY;而这两种客户端都有各自的 ssh agent:

ssh-agent 命令:是客户端 ssh 的默认代理
Pageant : 是 客户端 PuTTY 的代理。Pageant是用于PuTTY,PSCP,PSFTP和Plink的SSH身份验证代理。 Pageant会存储您的私钥,只要它正在运行,它就会为PuTTY或其他工具(如IntelliJ IDEA)提供解锁的私钥。(当然ssh-agent也能做)

把私钥交给 ssh agent 管理的好处:

当 其他程序 需要身份验证的时候 可以将验证申请交给 ssh-agent 来完成整个认证过程 。如 git

避免重复输入密码:如果您的私钥使用密码短语来加密了的话,每一次使用 SSH 密钥对 进行登录的时候,您都必须输入正确的密码短语。而 SSH agent 程序能够将您的已解密 的私钥缓存起来,在需要的时候提供给您的 SSH 客户端。

总之,ssh-agent 就是为程序提供ssh服务的代理,这里的程序包括ssh自己的客户端。

ssh-agent的用法:

eval `shell-agent` ,或 eval $(ssh-agent) : 它并不会启动一 个子 shell,而是直接启动一个 ssh-agent 进程;

此时当我们退出当前 bash 后 ,ssh-agent 进程并不会自动关闭。我们可以在当前 bash 退出之前,使用 ssh-agent -k ,或者在当前 bash 退出之后,使用 kill 命令,关闭对应的 ssh-agent 进程。

ssh-agent 相关问题
当我们在中尝试使用 Git 并通过 SSH 协议进行 push 或 pull 时,如果远程 Github 服务 器无法使用 SSH agent 提供的密钥进行身份验证,则可能会收到下面的某一条消息:

Permission denied (publickey)
No suitable response from remote
repository access denied
可能的两种原因:

你的 公钥 并没有添加到 Github 服务器中。检查 GitHub 是否有添加。

您的密钥未加载到 ssh agent 中 。解决方法:

检查相应的 ssh 密钥是否被加载:
ssh-add -l
如果没有被加载,则使用下面的命令加载私钥
#后面可以同时跟多个私钥
ssh-add ~/.ssh/<private_key_file>
运行 ssh-add 时, 如果提示 “Could not open a connection to your authentication agent.” 说明你的ssh-agent并没有运行;使用下面的命令运行 ssh agent,再使用ssh-add命令添加你的 ssh key。
# 先启动,再运行
# macOS/Linux
$ eval `ssh-agent`
ssh-add ~/.ssh/other_id_rsa

# 在Windows中的git-bash中
$ eval $(ssh-agent)
ssh-add ~/.ssh/other_id_rsa

配置 ssh-agent 自动启动🔗

git bash
方式一: Git for windows 提供的方式

在 .profile 或 .bashrc 添加 :

# 在.profile 或 .bashrc 添加
# Git for windows 提供的方式
# ssh-agent auto-launch (0 = agent running with key; 1 = w/o key; 2 = not run.)
agent_run_state=$(ssh-add -l >| /dev/null 2>&1; echo $?)
if [ $agent_run_state = 2 ]; then
eval $(ssh-agent -s)
ssh-add ~/.ssh/one_rsa # 添加你自己的私钥
ssh-add ~/.ssh/two_rsa
elif [ $agent_run_state = 1 ]; then
ssh-add ~/.ssh/one_rsa
ssh-add ~/.ssh/two_rsa
fi
# 记得还要在 ~/.bash_logout 中添加,来关闭 ssh-agent
# ssh-agent -k
新建 ~/.bash_logout 文件,添加:

# 记得还要在 ~/.bash_logout 中添加,来关闭 ssh-agent
ssh-agent -k

方式二:GitHub 提供的方式

复制以下行并将其粘贴到 Git shell 中的 ~/.profile 或 ~/.bashrc 文件中:

env=~/.ssh/agent.env

agent_load_env () { test -f "$env" && . "$env" >| /dev/null ; }

agent_start () {
(umask 077; ssh-agent >| "$env")
. "$env" >| /dev/null ; }

agent_load_env

# agent_run_state: 0=agent running w/ key; 1=agent w/o key; 2= agent not running
agent_run_state=$(ssh-add -l >| /dev/null 2>&1; echo $?)

if [ ! "$SSH_AUTH_SOCK" ] || [ $agent_run_state = 2 ]; then
agent_start
ssh-add ~/.ssh/one_rsa # 添加你自己的私钥
elif [ "$SSH_AUTH_SOCK" ] && [ $agent_run_state = 1 ]; then
ssh-add ~/.ssh/one_rsa
fi

unset env
现在,当您初次运行 Git Bash 时,系统将提示您输入密码:

> Initializing new SSH agent...
> succeeded
> Enter passphrase for /c/Users/you/.ssh/id_rsa:
> Identity added: /c/Users/you/.ssh/id_rsa (/c/Users/you/.ssh/id_rsa)
> Welcome to Git (version 1.6.0.2-preview20080923)
>
> Run 'git help git' to display the help index.
> Run 'git help ' to display help for specific commands.
ssh-agent 进程将继续运行,直到您注销、关闭计算机或终止该进程。

ssh-agent 相关命令解释

# 在子shell 创建并运行 ssh-agent
ssh-agent $SHELL

# 单独启动一个 ssh-agent 进程
eval `ssh-agent`
# 在windows 中为
eval $(ssh-agent)

# 杀死当前正在运行的代理 (注意使用条件)
ssh-agent -k

# 一般是使用默认shell进行输出
# 强制使用 C-shell 进行输出
ssh-agent -c
# 强制使用 sh 进行输出
ssh-agent -s

# 进入 debug 模式
ssh-agent -d

# 指定用于生成SSH密钥指纹的算法。 有效值包括md5和sha256
ssh-agent -E <fingerprint_hash>

ssh-add 相关命令解释

# 将私钥添加到 ssh-agent
ssh-add ~/.ssh/key_name

# 添加时同时指定私钥失效时间
ssh-add -t <seconds>

# 查看ssh-agent中的私钥
ssh-add -l

# 查看ssh-agent中的公钥
ssh-add -L

# 测试连接(这里是github)
ssh -T git@github.com

# 移除指定私钥
ssh-add -d ~/.ssh/key_name

# 移除ssh-agent 中的所有私钥
ssh-add -D

# 锁定ssh-agent :创建锁时需要设置密码
ssh-add -x

# 解锁 ssh-agent :输入密码
ssh-add -X

为私钥添加或更改密码

$ ssh-keygen -p
# Start the SSH key creation process
> Enter file in which the key is (/Users/you/.ssh/id_rsa): [Hit enter]
> Key has comment '/Users/you/.ssh/id_rsa'
> Enter new passphrase (empty for no passphrase): [Type new passphrase]
> Enter same passphrase again: [One more time for luck]
> Your identification has been saved with the new passphrase.

相关阅读和参考:

https://www.ssh.com/ssh/agent
https://help.github.com/en/github/authenticating-to-github/working-with-ssh-key-passphrases
https://github.com/git-for-windows/git/wiki/Auto-launching-ssh-agent-when-git-starts
https://www.thisfaner.com/p/ssh-agent/

 

posted @ 2022-04-02 09:10  立体风  阅读(474)  评论(0编辑  收藏  举报