KeyChain.GetCertificateChain(Context, String) メソッド

定義

要求されたエイリアスのチェーンを X509Certificate 返します。別名が存在しない場合、または呼び出し元にアクセスするアクセス許可がない場合は null を返します (の例外 #getPrivateKeyに関するメモを参照してください)。

[Android.Runtime.Register("getCertificateChain", "(Landroid/content/Context;Ljava/lang/String;)[Ljava/security/cert/X509Certificate;", "")]
public static Java.Security.Cert.X509Certificate[]? GetCertificateChain (Android.Content.Context context, string alias);
[<Android.Runtime.Register("getCertificateChain", "(Landroid/content/Context;Ljava/lang/String;)[Ljava/security/cert/X509Certificate;", "")>]
static member GetCertificateChain : Android.Content.Context * string -> Java.Security.Cert.X509Certificate[]

パラメーター

context
Context
alias
String

通常は を介して KeyChainAliasCallback#alias返される、目的の証明書チェーンのエイリアス。

戻り値

属性

例外

エイリアスが有効であったが、それにアクセスする問題が発生した場合は 。

メイン スレッドから呼び出された場合は 。

注釈

要求されたエイリアスのチェーンを X509Certificate 返します。別名が存在しない場合、または呼び出し元にアクセスするアクセス許可がない場合は null を返します (の例外 #getPrivateKeyに関するメモを参照してください)。

<strong>Note:</strong> エイリアスのインストール時に証明書チェーンが明示的に指定された場合、このメソッドはそのチェーンを返します。 インストール時にクライアント証明書のみが指定された場合、このメソッドは使用可能なすべてのトラスト アンカー (プレインストール済みおよびユーザー追加) を使用して証明書チェーンを構築しようとします。

このメソッドは、別のプロセスへの接続の待機中にブロックする可能性があり、メイン スレッドから呼び出さないでください。

Activityコンテキストと Service コンテキストは有効期間が短く、メイン スレッドからいつでも破棄できるため、 からContext#getApplicationContext()返されるコンテキストなど、有効期間の長いコンテキストに依存する方が安全です。

呼び出し元が許可がないエイリアスを指定した場合は、再度 を呼び出す #choosePrivateKeyAlias 必要があります。 このシナリオに対処する方法の詳細については、「」を参照してください #getPrivateKey

の Java ドキュメント android.security.KeyChain.getCertificateChain(android.content.Context, java.lang.String)

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

適用対象