输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南系统安全Device Security Kit（设备安全服务）开发准备基于服务账号生成鉴权令牌

基于服务账号生成鉴权令牌

更新时间: 2026-07-28 11:23
本文导读
注意

只有使用应用设备状态检测服务时才需要配置此章节。

概述

服务账号（Service Account）是一种可实现服务器与服务器之间接口鉴权的账号，在华为开发者联盟的API Console上创建服务账号，您可根据返回的公私钥在业务应用中生成鉴权令牌，调用支持此类鉴权的华为公开API。

服务账号令牌为JWT（JSON Web Token）格式字符串，JWT数据格式包括三个部分：

  • Header（头部）

  • Payload（负载）

  • Signature（签名）

这三个部分通过“.”进行连接，其中Signature为通过SHA256withRSA算法对Header与Payload拼接的字符串签名生成的字符串。

示例

收起
自动换行
深色代码主题
复制
  1. eyJra*****JjNjBjMXXX.
  2. eyJhd*****JodHRXXX.
  3. BRNss*****7az5oU7-Zp5g9X2WJVXXX

更多JWT的相关知识请参见Introduction to JSON Web Tokens。

开发步骤

  1. 创建服务账号密钥文件。

    开发者需要在华为开发者联盟的API Console上创建并下载服务账号的密钥文件，相关创建步骤请参见API Console操作指南-服务账号密钥。

    说明

    您在开发者联盟需要申请开发者级的服务账号凭证。

    服务账号密钥样例文件形式可参考：

    收起
    自动换行
    深色代码主题
    复制
    1. {
    2.     "project_id": "*****",
    3.     "key_id": "*****",
    4.     "private_key": "-----BEGIN PRIVATE KEY-----\nMIIJQgIBADANBgkqhkiG9w0BAQEFAASCCSwwggkoAgEAAoICAQCKw6kJKtCh7qmMvp1u1dI27z2TKZrPOzHbQaXO/Eez0AWZ2EN+ouF496R3pfo7fQXC1XOT/YTbVC4DNZwWSMA54fu3/AOCY9Zzyi46OK*****==\n-----END PRIVATE KEY-----\n",
    5.     "sub_account": "*****",
    6.     "auth_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/authorize",
    7.     "token_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/token",
    8.     "auth_provider_cert_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/certs",
    9.     "client_cert_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/x509?client_id=*****"
    10. }

  2. 生成JWT Header数据。

    根据服务账号密钥文件中的key_id字段拼接以下JSON体，对JSON体进行BASE64编码。

    收起
    自动换行
    深色代码主题
    复制
    1. {
    2.   "kid": "*****",
    3.   "typ": "JWT",
    4.   "alg": "PS256"
    5. }
    展开
    字段名 描述
    kid 服务账号密钥文件中key_id字段。
    typ 数据类型，固定为：JWT。
    alg 算法类型，固定为：PS256。

  3. 生成JWT Payload数据。

    根据服务账号密钥文件中的sub_account字段拼接以下JSON体，对JSON体进行BASE64编码。

    收起
    自动换行
    深色代码主题
    复制
    1. {
    2.   "aud": "https://oauth-login.cloud.huawei.com/oauth2/v3/token",
    3.   "iss": "*****",
    4.   "exp": 1581410664,
    5.   "iat": 1581407064
    6. }
    展开
    字段名 描述
    aud 固定为：https://oauth-login.cloud.huawei.com/oauth2/v3/token。
    iss 服务账号密钥文件中sub_account字段，标识数据生成者。
    exp JWT到期UTC时间戳，建议比“iat”晚3600秒。
    iat JWT签发UTC时间戳，为自UTC时间1970年1月1日00:00:00的秒数（应用服务器时间需要校准为标准时间）。

  4. 生成JWT Token数据。

    将完成BASE64编码后的Header字符串与Payload字符串，通过“.”进行连接，并在开发者的应用中，通过服务账号密钥文件中的private_key（华为不进行存储，请您妥善保管），使用SHA256withRSA/PSS算法对拼接的字符串签名，最后将Header，Payload以及字符串签名通过“.”进行连接，即可得到Token数据。

示例代码

为了方便您生成服务账号鉴权令牌，我们提供了Java语言的示例代码，请按照说明替换参数运行。

如果您使用其他开发语言，请选择对应的JWT开源组件进行开发。

收起
自动换行
深色代码主题
复制
  1. import com.alibaba.fastjson.JSONObject;
  2. import org.apache.commons.codec.binary.Base64;
  3. import org.bouncycastle.jce.provider.BouncyCastleProvider;
  4. 

  5. import java.nio.charset.StandardCharsets;
  6. import java.security.*;
  7. import java.security.spec.InvalidKeySpecException;
  8. import java.security.spec.PKCS8EncodedKeySpec;
  9. import java.util.Objects;
  10. 

  11. public class JWTGenerateDemo_test {
  12.     // please replace it with the private_key in your json file
  13.     // this is the plain text in this demo, please encrypt the private key in your code, only get the string between
  14.     // '-----BEGIN PRIVATE KEY-----\n' and '\n-----END PRIVATE KEY-----\n'
  15.     private static final String PRIVATE_KEY = "xxxx";
  16. 

  17.     // please replace it with the sub_account in your json file
  18.     private static final String ISS = "xxx";
  19. 

  20.     // please replace it with the key_id in your json file
  21.     private static final String KID = "xxx";
  22. 

  23.     private static final String AUD = "https://oauth-login.cloud.huawei.com/oauth2/v3/token";
  24. 

  25.     private static final String ALG_PS256 = "PS256";
  26. 

  27.     private static final String DOT = ".";
  28. 

  29.     private static PrivateKey getPrivateKey(String key) throws NoSuchAlgorithmException, InvalidKeySpecException {
  30.         PKCS8EncodedKeySpec keySpec = new PKCS8EncodedKeySpec(decodeBase64(key));
  31.         KeyFactory keyFactory = KeyFactory.getInstance("RSA");
  32.         return keyFactory.generatePrivate(keySpec);
  33.     }
  34. 

  35.     private static byte[] decodeBase64(String Base64Str) {
  36.         return Base64.decodeBase64(Base64Str.getBytes(StandardCharsets.UTF_8));
  37.     }
  38. 

  39.     private String createJwt()
  40.             throws NoSuchAlgorithmException, InvalidKeySpecException, InvalidKeyException, SignatureException {
  41.         long iat = System.currentTimeMillis() / 1000;
  42.         long exp = iat + 3600;//JWT有效期3600s
  43. 

  44.         // jwt header
  45.         JSONObject header = new JSONObject();
  46.         header.put("alg", ALG_PS256);
  47.         header.put("kid", KID);
  48.         header.put("typ", "JWT");
  49. 

  50.         // jwt payload
  51.         JSONObject payload = new JSONObject();
  52.         payload.put("aud", AUD);
  53.         payload.put("iss", ISS);
  54.         payload.put("exp", exp);
  55.         payload.put("iat", iat);
  56. 

  57.         // jwt signature
  58.         byte[] encodeHeaderBytes = Base64.encodeBase64URLSafe(header.toString().getBytes(StandardCharsets.UTF_8));
  59.         byte[] encodePayloadBytes = Base64.encodeBase64URLSafe(payload.toString().getBytes(StandardCharsets.UTF_8));
  60.         String encodeHeader = new String(encodeHeaderBytes, StandardCharsets.UTF_8);
  61.         String encodePayload = new String(encodePayloadBytes, StandardCharsets.UTF_8);
  62.         String jwtHeaderAndPayload = encodeHeader + DOT + encodePayload;
  63.         Signature signatureInstance = Signature.getInstance("SHA256withRSA/PSS", new BouncyCastleProvider());
  64.         signatureInstance.initSign(getPrivateKey(PRIVATE_KEY));
  65.         signatureInstance.update(jwtHeaderAndPayload.getBytes(StandardCharsets.UTF_8));
  66.         String signature =
  67.                 new String(Objects.requireNonNull(Base64.encodeBase64URLSafe(signatureInstance.sign())), StandardCharsets.UTF_8);
  68. 

  69.         return jwtHeaderAndPayload + DOT + signature;
  70.     }
  71. 

  72.     public static void main(String args[])
  73.             throws InvalidKeySpecException, NoSuchAlgorithmException, SignatureException, InvalidKeyException {
  74.         JWTGenerateDemo_test JWTGenerateDemo = new JWTGenerateDemo_test();
  75.         JWTGenerateDemo.createJwt();//获取鉴权令牌
  76.     }
  77. }

执行main()函数即可。

推荐的java版本为java8，maven依赖如下：

收起
自动换行
深色代码主题
复制
  1. <dependency>
  2.     <groupId>com.alibaba</groupId>
  3.     <artifactId>fastjson</artifactId>
  4.     <version>1.2.83</version>
  5. </dependency>
  6. <dependency>
  7.     <groupId>org.bouncycastle</groupId>
  8.     <artifactId>bcprov-jdk18on</artifactId>
  9.     <version>1.74</version>
  10. </dependency>
  11. <dependency>
  12.     <groupId>commons-codec</groupId>
  13.     <artifactId>commons-codec</artifactId>
  14.     <version>1.15</version>
  15. </dependency>
开通Device Security服务
应用设备状态检测
相关推荐
文档商家直接接入鉴权方式
文档使用ArkTS语言完成JWT鉴权令牌
文档生成服务端请求的token
文档获取用户级Token
文档华为帐号服务
文档准备证书
文档获取对账结算数据
文档JWT Payload参数填写要求和常见问题
文档（可选）用户身份验证服务接入准备
文档申请服务号
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词