目录

TrustedAuthentication (Digital Shield)

This section describes only module-specific error codes. For details about universal error codes, please refer to Universal Error Codes.

1019100001 Permission Verification Failed

Message

permission denied.

Symptom

Permission verification failed.

Possible causes

The HAP has not obtained the digital shield permission in AppGallery Connect.

Solution

Only apps that meet the application scenario requirements can apply for this permission. Enable the digital shield service. For details, please refer to Enabling Device Security Kit.

1019100002 Parameter Check Failed

Message

argument is invalid.

Symptom

Parameter check failed.

Possible causes

A mandatory parameter is missing, or the parameter type or specifications are invalid.

Solution

Make sure all the mandatory parameters are passed and the parameter types and specifications are valid.

1019100003 Number of Consecutive Password Authentication Failures Reaches Upper Limit

Message

The number of consecutive authentication failures exceeds the maximum.

Symptom

The number of consecutive password authentication failures reaches the upper limit allowed by the digital shield service.

Possible causes

The user forgets the password, or an attacker attempts to crack the password by brute force.

Solution

The digital shield is locked. You can provide a reactivation process for the user based on the service scenario.

1019100004 Password Deletion Failure

Message

delete trusted authentication password failed.

Symptom

Internal error.

Possible causes

An exception occurred when other system APIs are called in the password deletion process.

Solution

Try again later. If the error persists, submit a ticket online.

1019100005 Password Authentication Failure

Message

trusted authentication verify failed.

Symptom

Internal error.

Possible causes

An exception occurred when other system APIs are called in the password authentication process.

Solution

Try again later. If the error persists, submit a ticket online.

1019100006 Input Text Check Failure

Message

Check input confirm text failed.

Symptom

Internal error.

Possible causes

The device does not support TUI or the TUI service is faulty.

Solution

Check whether the device supports the digital shield capability. If so, try again. If the retry fails, submit a ticket online for assistance.

1019100007 Unsupported Image Format

Message

Unsupported custom image.

Symptom

The input image format is not supported.

Possible causes

The input image format does not meet the requirements. The digital shield service APIs require that the image format be RGBA PNG and the image width and height be within 216.

Solution

Ensure that the input image meets the format requirements of the digital shield service.

1019100008 Operation Canceled by User

Message

The user canceled the operation.

Symptom

The service operation is canceled by the user.

Possible causes

The user cancels the operation on the TUI or the TUI automatically exits after 2 minutes of user inactivity.

Solution

This is not an error, as the user proactively ends the process.

1019100009 Backup Data Export Failure

Message

Failed to export data.

Symptom

Failed to export the backup data.

Possible causes

The corresponding backup data is not imported, or the password authentication fails during backup data export.

Solution

Ensure that the data has been correctly imported and the user password authentication is successful during data export.

1019100010 Backup Data Import Failure

Message

Failed to import data.

Symptom

Failed to import the backup data.

Possible causes

The backup data can be imported only once. If the backup data is imported repeatedly, an error is reported.

Solution

Ensure that the data is correctly imported for the first time. When the digital shield service is disabled, the lifecycle of the imported data ends.

1019100011 Invalid TUI Authentication Information

Message

The text content cannot be displayed.

Symptom

Invalid TUI authentication information.

Possible causes

The entered authentication information is in an invalid format or exceeds the allowed length.

Solution

Ensure that the entered TUI authentication information meets the requirements.

1019100012 Invalid authID

Message

Invalid authentication ID.

Symptom

Invalid authID.

Possible causes

The password authID passed during the operation is different from that obtained when the password is created.

Solution

Ensure that the passed authID is the one obtained when the password is created.

1019100013 Password Creation Failure

Message

Set trusted authentication password failed.

Symptom

Internal error.

Possible causes

An exception occurred when other system APIs are called in the password creation process.

Solution

Try again later. If the error persists, submit a ticket online.

1019100014 Password Change Failure

Message

Modify trusted authentication password failed.

Symptom

Internal error.

Possible causes

An exception occurred when other system APIs are called in the password change process.

Solution

Try again later. If the error persists, submit a ticket online.

1019100015 Biometric Authentication authToken Issuance Failure

Message

Get biometric authToken failed.

Symptom

Internal error.

Possible causes

The input tuiAuthToken and bioAuthToken are from different sessions, or the ATL level of bioAuthToken is not ATL4.

Solution

Troubleshoot the possible causes first. If none of the possible causes is involved, submit a ticket online.

1019100016 Digital Shield Service Disabled

Message

The trusted authentication feature is not enabled.

Symptom

The digital shield service is not enabled.

Possible causes

The device does not support the digital shield service, or the digital shield service fails to be enabled on the device.

Solution

Ensure that the device supports the digital shield service.

1019100017 Failed to Obtain the Number of Remaining Authentication Times

Message

Failed to get the remaining number of authentication attempts.

Symptom

Failed to obtain the number of remaining authentication times of the digital shield.

Possible causes

An exception occurred when other system APIs are called in the process of obtaining the number of remaining authentication times of the digital shield.

Solution

Try again later. If the error persists, submit a ticket online.

1019100018 Failed to Disable the Authentication Capability of a Specified Biometric Feature

Message

Failed to unbind the corresponding biometric data.

Symptom

Failed to disable the authentication capability of a specified biometric feature.

Possible causes

An exception occurred when other system APIs are called in the process of disabling the authentication capability of a specified biometric feature.

Solution

Try again later. If the error persists, submit a ticket online.

1019100019 Not Matching the Bound Biometric Feature

Message

The biometric data for authentication does not match the bound biometric feature.

Symptom

The authenticated biometric feature does not match the bound biometric feature.

Possible causes

The authenticated biometric feature, for example, fingerprint, does not match the bound biometric feature.

Solution

Instruct the user to use the bound biometric feature for authentication.

1019100020 Biometric Feature Already Bound

Message

The biometric data has already been bound.

Symptom

The biometric feature is bound repeatedly.

Possible causes

The biometric feature is bound repeatedly.

Solution

Notify the user that the biometric feature has been bound.

1019100021 Biometric Feature Not Bound

Message

The corresponding biometric data has not been bound.

Symptom

The biometric feature is not bound.

Possible causes

During biometric authentication or biometric feature unbinding, it is found that the corresponding biometric feature is not bound.

Solution

Ensure that the biometric feature has been bound.

1019100023 Security Element Fault

Message

Secure element fault.

Symptom

The security element is faulty.

Possible causes

The security element is faulty.

Solution

Enable the TEE-level digital shield.

1019100024 Bound Biometric ID Has Expired

Message

The bound biometric ID is invalid.

Symptom

The bound biometric ID is invalid.

Possible causes

The bound biometric feature has been deleted from the system.

Solution

Unbind the specified biometric feature from the digital shield service and bind a valid biometric ID.

1019100025 TUI Occupied by Another App

Message

The TUI is occupied by another app.

Symptom

The TUI is occupied by another app.

Possible causes

The TUI does not support concurrent operations. If another app is currently occupying the TUI, subsequent requests to launch the TUI will fail.

Solution

Exit the occupied TUI or wait for the app using the TUI to finish its operation before initiating the request again.