语言

KeyChain 类

定义

此类 KeyChain 提供对凭据存储中私钥及其相应证书链的访问权限。

[Android.Runtime.Register("android/security/KeyChain", DoNotGenerateAcw=true)]
public sealed class KeyChain : Java.Lang.Object
[<Android.Runtime.Register("android/security/KeyChain", DoNotGenerateAcw=true)>]
type KeyChain = class
    inherit Object
继承
特性

注解

此类 KeyChain 提供对凭据存储中私钥及其相应证书链的访问权限。

访问 KeyChain 通常执行以下步骤的应用程序:

<ol>

<li>从 javax.net.ssl.X509KeyManager X509KeyManager 请求私钥的回调。

<li>调用 #choosePrivateKeyAlias choosePrivateKeyAlias 以允许用户从当前可用的私钥和相应的证书链列表中选择。 选择的别名将由回调 KeyChainAliasCallback#alias返回,如果没有私钥可用,或者用户取消请求,则为 null。

<li>调用 #getPrivateKey 并 #getCertificateChain 检索凭据以返回到相应的 javax.net.ssl.X509KeyManager 回调。

</ol>

应用程序可能会记住所选别名的值,以避免在后续连接时提示用户 #choosePrivateKeyAlias choosePrivateKeyAlias 。 如果别名不再有效,将使用该值在查找时返回 null

应用程序可以通过提供的Intent密钥和证书#createInstallIntent请求安装。 通过此密钥安装的私钥可通过Intent访问,#choosePrivateKeyAlias而证书颁发机构(CA)证书将通过默认X509TrustManager的所有应用程序信任。

Java文档android.security.KeyChain。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
KeyChain()

初始化 KeyChain 类的新实例。

字段

名称 说明
ActionKeyAccessChanged

广播操作:指示私钥的访问权限已更改。

ActionKeychainChanged

广播操作:指示密钥链的内容已更改。

ActionStorageChanged

广播操作:指示受信任的存储已更改。

ActionTrustStoreChanged

广播操作:指示受信任的证书存储的内容已更改。

ExtraCertificate

可选,用于指定要在返回者Intent上安装的 #createInstallIntent X.509 证书。

ExtraKeyAccessible

如果应用程序可以访问密钥,则用作用于提供的布尔额外字段 #ACTION_KEY_ACCESS_CHANGED 。

ExtraKeyAlias

用作字符串额外字段 #ACTION_KEY_ACCESS_CHANGED ,以提供键的别名。

ExtraName

可选,用于在返回者String时Intent指定#createInstallIntent凭据名称。

ExtraPkcs12

用于返回的Intent可选附加#createInstallIntent项,用于指定要安装的 PKCS#12 密钥存储。

KeyAliasSelectionDenied

由 DPC 或委托的应用使用 android.app.admin.DeviceAdminReceiver#onChoosePrivateKeyAlias ,或 android.app.admin.DelegatedAdminReceiver#onChoosePrivateKeyAlias 标识请求的应用未授予对任何密钥的访问权限,并且用户也无法手动授予访问权限。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)

方法

名称 说明
ChoosePrivateKeyAlias(Activity, IKeyChainAliasCallback, String[], IPrincipal[], String, Int32, String)

启动一个 Activity 供用户选择私钥的别名和用于身份验证的证书对。

ChoosePrivateKeyAlias(Activity, IKeyChainAliasCallback, String[], IPrincipal[], Uri, String)

启动一个 Activity 供用户选择私钥的别名和用于身份验证的证书对。

ChoosePrivateKeyAliasAsync(Activity, String[], IPrincipal[], String, Int32, String)

显示用户选择私钥别名、按主机和端口进行筛选的系统 UI。

ChoosePrivateKeyAliasAsync(Activity, String[], IPrincipal[], Uri, String)

显示用户选择私钥别名的系统 UI,按 URI 进行筛选。

ChooseX509Certificate2WithPrivateKeyAsync(Activity, String[], IPrincipal[], String, Int32, String)

显示用户选择证书的系统 UI,然后检索其私钥对应的 X509Certificate2 密钥,按主机和端口进行筛选。

ChooseX509Certificate2WithPrivateKeyAsync(Activity, String[], IPrincipal[], Uri, String)

显示用户选择证书的系统 UI,然后检索其私钥的对应 X509Certificate2 项,并按 URI 进行筛选。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
CreateInstallIntent()

返回可用于凭据安装的一个 Intent 。

CreateManageCredentialsIntent(AppUriAuthenticationPolicy)

返回应用应用来请求管理用户的凭据的一个 Intent 值。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetCertificateChain(Context, String)

返回X509Certificate所请求别名的链;如果别名不存在,或者调用方没有访问别名的权限,则返回 null(请参阅有关异常的注释)。#getPrivateKey

GetCredentialManagementAppPolicy(Context)

凭据管理应用调用以获取身份验证策略 AppUriAuthenticationPolicy。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetPrivateKey(Context, String)

返回 PrivateKey 请求的别名;如果别名不存在,或者调用方无权访问别名,则返回 null(请参阅下面的异常说明)。

GetX509Certificate2WithPrivateKey(Context, String)

X509Certificate2从 Android 系统密钥链中检索与其关联的私钥。

IsBoundKeyAlgorithm(String)
已过时.

如果 true 当前设备 KeyChain 在导入或生成后将任何 PrivateKey 给定 algorithm 设备绑定到设备,则返回。

IsCredentialManagementApp(Context)

检查调用方是否为凭据管理应用 CredentialManagementApp。

IsKeyAlgorithmSupported(String)

返回 true 当前设备 KeyChain 是否支持 PrivateKey 由 algorithm (e.

JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RemoveCredentialManagementApp(Context)

凭据管理应用 CredentialManagementApp 调用以注销作为凭据管理应用,并停止管理用户的凭据。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于