Language

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

定義

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

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

パラメーター

required
Boolean

返品

属性

注釈

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

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

ユーザー認証が必要な場合は、セキュリティで保護されたロック画面が設定されている場合にのみキーを生成できます (KeyguardManager.isDeviceSecure()を参照)。 ユーザーは、パスワード、PIN、パターン、生体認証など、セキュリティで保護されたロック画面資格情報を使用してデバイスに対して認証することで、キーの使用を承認します。

すべての用途で認証を必要とする生体認証のみの構成では、少なくとも 1 つの生体認証を登録する必要があります (BiometricManager.canAuthenticate() を参照してください)。 セキュリティで保護されたロック画面が無効になっているか、強制的にリセットされた場合、キーは元に戻すことはできません。 すべての使用に対して認証を必要とする生体認証のみの構成では、新しい生体認証が登録されている場合、または生体認証が登録されたままでない場合にも無効になります。ただし、setInvalidatedByBiometricEnrollment(boolean) では登録後に有効性が許可されません。 setUserAuthenticationParameters(int, int) にKeyProperties.AUTH_DEVICE_CREDENTIALを含む構成は、この生体認証登録の前提条件の対象ではありません。

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

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

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

適用対象