语言

HttpEngine.Builder.AddPublicKeyPins 方法

定义

固定给定主机的一组公钥。

[Android.Runtime.Register("addPublicKeyPins", "(Ljava/lang/String;Ljava/util/Set;ZLjava/time/Instant;)Landroid/net/http/HttpEngine$Builder;", "GetAddPublicKeyPins_Ljava_lang_String_Ljava_util_Set_ZLjava_time_Instant_Handler", ApiSince=34)]
public virtual Android.Net.Http.HttpEngine.Builder AddPublicKeyPins(string hostName, System.Collections.Generic.ICollection<byte[]> pinsSha256, bool includeSubdomains, Java.Time.Instant expirationInstant);
[<Android.Runtime.Register("addPublicKeyPins", "(Ljava/lang/String;Ljava/util/Set;ZLjava/time/Instant;)Landroid/net/http/HttpEngine$Builder;", "GetAddPublicKeyPins_Ljava_lang_String_Ljava_util_Set_ZLjava_time_Instant_Handler", ApiSince=34)>]
abstract member AddPublicKeyPins : string * System.Collections.Generic.ICollection<byte[]> * bool * Java.Time.Instant -> Android.Net.Http.HttpEngine.Builder
override this.AddPublicKeyPins : string * System.Collections.Generic.ICollection<byte[]> * bool * Java.Time.Instant -> Android.Net.Http.HttpEngine.Builder

参数

hostName
String

公钥应固定到的主机的名称。 仅包含数字和点字符的主机被视为无效。 此值不能为 null。

pinsSha256
ICollection<Byte[]>

一组引脚。 每个引脚都是主机 X.509 证书的使用者公钥信息(SPKI)的 DER 编码 ASN.1 表示形式的 SHA-256 加密哈希。 使用 Certificate.getPublicKey() 和 Key.getEncoded() 获取 SPKI 的 DER 编码 ASN.1 表示形式。 尽管此方法不要求存在备份引脚,如果主私钥的控制已丢失,则强烈建议提供备份引脚。 此值不能为 null。

includeSubdomains
Boolean

指示是否应将固定策略应用于 hostName 的子域。

expirationInstant
Instant

指定引脚的过期时间。 此值不能为 null。

返回

用于促进链接的生成器。 此值不能为 null。

特性

注解

固定给定主机的一组公钥。 通过固定一组公钥、pinsSha256,与 hostName 的通信需要使用一组固定公钥的证书进行身份验证。 应用可以固定根证书、任何中间证书或最终入口证书的公钥。 如果主机的证书链中没有公钥,身份验证将失败,并且不会建立安全通信,即使主机尝试使用设备受信任存储证书所允许的证书进行身份验证也是如此。

使用同一主机名多次调用此方法会替代以前为主机设置的引脚。

有关公钥固定的详细信息,请参阅 RFC 7469。

Android 参考。android.net.http.HttpEngine.Builder.addPublicKeyPins

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于