• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Class (ClientAuthenticationHandler)
2<!--Kit: ArkWeb-->
3<!--Subsystem: Web-->
4<!--Owner: @aohui-->
5<!--Designer: @yaomingliu-->
6<!--Tester: @ghiker-->
7<!--Adviser: @HelloCrease-->
8
9Web组件返回的SSL客户端证书请求事件用户处理功能对象。示例代码参考[onClientAuthenticationRequest事件](./arkts-basic-components-web-events.md#onclientauthenticationrequest9)。
10
11> **说明:**
12>
13> - 该组件从API version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
14>
15> - 本Class首批接口从API version 9开始支持。
16>
17> - 示例效果请以真机运行为准,当前DevEco Studio预览器不支持。
18
19## constructor<sup>9+</sup>
20
21constructor()
22
23ClientAuthenticationHandler的构造函数。
24
25**系统能力:** SystemCapability.Web.Webview.Core
26
27## confirm<sup>9+</sup>
28
29confirm(priKeyFile : string, certChainFile : string): void
30
31通知Web组件使用指定的私钥和客户端证书链。
32
33**系统能力:** SystemCapability.Web.Webview.Core
34
35**参数:**
36
37| 参数名           | 类型   | 必填   | 说明               |
38| ------------- | ------ | ---- | ------------------ |
39| priKeyFile    | string | 是    | 存放私钥文件的完整路径。  |
40| certChainFile | string | 是    | 存放证书链文件的完整路径。 |
41
42## confirm<sup>10+</sup>
43
44confirm(authUri : string): void
45
46通知Web组件使用指定的凭据(从证书管理模块获得)。
47
48> **说明:**
49>
50> 需要配置权限:ohos.permission.ACCESS_CERT_MANAGER51
52**系统能力:** SystemCapability.Web.Webview.Core
53
54**参数:**
55
56| 参数名     | 类型   | 必填   | 说明    |
57| ------- | ------ | ---- | ------- |
58| authUri | string | 是    | 凭据的关键值。 |
59
60支持的证书签名算法以及秘钥长度详见下表。
61| 签名算法     | 秘钥长度   |
62| ------- | ------ |
63| SSL_SIGN_RSA_PKCS1_SHA256 | 1024(API version 18后开始支持)、2048、3072、4096 |
64| SSL_SIGN_RSA_PKCS1_SHA384 | 1024(API version 18后开始支持)、2048、3072、4096 |
65| SSL_SIGN_RSA_PKCS1_SHA512 | 1024(API version 18后开始支持)、2048、3072、4096 |
66| SSL_SIGN_RSA_PSS_SHA256 | 1024(API version 18后开始支持)、2048、3072、4096 |
67| SSL_SIGN_RSA_PSS_SHA384 | 1024(API version 18后开始支持)、2048、3072、4096 |
68| SSL_SIGN_RSA_PSS_SHA512 | 1024(API version 18后开始支持)、2048、3072、4096 |
69| SSL_SIGN_ECDSA_SECP256R1_SHA256 | 256 |
70| SSL_SIGN_ECDSA_SECP384R1_SHA384 | 384 |
71| SSL_SIGN_ECDSA_SECP521R1_SHA512 | 521 |
72
73## cancel<sup>9+</sup>
74
75cancel(): void
76
77通知Web组件取消相同host和port服务器发送的客户端证书请求事件。同时,相同host和port服务器的请求,不重复上报该事件。
78
79**系统能力:** SystemCapability.Web.Webview.Core
80
81## ignore<sup>9+</sup>
82
83ignore(): void
84
85通知Web组件忽略本次请求。
86
87**系统能力:** SystemCapability.Web.Webview.Core