前言:
增加ssl(https)的访问可以为部署在公网下的jenkins提供更安全的问题,最明显的好处应该是登录和jenkins-ci.jar的调用。
比如jenkins-ci.jar的调用,一般在windows下通过明文账号密码的传输请求是非常不安全的;有关windows配置和实践参考以下文章:
(这篇是关于windows的配置方法)
(这个是对jenkins-ci.jar的用法实践)
关于自签名证书的不安全性探讨:
参考:
个人看法,如果要真正安全,可以考虑购买由权威机构颁发的证书;虽然自签名证书不安全,但是我觉得在一定程度上加密的传输流程上会增加破解的难度。
还有什么方法可以代替jenkins在ssl(https)的安全:
我觉得如果在公开的外网访问web上,应该没有比部署ssl更安全的方案。但是可以通过以下技巧使安全得到进一步增强:
1、对于部署到外网的jenkins使用vpn的登录机制,只有公司内部的人员才能有权限登录vpn连接和操作jenkins。
2、全程内网进行管理,不接触外网。
3、如果要调用jenkins-ci.jar功能,在linux下推荐使用ssh的key进行登录去操作。
以下为具体的部署步骤:
原理:使用了java自带的keytool工具来操作。keytool可以走只生成请求证书,然后提供到正规权威机构获取正规证书,也可以生成自签名证书。
1、正规流程申请权威机构正规证书:
keytool放置在jdk的jre/bin文件夹下,如果是windows使用msi安装的jenkins,放置在:C:\Program Files (x86)\Jenkins\jre\bin
参考:
以下以windows安装版为讲解步骤
①在服务器上创建一个新的密钥库。这将在当前目录中放置一个“keystore”文件。
C:\Program Files (x86)\Jenkins\jre\bin>keytool -genkeypair -keysize 2048 -keyalg RSA -alias jenkins -keystore keystoreEnter keystore password:Re-enter new password:What is your first and last name?[Unknown]: server-name.your.company.comWhat is the name of your organizational unit?[Unknown]: Your CityWhat is the name of your organization?[Unknown]: Your company nameWhat is the name of your City or Locality?[Unknown]: Your cityWhat is the name of your State or Province?[Unknown]: Your StateWhat is the two-letter country code for this unit?[Unknown]: USIs CN=server-name.your.company.com, OU=Your City, O=Your company name, L=Your City, ST=Your State, C=US correct?[no]: yesEnter key password for(RETURN if same as keystore password):
②验证密钥库是否已创建(您的指纹会有所不同)
C:\Program Files (x86)\Jenkins\jre\bin>keytool -list -keystore keystoreEnter keystore password:Keystore type: JKSKeystore provider: SUNYour keystore contains 1 entryjenkins, May 6, 2015, PrivateKeyEntry,Certificate fingerprint (SHA1): AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA:AA
③创建证书请求。这将在当前目录中创建一个“certreq.csr”文件。
C:\Program Files (x86)\Jenkins\jre\bin>keytool -certreq -alias jenkins -keyalg RSA -file certreq.csr -keystore keystoreEnter keystore password:
④使用'certreq.csr'文件的内容从证书提供者生成证书。请求SHA-1证书(SHA-2未经测试,但可能会工作)。如果使用DigiCert,请将生成的证书下载为其他格式“.p7b文件中的所有证书的.p7b软件包”(这一步就是向正规机构购买证书然后导出p7b的过程)
⑤将生成的.p7b添加到您上面创建的密钥库中。
C:\Program Files (x86)\Jenkins\jre\bin>keytool -import -alias jenkins -trustcacerts -file response_from_digicert.p7b -keystore keystoreEnter keystore password:Certificate reply was installed in keystore
⑥将'keystore'文件复制到您的Jenkins secrets目录。在股票安装中,这将在
C:\Program Files (x86)\Jenkins\secrets
⑦修改C:\ Program Files(x86)\ Jenkins \ jenkins.xml文件的<arguments>部分以反映新的证书。注意:此示例通过httpPort = -1禁用http,并通过httpsPort = 8443将服务器放置在8443上
-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -jar "%BASE%\jenkins.war" --httpPort=-1 --httpsPort=8443 --httpsKeyStore="%BASE%\secrets\keystore" --httpsKeyStorePassword=your.password.here
⑧重新启动jenkins服务以初始化新配置。
net stop jenkinsnet start jenkins
⑨30-60秒后,Jenkins将完成启动过程,您应该可以访问该网站https://server-name.your.company.com:8443; 通过浏览器的工具验证证书看起来不错。如果服务立即终止,您的配置中会出现错误。有用的错误信息可以在以下位置找到:
C:\Program Files (x86)\Jenkins\jenkins.err.logC:\Program Files (x86)\Jenkins\jenkins.out.log
注意:以上过程为windows安装版的生成过程,如果使用jdk的keytool去操作,步骤不变,只是路径变了。
2、证书在其它启动方式上的配置:
如果使用war包安装的方式,则将使用如下命令进行启动:
java -jar jenkins.war --httpPort=-1 --httpsPort=443 --httpsKeyStore=path/to/keystore --httpsKeyStorePassword=keystorePassword
可以看出,只要指定https的文件和密码即可。和上面的原理不变。
如果使用tomcat这样的第三方容器,那么原理也是一样的,都是配置容器的https证书的位置。比如tomcat的配置如下:
//修改server.xml文件
同样是修改https证书的位置和密码。
3、使用keytool生成自签名证书
参考:
提示:以下步骤是生成自签名的过程,生成后配置启动参考上面的。
①生成根证书
keytool -genkeypair -alias ROOTCERT -keyalg RSA -keystore rootlib.jks命令解释:生成一对RSA非对称密钥和一个自签名证书,以别名ROOTCERT存储在rootlib中。注意:enter后,会提示输入密钥库的使用口令,和填写相关OU,CN等信息。之后会在你的当前工作目录下生成一个rootlib.jks的文件。
②生成证书请求
1)keytool -genkeypair -alias SERVERCERT -keyalg RSA -keystore serverlib.jks (跟①步骤一样)。注意:此时”您的名字与姓氏是什么” ,需要输入localhost(就是证书请求者的域名)。2)keytool -certreq -file server.csr -alias SERVERCERT -keystore serverlib.jks命令解释:在serverlib文件中从别名为SERVERCERT中取出公钥和用户信息生 成证书请求,并写入到server.csr文件中。之后会在你的当前工作目录下生成一个server.csr的文件。
③用根证书对证书请求签名,生成应用证书
keytool -gencert -infile server.csr -outfile servercert.cer -alias ROOTCERT -keystore rootlib.jks命令解释:使用别名为ROOTCERT的私钥对server.csr证书请求进行签发证书,并导入到servercert.cer 文件中。
④导出根证书,添加为客户端受信任的根证书颁发机构中
keytool -exportcert -alias ROOTCERT -file root.cer -keystore rootlib.jks命令解释:从rootlib.jks将别名ROOTCERT的证书导出到root.cer文件中
⑤导入证书到jks文件中
1)我们先要更新serverlib.jks中的证书(用根证书签发好的应用证书--servercert.cer)keytool -importcert -alias SERVERCERT -file servercert.cer -keystore serverlib.jks此时会报:无法从回复中建立链(这是因为更新的证书无法信任)。我们先要将根证书导入到serverlib.jks中,使之信任2)keytool -importcert -alias TRUSTCERT -file root.cer -keystore serverlib.jks3)这时在执行1)中的命令,即可更新。
注意:更新证书时的别名不能写错,否则keytool工具会认为添加。
⑥配置启动
最后得到serverlib.jks文件就是我们需要的,通过上面的步骤配置启动即可。
线索参考:
关键字:keytool生成自签名证书