配置 SSH 公钥

文章内容

功能介绍
生成公钥
添加公钥

功能介绍

CODING 支持使用 SSH 协议来访问 Git 仓库，提供账户 SSH 公钥和项目 SSH 公钥设置。

一个 SSH 公钥文件，如果和 CODING 账户关联，便称为账户 SSH 公钥，配置后拥有账户下所有项目的读写权限；如果和某一个项目关联，则称为部署公钥，配置后默认拥有该项目的只读权限。

SSH 协议的 Git 仓库地址示例如下图所示：

git@e.coding.net:team-name/project-name.git

生成公钥

执行命令：

ssh-keygen -m PEM -t rsa -b 4096 -C "your.email@example.com"
# Creates a new ssh key, using the provided email as a label
# Generating public/private rsa key pair.
Enter file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]  // 推荐使用默认地址
Enter passphrase (empty for no passphrase):   // 此处不填写，回车即可；如果填写密码，则每次使用 SSH 方式推送代码时都会要求输入密码。

若您需要使用多个 SSH 密钥对（您可能同时在多个代码托管平台工作），在提示“Enter file in which to save the key” 时，输入一个新的文件名称就不会覆盖默认的密钥对。

成功之后显示如下信息：

Your identification has been saved in /Users/you/.ssh/id_rsa.
# Your public key has been saved in /Users/you/.ssh/id_rsa.pub.
# The key fingerprint is:
# 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your.email@example.com

有关 SSH 更多信息可参考维基百科。

添加公钥

CODING 提供账户 SSH 公钥和项目 SSH 公钥设置。本质上账户公钥和部署公钥是一样的，只是关联的方式不同。

添加账户公钥

在终端输入 open ~/.ssh，用文本编辑器打开 id_rsa.pub 文件（此处是生成公钥的默认名称，如果生成公钥时采用了其他名称，打开相对应的文件即可），复制全部内容。

将第一步中复制的内容填写到【公钥内容】一栏，公钥名称按需填写即可。
设定公钥有效期，可选择具体日期或设置永久有效。

点击【添加】，然后输入账户密码即可成功添加公钥。
完成后在命令行测试，首次建立链接会要求信任主机。命令 ssh -T git@e.coding.net

添加部署公钥

在终端输入 open ~/.ssh，用文本编辑器打开 id_deploy.pub 文件（此处部署公钥名称为 id_deploy.pub，您在生成部署公钥的时候完全可以自定义名称），复制全部内容。
登录 CODING，进入目标项目，点击【代码仓库】-> 【仓库设置】-> 【部署公钥】->【新建部署公钥】。

将第一步中复制的内容填写到【公钥内容】一栏，公钥名称自定义。
点击【新建】，然后输入账户密码即可成功添加部署公钥

部署公钥默认拥有该项目的只读权限，如果需要获取推送权限，请勾选部署公钥设置里的【授予推送权限】。

20200813