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_MANAGER。 51 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