IdentityCredential.Update(PersonalizationData) Method

Definition

Updates the credential with new access control profiles and data items.

[Android.Runtime.Register("update", "(Landroid/security/identity/PersonalizationData;)[B", "GetUpdate_Landroid_security_identity_PersonalizationData_Handler", ApiSince=31)]
public virtual byte[] Update (Android.Security.Identity.PersonalizationData personalizationData);
[<Android.Runtime.Register("update", "(Landroid/security/identity/PersonalizationData;)[B", "GetUpdate_Landroid_security_identity_PersonalizationData_Handler", ApiSince=31)>]
abstract member Update : Android.Security.Identity.PersonalizationData -> byte[]
override this.Update : Android.Security.Identity.PersonalizationData -> byte[]

Parameters

personalizationData
PersonalizationData

The data to update, including access control profiles and data elements and their values, grouped into namespaces.

Returns

Byte[]

A COSE_Sign1 data structure, see above.

Attributes

Remarks

Updates the credential with new access control profiles and data items.

This method is similar to WritableIdentityCredential#personalize(PersonalizationData) except that it operates on an existing credential, see the documentation for that method for the format of the returned data.

If this call succeeds an side-effect is that all dynamic authentication keys for the credential are deleted. The application will need to use #getAuthKeysNeedingCertification() to generate replacement keys and return them for issuer certification.

This is only implemented in feature version 202101 or later. If not implemented, the call fails with UnsupportedOperationException. See android.content.pm.PackageManager#FEATURE_IDENTITY_CREDENTIAL_HARDWARE for known feature versions.

Java documentation for android.security.identity.IdentityCredential.update(android.security.identity.PersonalizationData).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to