語言

KeyInfo 類別

定義

關於 Android Keystore 系統中金鑰的資訊。

[Android.Runtime.Register("android/security/keystore/KeyInfo", ApiSince=23, DoNotGenerateAcw=true)]
public class KeyInfo : Java.Lang.Object, IDisposable, Java.Security.Spec.IKeySpec
[<Android.Runtime.Register("android/security/keystore/KeyInfo", ApiSince=23, DoNotGenerateAcw=true)>]
type KeyInfo = class
    inherit Object
    interface IKeySpec
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
繼承
屬性
實作

備註

關於 Android Keystore 系統中金鑰的資訊。 此類別描述金鑰材料是否可在安全硬體之外以明文形式取得,使用金鑰是否需要使用者驗證,且此要求是否由安全硬體強制執行,金鑰來源、金鑰被授權使用方式(例如僅在 GCM 模式中或僅簽署)、金鑰是否應在靜態時加密, 鑰匙以及有效期的開始與結束日期。

此類別的實例是不可變的。

<h3>範例:對稱金鑰</h3> 以下範例說明如何取得 KeyInfo 描述所提供 Android 金鑰庫 SecretKey的 。

{@code
            SecretKey key = ...; // Android Keystore key

            SecretKeyFactory factory = SecretKeyFactory.getInstance(key.getAlgorithm(), "AndroidKeyStore");
            KeyInfo keyInfo;
            try {
                keyInfo = (KeyInfo) factory.getKeySpec(key, KeyInfo.class);
            } catch (InvalidKeySpecException e) {
                // Not an Android KeyStore key.
            }}

<h3>範例:私鑰</h3> 以下範例說明如何取得 KeyInfo 描述所提供的 Android KeyStore PrivateKey的 。

{@code
            PrivateKey key = ...; // Android KeyStore key

            KeyFactory factory = KeyFactory.getInstance(key.getAlgorithm(), "AndroidKeyStore");
            KeyInfo keyInfo;
            try {
                keyInfo = factory.getKeySpec(key, KeyInfo.class);
            } catch (InvalidKeySpecException e) {
                // Not an Android KeyStore key.
            }}

Java 文件 android.security.keystore.KeyInfo。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

建構函式

名稱 Description
KeyInfo(IntPtr, JniHandleOwnership)

建立一個受管理實例,代表一個現有的 Java 物件。

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Handle

底層 Android 實例的帳號。

(繼承來源 Object)
IsInsideSecureHardware

true如果金鑰位於安全硬體中(例如,

IsInvalidatedByBiometricEnrollment

若鑰匙因登記新指紋或移除所有指紋而失效,則可退還 true 。

IsTrustedUserPresenceRequired

如果該金鑰只能在簽名後成功測試使用者在場時才使用,則回傳 true 。

IsUnlockedDeviceRequired

若鑰匙被授權只能在裝置解鎖時使用,則會退貨 true 。

IsUserAuthenticationRequired

若金鑰被授權僅在使用者已認證時使用,則會回傳 true 。

IsUserAuthenticationRequirementEnforcedBySecureHardware

true若安全硬體(例如:

IsUserAuthenticationValidWhileOnBody

如果該金鑰在裝置從使用者體內移除後無法使用,則會回傳 true 。

IsUserConfirmationRequired

若金鑰被授權僅用於使用者確認的訊息,則會回傳 true 。

JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

KeySize

它會以位元計算金鑰的大小。

KeystoreAlias

取得將金鑰存放在 AndroidKeyStore.

KeyValidityForConsumptionEnd

取得時間瞬間,之後金鑰不再有效,無法進行解密和驗證。

KeyValidityForOriginationEnd

會立即獲得該金鑰不再有效用於加密和簽署的時間。

KeyValidityStart

取得金鑰尚未有效的時間。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
Purposes

取得金鑰可用於的目的集合(例如加密、解密、簽名)。

RemainingUsageCount

回傳該金鑰允許使用的剩餘次數,或 KeyProperties#UNRESTRICTED_USAGE_COUNT 若對金鑰使用次數沒有限制。

SecurityLevel

回傳金鑰所受保護的安全等級。

ThresholdClass

取得用於虛擬方法派遣的 Java 類別。

ThresholdType

取得宣告這個 Java 綁定的受管理型別。

UserAuthenticationType

取得可授權使用此金鑰的使用者驗證類型。

UserAuthenticationValidityDurationSeconds

取得使用者成功認證後,該金鑰被授權使用的時間(秒數)。

方法

名稱 Description
Clone()

建立並回傳此物件的副本。

(繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
GetBlockModes()

取得一組區塊模式(例如, GCM, CBC),可用於加密/解密時使用金鑰的模式。

GetDigests()

取得可使用該鍵的消化演算法集合(例如, SHA-256, SHA-384)。

GetEncryptionPaddings()

取得一組填充方案(例如, PKCS7Padding、 PKCS1Padding、 NoPadding)可用於加密/解密時使用金鑰的組合。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetSignaturePaddings()

取得一組填充方案(例如, PSS,), PKCS#1可用於簽署/驗證時使用金鑰。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
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)

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於