KeyGenParameterSpec.Builder.SetMaxUsageCount(Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta il numero massimo di volte in cui è consentita l'utilizzo della chiave.
[Android.Runtime.Register("setMaxUsageCount", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=31)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetMaxUsageCount(int maxUsageCount);
[<Android.Runtime.Register("setMaxUsageCount", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=31)>]
member this.SetMaxUsageCount : int -> Android.Security.Keystore.KeyGenParameterSpec.Builder
Parametri
- maxUsageCount
- Int32
numero massimo di volte in cui la chiave può essere usata o KeyProperties.UNRESTRICTED_USAGE_COUNT se non esiste alcuna restrizione sull'utilizzo.
Valori restituiti
- Attributi
Commenti
Imposta il numero massimo di volte in cui è consentita l'utilizzo della chiave. Dopo ogni utilizzo della chiave, il contatore use diminuisce. Questa autorizzazione si applica solo alle operazioni di chiave privata e chiave privata. Le operazioni con chiave pubblica non sono limitate. Ad esempio, dopo aver crittografato e decrittografato correttamente i dati usando metodi come Cipher.doFinal(), il contatore di utilizzo della chiave privata diminuisce. Dopo aver firmato correttamente i dati usando metodi come Signature.sign(), il contatore di utilizzo della chiave privata diminuirà. Quando il contatore dell'uso viene esaurito, la chiave verrà contrassegnata per l'eliminazione dall'archivio chiavi Android e qualsiasi tentativo successivo di usare la chiave genererà KeyPermanentlyInvalidatedException. Non è presente alcuna chiave da caricare dall'archivio chiavi Android dopo l'eliminazione definitiva della chiave esaurita, come se la chiave non esistesse mai prima.
Per impostazione predefinita, non esiste alcuna restrizione sull'utilizzo della chiave.
Alcuni hardware sicuri potrebbero non supportare affatto questa funzionalità, nel qual caso verrà applicata nel software, alcuni hardware sicuri possono supportarlo, ma solo con maxUsageCount = 1 e alcuni hardware sicuri possono supportarlo con un valore maggiore di maxUsageCount.
Flag di funzionalità PackageManager: PackageManager.FEATURE_KEYSTORE_SINGLE_USE_KEY e PackageManager.FEATURE_KEYSTORE_LIMITED_USE_KEY possono essere usati per verificare se l'hardware sicuro non può applicare questa funzionalità, può applicarlo solo con maxUsageCount = 1 oppure può applicarlo con un valore maggiore di maxUsageCount.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.