前言
随着SHA1算法在2016年12月31日以后,将被强制淘汰,所有新的SSL证书都必须支持SHA256算法,所以我们必须将IBM Domino Server升级到9.0以上才可以支持SHA256算法。同时,以前用来生成Kyr文件的iKeyman5 已经无法再为SHA256的证书服务了,IBM随同Domino 9发布了一个Kyrtool的命令行工具。我们在Domino 9 下必须使用这个工具来完成证书格式的转换。
查找中间证书
为了确保兼容到所有浏览器,我们必须在阿里云上部署中间证书,如果不部署证书,虽然安装过程可以完全也不会报错,但可能导致Android系统,Chrome 和 Firefox等浏览器无法识别。请到 中间证书下载工具,输入您的Server.cer,然后下载中间证书,请将中间证书保存为Chain.cer,请见根证书保存为Root.cer。
安装kyrtool工具
首先请在一台已经安装IBM DOMINO 9 的电脑上下载:kyrtool 1.1工具。
解压文件(kyrtool.exe)到c:\program files\ibm\domino ,即可准备使用。
制作Kyr文件
1、先生成一个新的kyr文件
kyrtool =notes.ini create -k server.kyr -p password
(请在命令行,c:\program files\ibm\domino目录下运行,产生的server.kyr文件在c:\program files\ibm\domino\data目录下)
2、将前面准备好的证书私钥,服务器证书,中间证书,根证书复制到一个文件server.cer,顺序如下:
第一段:私钥 -----BEGIN RSA PRIVATE KEY----- MIIEpAIBAAKCAQEAmEodTcl16P01GbWg2Dr+1FR6Q4D85283ROi7U+eMi6Ex8fF+ IhtB9edaOfywKPgdw1rgCxOIh6kHiiqvZvRvIEacFu0qqBTJeyPmeg== -----END RSA PRIVATE KEY----- 第二段:服务器证书 -----BEGIN CERTIFICATE----- MIIGGzCCBQOgAwIBAgIQP3zt9jHcE2Eo63f6I16j+DANBgkqhkiG9w0BAQsFADBE bcRr/RLp0ziC56tOErlDGmaj1wytlTwSxdG86YinsA== -----END CERTIFICATE----- 第三段:中间证书 -----BEGIN CERTIFICATE----- MIIETzCCAzegAwIBAgIDAjpvMA0GCSqGSIb3DQEBCwUAMEIxCzAJBgNVBAYTAlVT QNaFHlHpURceA1bJ8TCt55sRornQMYGbaLHZ6PPmlH7HrhMvh+3QJbBo+d4IWvMp zNSS -----END CERTIFICATE----- 第四段:根证书 -----BEGIN CERTIFICATE----- MIIDVDCCAjygAwIBAgIDAjRWMA0GCSqGSIb3DQEBBQUAMEIxCzAJBgNVBAYTAlVT 5fEWCRE11azbJHFwLJhWC9kXtNHjUStedejV0NxPNO3CBWaAocvmMw== -----END CERTIFICATE-----
3、检验这个文件 (用命令行,cd到domino目录下,kyr文件在.\data\目录下)
kyrtool =notes.ini verify .\data\server.cer KyrTool v1.1 Successfully read 2048 bit RSA private key INFO: Successfully read 3 certificates INFO: Private key matches leaf certificate INFO: IssuerName of cert 0 matches the SubjectName of cert 1 INFO: IssuerName of cert 1 matches the SubjectName of cert 2 INFO: Final certificate in chain is self-signed
4、 导入这个server.cer到 kyr文件
kyrtool =notes.ini import all -k server.kyr -i .\data\server.cekeytr
5、 检查这个server.kyr文件
kyrtool =notes.ini show keys -k server.kyr kyrtool =notes.ini show certs -k server.kyr
部署Kyr文件到Domino Server
1、将本地SSL密钥环文件(.kyr和.sth 2个文件)复制或FTP到Domino服务器的数据目录中。
2、对SSL密钥环文件设置相应的权限,以确保Domino服务器可以访问文件。 对于Windows,通常在将文件复制/粘贴到服务器时自动设置适当的权限。 对于IBMi / OS400,文件所有者应设置为QNOTES。 对于UNIX,将文件权限设置为拥有所有Domino服务器文件的相同所属标识。
3、更新服务器文档以使用适用于Web服务器配置的适当方法开始使用新的SSL密钥环文件。 (要确认您是否使用Internet Site documents,请打开服务器文档到Basic选项卡,并验证字段“Load Internet configurations from Server\Internet Sites documents”的值,如果这里为启用,您正在使用Internet站点文档,这些文档位于“ Configuration - Web - Internet - Sites”下的Domino目录中。
a、 如果你不使用Internet Site documents,在服务器文档中进入“Ports -> Internet Ports”。 在“SSL key file name”字段中输入Kyr文件名。
b、如果您使用的是Internet Site documents ,找到需要创建SSL Kyr文件的internet Site documnets,然后选择“Security"”选项卡,并将“Key file name”内容更新为已经创建好的Kyr文件(Server.kyr)。
4、确保服务器的SSL端口状态在“Ports -> Internet Ports -> Web”设置为“已启用”。
5、通过在Domino服务器控制台上发出命令“tell http restart”重新启动HTTP任务。 如果其他任务需要使用密钥环,请重新启动这些任务。