harmony 鸿蒙User Authentication Error Codes

2023-02-03
浏览 (916)

User Authentication Error Codes

NOTE

This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.

12500001 Authentication Failed

Error Message

Authentication failed.

Possible Causes

The credential does not match the credential enrolled.

Solution

Initiate authentication again.

12500002 General Operation Error

Error Message

General operation error.

Possible Causes

An error occurs when the NAPI layer parses parameters.
The process of the user authentication service is not started.
The proxy client fails to write data over IPC.
The stub server fails to parse data over IPC.
The driver service is not obtained.

Solution

Call the API again later or restart the device.

12500003 Authentication Canceled

Error Message

Authentication canceled.

Possible Causes

The authentication operation has been canceled.

Solution

Initiate the authentication again.

12500004 Authentication Timed Out

Error Message

Authentication timeout.

Possible Causes

The authentication is not complete within the specified time.

Solution

Initiate the authentication again.

12500005 Unsupported Authentication Type

Error Message

The authentication type is not supported.

Possible Causes

The input authentication type parameter is not supported. For example, if the authentication type passed in getAvailableStatus of the userAuth module is not FACE or FINGERPRINT, error code 12500005 is returned.
The device does not support the authentication type. For example, if fingerprint authentication is initiated on a device that has no fingerprint sensor, error code 12500005 is returned.

Solution

Check the authentication type parameter and call the API again.

12500006 Unsupported Authentication Trust Level

Error Message

The authentication trust level is not supported.

Possible Causes

The authTrustLevel value in getAvailableStatus or getAuthInstance of the userAuth module is not in the range [ATL1, ATL2, ATL3, ATL4].
The device does not support the authentication trust level. For example, if facial authentication for payment is initiated on a device that has only 2D cameras, error code 12500006 is returned.

Solution

Check that the authTrustLevel passed in is within the value range, and the device supports the specified authentication trust level.

12500007 Authentication Service Unavailable

Error Message

Authentication service is busy.

Possible Causes

Another authentication is initiated when the current authentication has not been finished yet.

Solution

Initiate authentication again later.

12500009 Authentication Locked

Error Message

Authentication is lockout.

Possible Causes

The number of authentication failures exceeds the limit.

Solution

Initiate authentication later.

12500010 Credential Not Enrolled

Error Message

The type of credential has not been enrolled.

Possible Causes

The authType parameter set in getAvailableStatus of the userAuth module is FACE, but no facial credential is enrolled in the device. start() is called to initiate facial authentication, but no facial credential is enrolled in the device.

Solution

Check that the related type of credential has been enrolled in the device.

12700001 Failed to Enroll Faces

Error Message

The operation is failed.

Possible Causes

The facial authentication service is not started when setSurfaceId() of the userAuth module is called.
The proxy client fails to write data over IPC.
The stub server fails to parse data over IPC.
An error occurs when the facial authentication driver is invoked.

Solution

Call the API again later or restart the device.