Language

KeyGenParameterSpec.Builder.SetUserAuthenticationValidityDurationSeconds メソッド

定義

ユーザーが正常に認証された後に、このキーの使用が承認される時間 (秒) を設定します。

[Android.Runtime.Register("setUserAuthenticationValidityDurationSeconds", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=23)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetUserAuthenticationValidityDurationSeconds(int seconds);
[<Android.Runtime.Register("setUserAuthenticationValidityDurationSeconds", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=23)>]
member this.SetUserAuthenticationValidityDurationSeconds : int -> Android.Security.Keystore.KeyGenParameterSpec.Builder

パラメーター

seconds
Int32

時間 (秒単位)、またはキーを使用するたびにユーザー認証を実行する必要がある場合は -1。 値が -1 以上

返品

属性

注釈

このメソッドは、API レベル 30 では非推奨になりました。 setUserAuthenticationParameters(int, int) を参照してください。

ユーザーが正常に認証された後に、このキーの使用が承認される時間 (秒) を設定します。 これは、キーが使用するためにユーザー認証を必要とする場合に有効です (setUserAuthenticationRequired(boolean) を参照してください)。

既定では、ユーザー認証が必要な場合は、キーを使用するたびに行う必要があります。

すべての操作でユーザー認証を行う必要があるキーを含む暗号化操作では、生体認証のみを使用できます。 これを実現するには、キーを使用して暗号化操作 (署名、暗号、Mac) を初期化し、それを BiometricPrompt.CryptoObject にラップし、CryptoObject で BiometricPrompt.authenticate を呼び出し、認証フローが成功した場合にのみ暗号化操作を続行します。

ユーザー認証イベントが成功した後に一定期間使用することが承認されているキーを含む暗号化操作では、セキュリティで保護されたロック画面認証のみを使用できます。 これらの暗号化操作は、続行するためにユーザーを認証する必要がある場合、初期化中に UserNotAuthenticatedException をスローします。 この状況を解決するには、ユーザーが Android のセキュリティで保護されたロック画面のロックを解除するか、KeyguardManager.createConfirmDeviceCredentialIntent(CharSequence,CharSequence) によって開始された資格情報の確認フローを実行します。 解決したら、ユーザー認証フローが正常に完了していれば、このキー (またはユーザー認証後に一定の期間使用することが承認されているその他のキー) を使用して新しい暗号化操作を初期化する必要があります。

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

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

適用対象