一、什么是凭证
1、凭据简介
有许多第三方网站和应用程序可以与jenkins进行交互，例如代码仓库github等。
此类应用程序的系统管理员可以在应用程序中配置凭证以专供jenkins使用。通常通过将访问控制应用于这些凭证来完成这项工作，以“锁定jenkins可用的应用程序功能区域”。一旦jenkins管理员在jenkins中添加/配置这些凭证，jenkins项目就可以使用凭证与这些第三方应用程序进行交互。
jenkins中保存的凭证可以用于：
- 适用于jenkins的任何地方（即全局证书）。
- 特定的jenkins项目。
- 特定的jenkins用户。
2、凭据分类
jenkins可以保存下面几种凭证：
- secret text：例如 api token（例如github的个人access token）。
- username with password：指的是登录github的用户名和密码，可以作为单独的组件处理，也可以作为username:password格式的冒号分割字符串来处理。
- secret file：实际上是文件中的秘密内容。
- ssh username with private key：即使用私钥的ssh 用户名。这是一个ssh 秘钥对。公钥配置在github上面，这里添加私钥。
- certificate：即证书。一个pkcs#12证书文件和可选的密码。
- docker host certificate authentication：即docker主机证书身份验证凭证。
这些凭证的分类可以在全局凭据里面看到：
3、凭据安全
为了确保安全，jenkins中配置的凭据在jenkins主实例中加密存储（通过jenkins实例的id来加密），并且只能通过它们的凭据id在pipeline项目中处理。
这样就最大限度地减少了向jenkins用户暴露实际证书本身的可能性，并且限制了将功能证书从一个jenkins实例复制到另一个jenkins实例的能力。
二、添加凭据
我们这里以添加ssh username with private key为例，讲解如何添加一个jenkins的凭据。
在上面说过，ssh凭据需要一对私钥，所以我们首先需要生成ssh key。
使用下面的命令可以生成ssh key：
$ ssh-keygen -t rsa -c "your_email@youremail.com"
如下图所示：
所有选项都是默认，一直回车即可生成。生成之后在.ssh文件夹下就会生成文件，如下图所示：
一共会生成两个文件：
- id_rsa。这个是私钥文件。
- id_rsa.pub。这个是公钥文件，需要配置到github上面。
登录github，然后在账户下面选择“settings”：
然后选择“ssh and gpg keys”：
然后点击“new ssh key”，把生成的id_rsa.pub文件里面的内容拷贝进来即可：
这样就添加完成了ssh key。
jenkins在拉取git项目代码的时候，如果没有配置“证书凭证credentials”或者配置的不对，就会出现如下图所示的报错信息：
这时候就需要添加证书凭证credentials，有两种方式添加证书凭证。
1、创建的时候添加
点击credentials后面的"add"，选择“jenkins”，如下图所示：
然后选择“ssh username with private key”，如下图所示：
选择private key，如下图所示：
把上面生成的私钥复制到这里，给username起一个名称即可。
最后点击“添加”按钮即可完成添加ssh 凭证。
注意：这里在拷贝私钥的时候，一定要把生成的私钥文件里面的所有内容都拷贝进来。
在选择凭证的时候选择刚才添加的凭证，这时就不会在报错了：
2、在凭证里面添加
我们也可以在凭据里面添加
同样还是选择“ssh username with private key”，如下图所示：
然后下面的步骤和刚才的就一样了，输入生成的私钥即可。这样就配置好了ssh凭据。
到此这篇关于为jenkins添加ssh全局凭证的文章就介绍到这了。希望对大家的学习有所帮助，也希望大家多多支持。
