智能客服
你问我答，随时在线为你解决问题
为方便您理解此功能的应用场景，提高接入效率，特此更新该文档，原《设备真实性证明》文档更改为《应用真实性证明》。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
应用框架
系统
媒体
图形
应用服务
AI
NDK开发
您可以利用应用真实性证明能力在服务器验证来自应用的请求，具体包括验证请求是否源自真实应用、真实设备，以及请求内容是否未经篡改。
说明
基础概念
-
应用公私钥对：用于验证应用请求真实性的非对称算法密钥对，包含应用公钥和应用私钥，比如RSA、ECC算法的密钥对。
-
应用公钥ID：为应用公钥生成的唯一ID，用于您的应用服务器标识和查找应用公钥。
-
应用ID：包含了应用身份相关的信息，如应用包名，应用签名密钥Hash。
-
密钥证明证书链：华为服务器在验证应用公钥来自真实的设备和真实的应用后签发的证书链，证书链中包含了应用公钥和您的应用ID。
概述
您的应用可以通过调用Universal Keystore Kit相关接口，并在您的服务器上完成对应的校验，以验证应用请求的真实性。
本文介绍如何在您的应用和应用服务器上验证应用请求真实性，使用过程为：
前置操作：创建密钥确立可信凭证
-
应用调用Universal Keystore Kit的密钥生成接口，创建一对唯一的应用公私钥对，该公私钥对存储在基于硬件的安全环境。
-
应用再调用Universal Keystore Kit的密钥证明接口，对应用公钥和应用ID签发密钥证明证书链。
-
应用服务器对密钥证明证书链进行校验，以及校验证书链中的应用ID是否正确。
-
应用服务器保存密钥证明证书链中的应用公钥。
业务请求证明：签名验签识别真实请求
-
应用进行关键业务处理时（如免密支付、营销活动）调用Universal Keystore Kit的签名接口，使用应用私钥对业务请求进行签名。
-
应用服务器使用保存的应用公钥对签名进行验签，验签成功即可说明该请求来自真实的设备和应用，以及内容未被篡改。
说明
“对密钥和应用ID证明”步骤从API 26.0.0开始已支持离线密钥证明接口（anonAttestKeyItemOffline），该接口没有服务配额限制，且与在线密钥证明接口（anonAttestKeyItem）提供了相同功能，推荐您的应用优先采用和集成离线接口。
对已经集成了在线密钥证明接口的应用，建议切换到离线密钥证明接口。
展开
| 比较项 | 离线的密钥证明接口（推荐） | 在线的密钥证明接口 |
|---|---|---|
| 提供的功能 | 提供了对密钥和应用ID证明的能力 | 提供了对密钥和应用ID证明的能力 |
| 实现方案 | 使用设备本地缓存的CA证书签发证明，缓存的CA证书过期（有效期1个月）后才需要联网更新。 | 每次都需要访问华为服务器，使用服务器的CA证书签发证明 |
| 服务配额 | 无限制 | 35次/秒/应用 |
本方案通过证明应用公钥来自真实的设备并签发密钥证明证书链，从而识别模拟器等非真实设备的场景。
密钥证明证书链中，包含了应用包名、应用签名证书的公钥hash和应用类型（debug或release）等应用ID信息。服务器通过验证这些信息，可以判断收到的请求是否来自真实的应用，从而有效识别重打包、仿冒应用等非真实应用的场景。
密钥证明证书链同时还包含了应用公钥，对应的私钥存储在基于硬件的安全环境中，您可以使用此私钥对重要的业务请求进行签名，以此识别通过抓包等方法篡改或伪造应用请求的攻击场景。
约束与限制
由于此能力需要证明请求来自真实的设备，因此在模拟器上不会提供真实的实现。具体来说，应用在模拟器上调用密钥证明接口时，会返回一个模拟的固定证书链，该证书链无法通过华为服务器提供的根CA证书的校验。
服务配额
展开
| 接口 | 配额 | 配额说明 |
|---|---|---|
| 密钥证明接口（在线） | 35次/秒/应用 | 默认情况下，每个应用调用在线密钥证明接口（anonAttestKeyItem / OH_Huks_AnonAttestKeyItem）的瞬时流量每秒不超过35次请求。如果应用的实际调用量超过服务配额，请切换为离线密钥证明接口。 |
| 密钥证明接口（离线） | 无限制 | 无限制 |
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词