Partager via


KeyChain.GetCertificateChain(Context, String) Méthode

Définition

Retourne la X509Certificate chaîne de l’alias demandé, ou null si l’alias n’existe pas ou si l’appelant n’a pas l’autorisation d’y accéder (voir la remarque sur les exceptions dans #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[]

Paramètres

context
Context
alias
String

Alias de la chaîne de certificats souhaitée, généralement retourné via KeyChainAliasCallback#alias.

Retours

Attributs

Exceptions

si l’alias était valide, mais qu’il y avait un problème d’accès.

s’il est appelé à partir du thread principal.

Remarques

Retourne la X509Certificate chaîne de l’alias demandé, ou null si l’alias n’existe pas ou si l’appelant n’a pas l’autorisation d’y accéder (voir la remarque sur les exceptions dans #getPrivateKey).

<>strong Remarque :</strong> Si une chaîne de certificats a été spécifiée explicitement lors de l’installation de l’alias, cette méthode retourne cette chaîne. Si seul le certificat client a été spécifié au moment de l’installation, cette méthode tente de créer une chaîne de certificats à l’aide de toutes les ancres d’approbation disponibles (préinstallées et ajoutées par l’utilisateur).

Cette méthode peut bloquer lors de l’attente d’une connexion à un autre processus et ne doit jamais être appelée à partir du thread principal.

Comme Activity et Service les contextes sont de courte durée et peuvent être détruits à tout moment à partir du thread principal, il est plus sûr de s’appuyer sur un contexte de longue durée tel qu’un contexte retourné par Context#getApplicationContext().

Si l’appelant spécifie un alias pour lequel il n’a pas d’octroi, il doit appeler #choosePrivateKeyAlias à nouveau. Pour plus d’informations sur la gestion de ce scénario, consultez #getPrivateKey cette rubrique.

Documentation Java pour android.security.KeyChain.getCertificateChain(android.content.Context, java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à