OpenHarmony应用签名 - 厂商私有签名 原创 精华
概述
文档环境
开发环境：Windows 11
DevEco Studio 版本：DevEco Studio 3.1 Release（3.1.0.500）
SDK 版本：3.2.12.5（Full SDK）
开发板型号：DAYU 200
系统版本：OpenHarmony 3.2 Release
涉及仓库：Hap包签名工具[developtools_hapsigner]
功能简介
为了保证OpenHarmony应用的完整性和来源可靠，在应用构建时需要对应用进行签名。经过签名的应用才能在真机设备上安装、运行、和调试。developtools_hapsigner仓提供了签名工具的源码，包含密钥对生成、CSR文件生成、证书生成、Profile文件签名、Hap包签名等功能。
OpenHarmony系统中有一套默认签名信息，用于应用的开发和调试。当系统厂商正式发布系统时，需要新增或替换私有签名信息，本篇文档将介绍如何生成私有签名并在系统中进行配置。本文档需准备Java和Gradle编译环境。
基本概念
- 非对称密钥对：数据签名/验签的基础，应用签名工具实现了标准的非对称密钥对生成功能（支持的密钥对类型包括ECC P384/256、RSA2048/3072/4096）
- CSR：Certificate Signing Request 证书签发请求是生成证书的前提，他包括证书的公钥、证书主题和私钥签名，在申请证书之前，需要先基于密钥对生成CSR，然后提交给CA签发证书。
- 证书：OpenHarmony采用RFC5280标准构建X509证书信任体系。用于应用签名的OpenHarmony证书共有三级，分为：根CA证书、中间CA证书、最终实体证书，其中最终实体证书分为应用签名证书和profile签名证书。应用签名证书表示应用开发者的身份，可保证系统上安装的应用来源可追溯，profile签名证书实现对profile文件的签名进行验签，保证profile文件的完整性。
- HAP：OpenHarmony Ability Package 是Ability的部署包，OpenHarmony应用代码围绕Ability组件展开，它是由一个或者多个Ability组成。
- Profile文件：HarmonyAppProvision 配置文件，hap包中的描述文件，该描述文件描述了已授权的证书权限和设备ID信息等信息。
Profile签名场景：
应用签名场景：
如何生成私有签名
准备签名工具
- 克隆developtools_hapsigner仓库
git clone https://gitee.com/openharmony/developtools_hapsigner.git
- 命令行打开文件目录至developtools_hapsigner/hapsigntool，执行命令进行编译打包
gradle build 或者 gradle jar
- 编译后得到二进制文件，目录为:
developtools_hapsigner/hapsigntool/hap_sign_tool/build/libs/hap-sign-tool.jar
签名工具说明
- 生成密钥对
generate-keypair :
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -keyAlg # 密钥算法，必填项，包括RSA/ECC
├── -keySize # 密钥长度，必填项，RSA算法的长度为2048/3072/4096，ECC算法的长度NIST-P-256/NIST-P-384
├── -keystoreFile # 密钥库文件，必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项- 生成证书签名请求
generate-csr :
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -subject # 证书主题，必填项
├── -signAlg # 签名算法，必填项，包括SHA256withRSA / SHA384withRSA / SHA256withECDSA / SHA384withECDSA
├── -keystoreFile # 密钥库文件，必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -outFile # 输出文件，可选项，如果不填，则直接输出到控制台
- 生成根CA/中间CA证书，如果密钥不存在，一起生成密钥
generate-ca :
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -keyAlg # 密钥算法，必填项，包括RSA/ECC
├── -keySize # 密钥长度，必填项，RSA算法的长度为2048/3072/4096，ECC算法的长度NIST-P-256/NIST-P-384
├── -issuer # 颁发者的主题，可选项，如果不填，表示根CA
├── -issuerKeyAlias # 颁发者的密钥别名，可选项，如果不填，表示根CA
├── -issuerKeyPwd # 颁发者的密钥口令，可选项
├── -subject # 证书主题，必填项
├── -validity # 证书有效期，可选项，默认为3650天
├── -signAlg # 签名算法，必填项，包括SHA256withRSA / SHA384withRSA / SHA256withECDSA / SHA384withECDSA
├── -basicConstraintsPathLen # 路径长度，可选项，默认为0
├── -issuerKeystoreFile # 签发者密钥库文件，可选项，JKS或P12格式
├── -issuerKeystorePwd # 签发者密钥库口令，可选项
├── -keystoreFile # 密钥库文件，必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -outFile # 输出文件，可选项，如果不填，则直接输出到控制台
- 生成应用调试/发布证书
generate-app-cert :
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -issuer # 颁发者的主题，必填项
├── -issuerKeyAlias # 颁发者的密钥别名，必填项
├── -issuerKeyPwd # 颁发者的密钥口令，可选项
├── -subject # 证书主题，必填项
├── -validity # 证书有效期，可选项，默认为3650天
├── -signAlg # 签名算法，必填项，包括SHA256withECDSA / SHA384withECDSA；
├── -keystoreFile # 密钥库文件，必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -issuerKeystoreFile # 签发者密钥库文件，可选项，JKS或P12格式
├── -issuerKeystorePwd # 签发者密钥库口令，可选项
├── -outForm # 输出证书文件的格式，包括 cert / certChain，可选项，默认为certChain
├── -rootCaCertFile # outForm为certChain时必填，根CA证书文件
├── -subCaCertFile # outForm为certChain时必填，中间CA证书文件
├── -outFile # 输出证书文件(证书或证书链)，可选项，如果不填，则直接输出到控制台
- 生成profile调试/发布证书
generate-profile-cert :
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -issuer # 颁发者的主题，必填项
├── -issuerKeyAlias # 颁发者的密钥别名，必填项
├── -issuerKeyPwd # 颁发者的密钥口令，可选项
├── -subject # 证书主题，必填项
├── -validity # 证书有效期，可选项，默认为3650天
├── -signAlg # 签名算法，必填项，包括SHA256withECDSA / SHA384withECDSA；
├── -keystoreFile # 密钥库文件，必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -issuerKeystoreFile # 签发者密钥库文件，可选项，JKS或P12格式
├── -issuerKeystorePwd # 签发者密钥库口令，可选项
├── -outForm # 输出证书文件的格式，包括 cert / certChain，可选项，默认为certChain
├── -rootCaCertFile # outForm为certChain时必填，根CA证书文件
├── -subCaCertFile # outForm为certChain时必填，中间CA证书文件
├── -outFile # 输出证书文件(证书或证书链)，可选项，如果不填，则直接输出到控制台
- 通用证书生成，可以生成自定义证书
generate-cert :
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -issuer # 颁发者的主题，必填项
├── -issuerKeyAlias # 颁发者的密钥别名，必填项
├── -issuerKeyPwd # 颁发者的密钥口令，可选项
├── -subject # 证书主题，必填项
├── -validity # 证书有效期，可选项，默认为1095天
├── -keyUsage # 密钥用法，必选项，包括digitalSignature, nonRepudiation, keyEncipherment,
├ dataEncipherment, keyAgreement, certificateSignature, crlSignature，
├ encipherOnly和decipherOnly，如果证书包括多个密钥用法，用逗号分隔
├── -keyUsageCritical # keyUsage是否为关键项，可选项，默认为是
├── -extKeyUsage # 扩展密钥用法，可选项，包括clientAuthentication，serverAuthentication，
├ codeSignature，emailProtection，smartCardLogin，timestamp，ocspSignature
├── -extKeyUsageCritical # extKeyUsage是否为关键项，可选项，默认为否
├── -signAlg # 签名算法，必填项，包括SHA256withRSA/SHA384withRSA/SHA256withECDSA/SHA384withECDSA
├── -basicConstraints # 是否包含basicConstraints，可选项，默认为否
├── -basicConstraintsCritical # basicConstraints是否包含为关键项，可选项，默认为否
├── -basicConstraintsCa # 是否为CA，可选项，默认为否
├── -basicConstraintsPathLen # 路径长度，可选项，默认为0
├── -issuerKeystoreFile # 签发者密钥库文件，可选项，JKS或P12格式
├── -issuerKeystorePwd # 签发者密钥库口令，可选项
├── -keystoreFile # 密钥库文件，必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -outFile # 输出证书文件，可选项，如果不填，则直接输出到控制台
- ProvisionProfile文件签名
sign-profile :
├── -mode # 签名模式，必填项，包括localSign，remoteSign
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -profileCertFile # Profile签名证书（证书链，顺序为最终实体证书-中间CA证书-根证书），必填项
├── -inFile # 输入的原始Provision Profile文件，必填项
├── -signAlg # 签名算法，必填项，包括SHA256withECDSA / SHA384withECDSA
├── -keystoreFile # 密钥库文件，localSign模式时为必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -outFile # 输出签名后的Provision Profile文件，p7b格式，必填项
- ProvisionProfile文件验签
verify-profile :
├── -inFile # 已签名的Provision Profile文件，p7b格式，必填项
├── -outFile # 验证结果文件（包含验证结果和profile内容），json格式，可选项；如果不填，则直接输出到控制台
- hap应用包签名
sign-app :
├── -mode # 签名模式，必填项，包括localSign，remoteSign，remoteResign
├── -keyAlias # 密钥别名，必填项
├── -keyPwd # 密钥口令，可选项
├── -appCertFile # 应用签名证书文件（证书链，顺序为最终实体证书-中间CA证书-根证书），必填项
├── -profileFile # 签名后的Provision Profile文件名，profileSigned为1时为p7b格式，profileSigned为0时为json格式,必填项
├── -profileSigned # 指示profile文件是否带有签名，1表示有签名，0表示没有签名，默认为1。可选项
├── -inForm # 输入的原始文件的格式，zip格式或bin格式，默认zip格式，可选项
├── -inFile # 输入的原始APP包文件，zip格式或bin格式，必填项
├── -signAlg # 签名算法，必填项，包括SHA256withECDSA / SHA384withECDSA
├── -keystoreFile # 密钥库文件，localSign模式时为必填项，JKS或P12格式
├── -keystorePwd # 密钥库口令，可选项
├── -outFile # 输出签名后的包文件，必填项
- hap应用包文件验签
verify-app :
├── -inFile # 已签名的应用包文件，zip格式或bin格式，必填项
├── -outCertChain # 签名的证书链文件，必填项
├── -outProfile # 应用包中的profile文件，必填项生成签名文件
- 生成密钥对，keystorePwd为密钥库口令。
java -jar hap-sign-tool.jar generate-keypair -keyAlias "OpenHarmony-Tizi" -keyAlg "ECC" -keySize "NIST-P-256" -keystoreFile "OpenHarmony-Tizi.p12" -keyPwd "Pwd-Tizi-1" -keystorePwd "Pwd-Tizi-2"
- 生成RootCA证书，subject为RootCA的证书主题，用于配置trusted_root_ca.json。
java -jar hap-sign-tool.jar generate-ca -keyAlias "OpenHarmony-Tizi-rootCA" -signAlg "SHA256withECDSA" -keyAlg "ECC" -keySize "NIST-P-256" -subject "C=CN, O=OpenHarmony-Tizi-rootCA, OU=OpenHarmony-Tizi-rootCA Community, CN=OpenHarmony Application Root CA" -keystoreFile "OpenHarmony-Tizi.p12" -outFile "OpenHarmony-Tizi-rootCA.cer" -keyPwd "Pwd-Tizi-3" -keystorePwd "Pwd-Tizi-2" -validity "365"
- 生成SubCA证书。
java -jar hap-sign-tool.jar generate-ca -keyAlias "OpenHarmony-Tizi-subCA" -signAlg "SHA256withECDSA" -keyAlg "ECC" -keySize "NIST-P-256" -subject "C=CN, O=OpenHarmony-Tizi-subCA, OU=OpenHarmony-Tizi-subCA Community, CN=OpenHarmony Application Sub CA" -keystoreFile "OpenHarmony-Tizi.p12" -outFile "OpenHarmony-Tizi-subCA.cer" -keyPwd "Pwd-Tizi-4" -keystorePwd "Pwd-Tizi-2" -issuer "C=CN, O=OpenHarmony-Tizi-rootCA, OU=OpenHarmony-Tizi-rootCA Community, CN=OpenHarmony Application Root CA" -issuerKeyAlias "OpenHarmony-Tizi-rootCA" -issuerKeyPwd "Pwd-Tizi-3" -validity "365"
- 生成应用调试/发布证书，subject用于配置trusted_apps_sources.json中的app-signing-cert项。
java -jar hap-sign-tool.jar generate-app-cert -keyAlias "OpenHarmony-Tizi-subCA" -signAlg "SHA256withECDSA" -subject "C=CN, O=OpenHarmony-Tizi-app-cert, OU=OpenHarmony-Tizi-app-cert Community, CN=OpenHarmony Application Release" -keystoreFile "OpenHarmony-Tizi.p12" -subCaCertFile "OpenHarmony-Tizi-subCA.cer" -rootCaCertFile "OpenHarmony-Tizi-rootCA.cer" -outForm "certChain" -outFile "OpenHarmony-Tizi-app-cert.pem" -keyPwd "Pwd-Tizi-4" -keystorePwd "Pwd-Tizi-2" -issuer "C=CN, O=OpenHarmony-Tizi-subCA, OU=OpenHarmony-Tizi-subCA Community, CN=OpenHarmony Application Sub CA" -issuerKeyAlias "OpenHarmony-Tizi-subCA" -issuerKeyPwd "Pwd-Tizi-4" -validity "365"
- 生成ProfileCA证书，subject用于配置trusted_apps_sources.json中的issuer-ca项。
java -jar hap-sign-tool.jar generate-ca -keyAlias "OpenHarmony-Tizi-profileCA" -signAlg "SHA256withECDSA" -keyAlg "ECC" -keySize "NIST-P-256" -subject "C=CN, O=OpenHarmony-Tizi-subCA, OU=OpenHarmony-Tizi-subCA Community, CN=OpenHarmony Application CA" -keystoreFile "OpenHarmony-Tizi.p12" -outFile "OpenHarmony-Tizi-profileCA.cer" -keyPwd "Pwd-Tizi-5" -keystorePwd "Pwd-Tizi-2" -issuer "C=CN, O=OpenHarmony-Tizi-rootCA, OU=OpenHarmony-Tizi-rootCA Community, CN=OpenHarmony Application Root CA" -issuerKeyAlias "OpenHarmony-Tizi-rootCA" -issuerKeyPwd "Pwd-Tizi-3" -validity "365"
- 生成应用Release版profile调试/发布证书，subject用于配置trusted_apps_sources.json中的profile-signing-certificate项。
java -jar hap-sign-tool.jar generate-profile-cert -keyAlias "OpenHarmony-Tizi-profileCA" -signAlg "SHA256withECDSA" -subject "C=CN, O=OpenHarmony-Tizi-profile-cert, OU=OpenHarmony-Tizi-profile-cert Community, CN=OpenHarmony Application Profile Release" -keystoreFile "OpenHarmony-Tizi.p12" -subCaCertFile "OpenHarmony-Tizi-profileCA.cer" -rootCaCertFile "OpenHarmony-Tizi-rootCA.cer" -outForm "certChain" -outFile "OpenHarmony-Tizi-profile-cert-release.pem" -keyPwd "Pwd-Tizi-5" -keystorePwd "Pwd-Tizi-2" -issuer "C=CN, O=OpenHarmony-Tizi-subCA, OU=OpenHarmony-Tizi-subCA Community, CN=OpenHarmony Application CA" -issuerKeyAlias "OpenHarmony-Tizi-profileCA" -issuerKeyPwd "Pwd-Tizi-5" -validity "365"
- 生成应用Debug版profile调试/发布证书，subject用于配置trusted_apps_sources.json中的profile-debug-signing-certificate项。
java -jar hap-sign-tool.jar generate-profile-cert -keyAlias "OpenHarmony-Tizi-profileCA" -signAlg "SHA256withECDSA" -subject "C=CN, O=OpenHarmony-Tizi-profile-cert, OU=OpenHarmony-Tizi-profile-cert Community, CN=OpenHarmony Application Profile Debug" -keystoreFile "OpenHarmony-Tizi.p12" -subCaCertFile "OpenHarmony-Tizi-profileCA.cer" -rootCaCertFile "OpenHarmony-Tizi-rootCA.cer" -outForm "certChain" -outFile "OpenHarmony-Tizi-profile-cert-debug.pem" -keyPwd "Pwd-Tizi-5" -keystorePwd "Pwd-Tizi-2" -issuer "C=CN, O=OpenHarmony-Tizi-subCA, OU=OpenHarmony-Tizi-subCA Community, CN=OpenHarmony Application CA" -issuerKeyAlias "OpenHarmony-Tizi-profileCA" -issuerKeyPwd "Pwd-Tizi-5" -validity "365"
- 将OpenHarmony-Tizi-app-cert.pem中第一部分的密钥，把回车转换为\n字符，放入UnsgnedReleasedProfileTemplate.json的distribution-certificate中。例如：
转换前：
-----BEGIN CERTIFICATE-----
MIICazCCAhGgAwIBAgIFAPERF2IwCgYIKoZIzj0EAwIwgYIxCzAJBgNVBAYTAkNO
MR8wHQYDVQQKDBZPcGVuSGFybW9ueS1UaXppLXN1YkNBMSkwJwYDVQQLDCBPcGVu
SGFybW9ueS1UaXppLXN1YkNBIENvbW11bml0eTEnMCUGA1UEAwweT3Blbkhhcm1v
bnkgQXBwbGljYXRpb24gU3ViIENBMB4XDTIzMDUyMTE0MDU0M1oXDTI0MDUyMDE0
MDU0M1owgYkxCzAJBgNVBAYTAkNOMSIwIAYDVQQKDBlPcGVuSGFybW9ueS1UaXpp
LWFwcC1jZXJ0MSwwKgYDVQQLDCNPcGVuSGFybW9ueS1UaXppLWFwcC1jZXJ0IENv
bW11bml0eTEoMCYGA1UEAwwfT3Blbkhhcm1vbnkgQXBwbGljYXRpb24gUmVsZWFz
ZTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABN0OL1RqzWXQWCXpT0tt54aFR0Ul
7pqZYBJaCKT049xUYcfwCHLd0q0IzktNo9nqKIjE5BxOk76w7kHhxwowI2qjazBp
MB0GA1UdDgQWBBQAW6LlxgLrPko7kHS/jbcsqnh4WTAJBgNVHRMEAjAAMA4GA1Ud
DwEB/wQEAwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzAYBgwrBgEEAY9bAoJ4AQME
CDAGAgEBCgEAMAoGCCqGSM49BAMCA0gAMEUCIQDHIWx4AELONvCoKaQnHQAW0bay
gjR168gmlnGfnFGowAIgfMV5/nIvmRAbpapqO3a2pBKeHFfeU5zel/T1Bgty198=
-----END CERTIFICATE-----转换后：
-----BEGIN CERTIFICATE-----\nMIICazCCAhGgAwIBAgIFAPERF2IwCgYIKoZIzj0EAwIwgYIxCzAJBgNVBAYTAkNO\nMR8wHQYDVQQKDBZPcGVuSGFybW9ueS1UaXppLXN1YkNBMSkwJwYDVQQLDCBPcGVu\nSGFybW9ueS1UaXppLXN1YkNBIENvbW11bml0eTEnMCUGA1UEAwweT3Blbkhhcm1v\nbnkgQXBwbGljYXRpb24gU3ViIENBMB4XDTIzMDUyMTE0MDU0M1oXDTI0MDUyMDE0\nMDU0M1owgYkxCzAJBgNVBAYTAkNOMSIwIAYDVQQKDBlPcGVuSGFybW9ueS1UaXpp\nLWFwcC1jZXJ0MSwwKgYDVQQLDCNPcGVuSGFybW9ueS1UaXppLWFwcC1jZXJ0IENv\nbW11bml0eTEoMCYGA1UEAwwfT3Blbkhhcm1vbnkgQXBwbGljYXRpb24gUmVsZWFz\nZTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABN0OL1RqzWXQWCXpT0tt54aFR0Ul\n7pqZYBJaCKT049xUYcfwCHLd0q0IzktNo9nqKIjE5BxOk76w7kHhxwowI2qjazBp\nMB0GA1UdDgQWBBQAW6LlxgLrPko7kHS/jbcsqnh4WTAJBgNVHRMEAjAAMA4GA1Ud\nDwEB/wQEAwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzAYBgwrBgEEAY9bAoJ4AQME\nCDAGAgEBCgEAMAoGCCqGSM49BAMCA0gAMEUCIQDHIWx4AELONvCoKaQnHQAW0bay\ngjR168gmlnGfnFGowAIgfMV5/nIvmRAbpapqO3a2pBKeHFfeU5zel/T1Bgty198=\n-----END CERTIFICATE-----\n- ProvisionProfile文件签名
java -jar hap-sign-tool.jar sign-profile -keyAlias "OpenHarmony-Tizi-profileCA" -signAlg "SHA256withECDSA" -mode "localSign" -profileCertFile "OpenHarmony-Tizi-profile-cert-release.pem" -inFile "UnsgnedReleasedProfileTemplate.json" -keystoreFile "OpenHarmony-Tizi.p12" -outFile "com.openharmony.signtest.p7b" -keyPwd "Pwd-Tizi-5" -keystorePwd "Pwd-Tizi-2"
- hap应用包签名
java -jar hap-sign-tool.jar sign-app -keyAlias "OpenHarmony-Tizi-subCA" -signAlg "SHA256withECDSA" -mode "localSign" -appCertFile "OpenHarmony-Tizi-app-cert.pem" -profileFile "com.openharmony.signtest.p7b" -inFile "entry-default-unsigned.hap" -keystoreFile "OpenHarmony-Tizi.p12" -outFile "entry-default-signed.hap" -keyPwd "Pwd-Tizi-4" -keystorePwd "Pwd-Tizi-2"
配置系统证书
- 系统中证书配置文件位于/etc/security/中
- 配置 trusted_apps_sources.json 文件。注意“,”符号后面需要加入空格才可正常匹配。
{
"name":"OpenHarmony-Tizi apps",
"app-signing-cert":"C=CN, O=OpenHarmony-Tizi-app-cert, OU=OpenHarmony-Tizi-app-cert Community, CN=OpenHarmony Application Release",
"profile-signing-certificate":"C=CN, O=OpenHarmony-Tizi-profile-cert, OU=OpenHarmony-Tizi-profile-cert Community, CN=OpenHarmony Application Profile Release",
"profile-debug-signing-certificate":"C=CN, O=OpenHarmony-Tizi-profile-cert, OU=OpenHarmony-Tizi-profile-cert Community, CN=OpenHarmony Application Profile Debug",
"issuer-ca":"C=CN, O=OpenHarmony-Tizi-subCA, OU=OpenHarmony-Tizi-subCA Community, CN=OpenHarmony Application CA",
"max-certs-path":3,
"critialcal-cert-extension":["keyusage"]
}- 配置 trusted_root_ca.json 文件，将 OpenHarmony-Tizi-rootCA.cer 密钥信息处理后加入到文件中。
"C=CN, O=OpenHarmony-Tizi-rootCA, OU=OpenHarmony-Tizi-rootCA Community, CN=OpenHarmony Application Root CA":"-----BEGIN CERTIFICATE-----\nMIICQzCCAemgAwIBAgIEUwKY8TAKBggqhkjOPQQDAjCBhTELMAkGA1UEBhMCQ04x\nIDAeBgNVBAoMF09wZW5IYXJtb255LVRpemktcm9vdENBMSowKAYDVQQLDCFPcGVu\nSGFybW9ueS1UaXppLXJvb3RDQSBDb21tdW5pdHkxKDAmBgNVBAMMH09wZW5IYXJt\nb255IEFwcGxpY2F0aW9uIFJvb3QgQ0EwHhcNMjMwNTIxMTQwNTI2WhcNMjQwNTIw\nMTQwNTI2WjCBhTELMAkGA1UEBhMCQ04xIDAeBgNVBAoMF09wZW5IYXJtb255LVRp\nemktcm9vdENBMSowKAYDVQQLDCFPcGVuSGFybW9ueS1UaXppLXJvb3RDQSBDb21t\ndW5pdHkxKDAmBgNVBAMMH09wZW5IYXJtb255IEFwcGxpY2F0aW9uIFJvb3QgQ0Ew\nWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARoC3C5WijOQkLq/AjmtEWkZ+Ooso1p\nRl34qPpEPH0b6iun5wpAlDe20bcCvsiFda2RNXFsqHIl+cj59bnLh83Ro0UwQzAd\nBgNVHQ4EFgQUAIpcSDCk3q3hZ+qwobekzT9vLHAwEgYDVR0TAQH/BAgwBgEB/wIB\nADAOBgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwIDSAAwRQIhANKbxPqFT5PwURVf\n1Oxa8cf1udcgO0ntULei/GhaQIobAiBH787oVyJtKxMuPw9K6zzhJjBNjZzW0DrK\n/NOyuKLetw==\n-----END CERTIFICATE-----\n"- 将文件推送回系统中并重启。
hdc shell "mount -o remount,rw /"
hdc file send D:\trusted_apps_sources.json /etc/security/trusted_apps_sources.json
hdc file send D:\trusted_root_ca.json /etc/security/trusted_root_ca.json
hdc shell reboot
- 安装签名应用。
参考文档
OpenHarmony Gitee Docs - Hap包签名工具概述
OpenHarmony Gitee Docs - Hap包签名工具指导
OpenHarmony Gitee Docs - HarmonyAppProvision配置文件说明
很完整的实践流程
私有签名配置如何导入IDE呢，我进行IDE手动配置时Certpath file(*.cer)不知道配置哪一个，导致hap编译失败，出现诸如这类错误：
Details: Profile cert 'C:/Users/xxx/Desktop/demo/OpenHarmony-Tizi.cer' must a cert chain
Detail: Please check the message from tools.
可以参考https://ost.51cto.com/posts/21466这篇文章，CER文件实际就是PEM文件，可以直接把PEM的后缀改为CER使用。
通过java -jar hap-sign-tool.jar sign-app命令签名后的hap可以正常安装和运行。
按照上面说的直接修改PEM后缀为CER或者
运行hap-sign-tool.jar generate-app-cert命令生成时将后缀改为CER，IDE编译还是报错：
> hvigor ERROR: Failed :entry:default@SignHap...
> hvigor ERROR: Tools execution failed.
06-25 15:53:41 ERROR - hap-sign-tool: error: {errorcode:0,message:generate SignerBlock failed}
com.ohos.hapsigntool.hap.exception.SignatureException: {errorcode:0,message:generate SignerBlock failed}
at com.ohos.hapsigntool.hap.sign.SignHap.generateHapSignatureSchemeBlock(SignHap.java:304) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.SignHap.generateHapSigningBlock(SignHap.java:202) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.SignHap.getHapSigningBlock(SignHap.java:190) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.SignHap.sign(SignHap.java:350) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.provider.SignProvider.sign(SignProvider.java:302) [hap-sign-tool.jar:?]
at com.ohos.hapsigntool.api.SignToolServiceImpl.signHap(SignToolServiceImpl.java:319) [hap-sign-tool.jar:?]
at com.ohos.hapsigntool.HapSignTool.runSignApp(HapSignTool.java:285) [hap-sign-tool.jar:?]
at com.ohos.hapsigntool.HapSignTool.dispatchParams(HapSignTool.java:152) [hap-sign-tool.jar:?]
at com.ohos.hapsigntool.HapSignTool.processCmd(HapSignTool.java:109) [hap-sign-tool.jar:?]
at com.ohos.hapsigntool.HapSignTool.main(HapSignTool.java:79) [hap-sign-tool.jar:?]
Caused by: com.ohos.hapsigntool.hap.exception.SignatureException: {errorcode:0,message:Signature did not verify}
at com.ohos.hapsigntool.hap.sign.BcPkcs7Generator.verifySignatureFromServer(BcPkcs7Generator.java:252) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.BcPkcs7Generator.getSignerInfo(BcPkcs7Generator.java:164) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.BcPkcs7Generator.generateSignedData(BcPkcs7Generator.java:91) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.SignHap.generateSignerBlock(SignHap.java:331) ~[hap-sign-tool.jar:?]
at com.ohos.hapsigntool.hap.sign.SignHap.generateHapSignatureSchemeBlock(SignHap.java:302) ~[hap-sign-tool.jar:?]
... 9 more
Detail: Please check the message from tools.
> hvigor ERROR: BUILD FAILED in 4 s 838 ms
使用的PEM文件为OpenHarmony-Tizi-app-cert.pem，更改为CER。
感谢大佬指导，keyAlias和keyPassword更正后验证OK
大佬，配置系统证书这一步，我在文章最后的参考文档里没发现有提及，请问官方有指导文档么？
官方Docs中现在暂时没有文档进行说明。
大佬，本篇是演示了release版本的签名，看第7步已经生成了应用Debug版profile调试/发布证书，但是想问一下应该怎么使用呢；和使用release版的证书的区别在哪里；我通过第9步进行ProvisionProfile文件签名，生成了debug级的p7b，然后将ide里p7b文件那栏换成了生成的debug的p7b，编译成功但是install失败，报的错是"error: signature verification failed due to not trusted app source."，在这之前使用release的p7b去install应用是ok的，请问一下是什么原因导致的，是我哪里没有配置或者更改吗？
检查一下是否把第7步中的，subject配置到了trusted_apps_sources.json中的profile-debug-signing-certificate项里。
有的，配置了
在用ide编译私有签名应用的时候，正常来说只需要一个p12，一个cer，一个release或者一个debug的p7b就可以了对吧
我有试过：在处理UnsgnedReleasedProfileTemplate.json文件的时候，type字段改成debug，但直接就无法生成debug.p7b了，报错："Require cert in bundleInfo"；大佬有试过使用debug等级的p7b进行签名编译安装吗？
Debug对应的Profile文件为UnsgnedDebugProfileTemplate.json。