Android 的签名有两种方式,一种使用jdk 提供的jarsigner工具签名keystore 文件,另一种是Android 自己提供的signapk.jar 通过.pk8(密钥) 和.x509.pem(证书)两个签名文件完成签名。
之前对一个包签名都是直接使用signapk来的,因为不需要输入密码即可直接签名,简单直接,今天上传百度时遇到问题了,下载下来签名说明文档后说需要使用jarsigner 来签名,于是研究了下两个签名之间相互转换的问题。
并且为了降低以后再次遇到这类问题时查找资料的成本,写了个简易的bat脚本半自动化操作。
工具:
openssl 安装完成之后, 将bin目录加入环境变量即可使用openssl
keytool jdk/bin目录下的工具
signapk.jar 用于Android签名的工具(源码在aosp的源代码下)
jarsigner jdk 中的工具,用于给jar签名(也可以给任意一个zip包签名)
一、两种不同签名方案的签名过程
1、jarsigner 是jdk 提供的工具,安装jdk之后就可以使用了,使用jarsigner签名的命令如下:
jarsigner -verbose -storepass 12345678 -keystore testkey.jks -signedjar signed_out.apk 111.zip testkey
其中
-verbose 表示输出详细信息
-storepass 表示签名库的密码
-keystore 表示签名文件路径
-signedjar 表示签名后输出文件路径
最后跟需要签名的 文件路径 和 keystore 的别名
详细参数可以通过 jarsigner -help 查看,中文的还是很清楚。
2、signapk 是android 提供的单独为apk签名的工具,使用方法:
java -jar signapk.jar testkey.x509.pem testkey.pk8 111.zip signed_out.apk
可知,jarsigner 签名需要提供一个签名文件jks 和签名库密码,并且如果签名库密码跟密钥密码不同还需另外提供密钥密码;(下文我们称jks 签名或jks签名库)
signapk 签名只需提供一个pk8文件和一个x509.pem文件即可。(下文将这两个文件简称为pk8签名)
二、将pk8签名转换为jks 签名库
接下来我们解决百度渠道的签名问题,第一步就需要将我们的pk8签名 转换为 jks签名。
通过网上搜索,我们了解到java签名库文件通常的后缀有.keystore 和.jks,因此我们可以认为之前eclipse时代的.keystore签名与Android Studio 时代的.jks 签名是相同格式的。
现在我们有pk8签名,可以使用openssl 和keytool 两个工具来将其合并到jks签名库
下面以实例介绍将testkey.pk8/testkey.x509.pem 签名文件 合并到testkey.jks 签名库,并设置其密码12345678和别名testkey
a)
openssl pkcs8 -inform DER -nocrypt -in testkey.pk8 -out testkey.pem
使用 open ssl 将pk8 解密为 pem 文件, 此时生成一个testkey.pem 文件
b)
openssl pkcs12 -export -in testkey.x509.pem -inkey testkey.pem -out platform.p12 -password pass:12345678 -name testkey
将两个pem 文件导入platform.p12文件中,并设置 别名 testkey 和keypass 密码:12345678 (别名和密码可自定义)
会新生成 platform.p12
c)
keytool -importkeystore -deststorepass 12345678 -destkeystore testkey.jks -srckeystore platform.p12 -srcstoretype PKCS12 -srcstorepass 12345678
使用keytool 将之前生成的platform.p12导入 testkey.jks 签名中,并设置storepass密码(12345678)
需要正确提供keypass 密码
此时即生成了需要的testkey.jks 签名文件
d)
keytool -list -v -keystore testkey.jks
查看生成的 签名信息
注意: storepass 和 keypass 可以不同
两个密码相同情况下 使用jarsigner 签名时只需提供storepass即可
否则需要提供两个密码
keytool -list 查看时只需提供storepass即可
有了jks签名库,我们为空包签名
jarsigner -verbose -storepass 12345678 -keystore testkey.jks -signedjar jks_out.apk 111.zip testkey
命令通过提供-stroepass(密码) 和别名(testkey) 将输入文件111.zip 签名为jks_out.apk
接下来我们提供一个将pk8签名生成jks的简易bat脚本, 脚本中需要配置 openssl keytool 路径,并且手动设置需要签名的文件名。
脚本见文章末尾github代码库中 cvt2jks.bat
工具运行目录如下
三、从将jks签名库中抽取pk8签名
openssl能够将signapk 用的签名合并到 jarsigner签名, 同样也可以分离出来,具体操作步骤:
a)
keytool -importkeystore -srckeystore testkey.jks -destkeystore testkey.p12 -srcstoretype JKS -deststoretype PKCS12 -srcstorepass 12345678 -deststorepass 12345678 -noprompt
首先将testkey.jks 转化为 .p12文件, 在执行过程中需要输入srcstore密码和 deststroe 密码, 这里在命令行中 通过-srcstorepass 和-deststorepass指定
b)
openssl pkcs12 -in testkey.p12 -nodes -out testkey_all.rsa.pem -password pass:12345678
使用openssl 的pkcs12 指令将p12文件中的证书导出,
-password pass:12345678 为了省略之后的输入密码步骤
通过网上的教程可知,如上代码同时导出了密钥 和 证书, 需要手动的将证书复制出来生成 .x509.pem签名
查看openssl帮助文档, 我们知道可以只导出证书或者密钥,于是我们可以通过 -nokeys 参数只导出证书
openssl pkcs12 -in testkey.p12 -nodes -nokeys -out testkey.x509.pem -password pass:12345678
通过-cacerts 参数之导出密钥
openssl pkcs12 -in testkey.p12 -nodes -cacerts -out testkey.rsa.pem -password pass:12345678
c) 根据b)中生成的密钥文件生成pk8, 可以使用testkey_all.rsa.pem 也可是使用testkey.rsa.pem
openssl pkcs8 -topk8 -outform DER -in testkey.rsa.pem -inform PEM -out testkey.pk8 -nocrypt
如上testkey.pk8 和 testkey.x509.pem即为所需签名
一个简易bat 脚本
见文章末尾github代码库中 jks2pk8.bat 文件
四、探究jks 签名的生成
我们知道可以使用Android Studio 来生成jks, 是不是有命令行工具呢
keytool 就可以实现 这个操作
核心命令 keytool -genkey -v -keystore app.jks -alias app -keyalg RSA -validity 999999
如上,指定了 要生成的签名文件名称 , 别名 和有效期(日)
运行过程中需要输入两个密码 一个是密码口令(keypass),一个是密钥库口令(storepass)
可以通过-keypass 和 -storepass 指定
简易 bat脚本
见文章末尾github代码库中 genkey.bat 文件
五、签名案例分析
创建一个jks 签名app.jks, 将jks 签名拆分为signapk需要的pk8签名, 然后再将pk8 签名合并回jks
分别用如上三个签名对同意文件进行签名操作, 对比如下: 证书都相同!
PS:附使用 signapk.jar 和jarsigner 工具签名的命令行操作
signapk.jar 签名示例
java -jar signapk.jar testkey.x509.pem testkey.pk8 111.zip jifei_out.apk
jarsigner 工具签名示例
jarsigner -verbose -storepass 12345678 -keystore testkey.jks -signedjar jks_out.apk 111.zip testkey
最后的testkey 为别名
脚本: