配置 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 公钥设置。本质上账户公钥和部署公钥是一样的,只是关联的方式不同。
一个 SSH 公钥文件,如果和 CODING 账户关联,便称为账户 SSH 公钥,配置后拥有账户下所有项目的读写权限;如果和某一个项目关联,则称为部署公钥,配置后默认拥有该项目的只读权限。
添加账户公钥
- 在终端输入
open ~/.ssh
,用文本编辑器打开id_rsa.pub
文件(此处是生成公钥的默认名称,如果生成公钥时采用了其他名称,打开相对应的文件即可),复制全部内容。
- 登录 CODING ,点击右上角【个人设置】,选择菜单【SSH 公钥】,点击【新增公钥】按钮。
将第一步中复制的内容填写到【公钥内容】一栏,公钥名称按需填写即可。
设定公钥有效期,可选择具体日期或设置永久有效。
点击【添加】,然后输入账户密码即可成功添加公钥。
完成后在命令行测试,首次建立链接会要求信任主机。命令
ssh -T git@e.coding.net
添加部署公钥
在终端输入
open ~/.ssh
,用文本编辑器打开id_deploy.pub
文件(此处部署公钥名称为id_deploy.pub
,您在生成部署公钥的时候完全可以自定义名称),复制全部内容。登录 CODING,进入目标项目,点击【代码仓库】-> 【仓库设置】-> 【部署公钥】->【新建部署公钥】。
将第一步中复制的内容填写到【公钥内容】一栏,公钥名称自定义。
点击【新建】,然后输入账户密码即可成功添加部署公钥
部署公钥默认拥有该项目的只读权限,如果需要获取推送权限,请勾选部署公钥设置里的【授予推送权限】。
