Language

HttpEngine.Builder.AddPublicKeyPins メソッド

定義

名前空間:
Android.Net.Http
アセンブリ:
Mono.Android.dll

特定のホストの公開キーのセットをピン留めします。

[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 にすることはできません。

返品

HttpEngine.Builder

チェーンを容易にするビルダー。 この値は null にすることはできません。

属性
RegisterAttribute

注釈

特定のホストの公開キーのセットをピン留めします。 一連の公開キー pinSha256 をピン留めすることで、hostName との通信は、固定された一連の公開キーを使用して証明書で認証する必要があります。 アプリは、ルート証明書の公開キー、中間証明書、またはエントリの終了証明書をピン留めできます。 認証は失敗し、ホストの証明書チェーンに公開キーが存在しない場合、ホストがデバイスの信頼された証明書ストアで許可されている証明書で認証を試みる場合でも、セキュリティで保護された通信は確立されません。

同じホスト名でこのメソッドを複数回呼び出すと、以前に設定したホストのピンがオーバーライドされます。

公開キーのピン留めの詳細については、RFC 7469 を参照してください。

android.net.http.HttpEngine.Builder.addPublicKeyPinsの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象