KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) メソッド

[Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyProtection$Builder;", "", ApiSince=23)]
public Android.Security.Keystore.KeyProtection.Builder SetUserAuthenticationRequired(bool required);

[<Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyProtection$Builder;", "", ApiSince=23)>]
member this.SetUserAuthenticationRequired : bool -> Android.Security.Keystore.KeyProtection.Builder

パラメーター

返品

属性

RegisterAttribute

注釈

ユーザーが認証されている場合にのみ、このキーの使用が承認されているかどうかを設定します。

既定では、ユーザーが認証されているかどうかに関係なく、キーの使用が承認されます。

ユーザー認証が必要な場合: セキュリティで保護されたロック画面が設定されている場合にのみ、キーをインポートできます (KeyguardManager.isDeviceSecure()を参照してください)。 さらに、キーがキーを使用するたびにユーザー認証が行われる必要がある場合 (setUserAuthenticationValidityDurationSeconds(int)を参照)、少なくとも 1 つの生体認証を登録する必要があります (BiometricManager.canAuthenticate()を参照)。パスワード/PIN/パターンや生体認証などのセキュリティで保護されたロック画面の資格情報のサブセットを使用して、この Android デバイスに対して認証することで、キーの使用をユーザーが承認する必要があります。 詳細情報。セキュリティで保護されたロック画面が無効になった場合 (なし、スワイプ、またはユーザーを認証しないその他のモードに再構成)、またはセキュリティで保護されたロック画面が強制的にリセットされると (デバイス管理者など)、キーは元に戻すことができなくなります。 さらに、キーがキーを使用するたびにユーザー認証が行われる必要がある場合は、登録後に setInvalidatedByBiometricEnrollment(boolean) を使用して有効性を許可しない限り、新しい生体認証が登録された後、または生体認証が登録されなくなった場合も、元に戻すことはできません。 このようなキーを使用して暗号化操作を初期化しようとすると、KeyPermanentlyInvalidatedException がスローされます。

この承認は、秘密鍵と秘密キーの操作にのみ適用されます。 公開キーの操作は制限されません。

android.security.keystore.KeyProtection.Builder.setUserAuthenticationRequiredの Android リファレンス。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。