目录

通行密钥

以下仅介绍本模块特有错误码,通用错误码请参见通用错误码。

1021300001 系统不支持

错误信息

The system does not support.

错误描述

系统不支持当前操作时,会返回此错误码。

可能原因

注册或认证的相关参数不正确,例如认证器不支持指定的签名算法。

处理步骤

请检查注册或认证的相关参数是否正确,并设置正确的参数。

1021300002 失效状态

错误信息

Invalid state.

错误描述

认证器处于无效状态时,系统会返回此错误码。

可能原因

认证器状态异常,例如用户同意注册凭证后,发现凭证ID已被列入排除列表(excludeCredentials),通常表示该设备已注册过。

处理步骤

请检查认证器状态并正确使用。

1021300003 未通过系统完整性检查

错误信息

System integrity check failed.

错误描述

访问存在安全问题时,系统会返回此错误码。

可能原因

存在安全问题,例如网页url未使用https等不符合安全要求的情况。

处理步骤

请使用符合安全要求的配置。

1021300004 用户取消

错误信息

User abort.

错误描述

用户取消操作时,系统会返回此错误码。

可能原因

用户点击取消按钮。

处理步骤

若要使用功能,请重新尝试。

1021300005 超时

错误信息

Time out.

错误描述

访问超时时,系统会返回此错误码。

可能原因

访问超时。

处理步骤

请在配置时间内完成操作。

1021300006 编码错误

错误信息

Encoding error.

错误描述

发生编码错误时,系统会返回此错误码。

可能原因

注册或认证的参数不正确。

处理步骤

请检查注册或认证的相关参数是否正确。

1021300007 未知错误

错误信息

Unknown error.

错误描述

发生未知错误时,系统会返回此错误码。

可能原因

未知错误。

处理步骤

  1. 重试当前操作。

  2. 若重试持续失败,重启设备后再次尝试。

1021300008 约束条件错误

错误信息

The constraint condition is incorrect.

错误描述

约束条件错误时,系统会返回此错误码。

可能原因

约束条件错误,例如要求使用residentKey但认证器不支持。

处理步骤

请检查注册或认证的相关参数是否正确。

1021300009 数据错误

错误信息

Data error.

错误描述

发生数据错误时,系统会返回此错误码。

可能原因

发生数据错误。

处理步骤

请排查注册或认证的相关参数是否正确。

1021300010 用户拒绝

错误信息

User Rejects.

错误描述

用户拒绝操作时,系统会返回此错误码。

可能原因

用户拒绝操作。

处理步骤

请用户先设置相关的平台认证器(人脸、指纹或PIN码)。

1021300011 系统FIDO服务拉起失败

错误信息

Failed to connect to the service.

错误描述

FIDO系统能力拉起失败时,系统会返回此错误码。

可能原因

FIDO系统能力拉起异常。

处理步骤

请尝试重启手机或再重试。

1021300012 通行密钥数目达到最大值

错误信息

The number of credentials has reached the maximum limit.

错误描述

通行密钥数目达到最大值时,系统会返回此错误码。

可能原因

通行密钥数目达到最大值。

处理步骤

提示用户去密码保险箱中删除多余的通行密钥。系统最多支持存储500个通行密钥,每个应用最多存储20个通行密钥。

1021300013 用户认证失败切换其他认证方式

错误信息

Switched to the custom authentication process.

错误描述

当前的认证操作被用户从控件取消,返回这个错误码,标识使用应用自定义认证。例如用户点击使用自定义认证,返回到应用自定义认证流程。

可能原因

用户认证失败后取消认证。

处理步骤

重新调用认证接口,发起认证。

1021310001 无效CTAP命令

错误信息

Invalid CTAP command.

错误描述

不是有效的CTAP命令时,系统会返回此错误码。

可能原因

CTAP命令无效或不支持。

处理步骤

请参考FIDO2规范使用正确的CTAP命令。

1021310002 非法参数

错误信息

The command contains invalid parameters.

错误描述

命令包含非法参数时,系统会返回此错误码。

可能原因

命令包含非法参数。

处理步骤

请添加必要的扩展数据。

1021310003 消息长度无效

错误信息

Invalid message or attribute length.

错误描述

消息长度无效时,系统会返回此错误码。

可能原因

数据传输长度错误。

处理步骤

请使用正确长度的消息。

1021310004 无效CBOR

错误信息

Invalid CBOR or unpredictable error.

错误描述

无效简明二进制对象表示CBOR(Concise Binary Object Representation)或不可预知错误时,系统会返回此错误码。

可能原因

发生无效CBOR或不可预知错误。

处理步骤

请检查传入参数是否正确。

1021310005 CBOR解析失败

错误信息

Failed to parse the CBOR.

错误描述

解析CBOR出错时,系统会返回此错误码。

可能原因

解析CBOR出错。

处理步骤

请检查传入参数是否正确。

1021310006 凭据未找到

错误信息

Not found valid credentials.

错误描述

没有找到有效凭据时,系统会返回此错误码。

可能原因

用户没有可用的凭据。

处理步骤

当前设备上用户未注册,请先注册通行密钥。

1021310007 操作不被允许

错误信息

Not allowed.

错误描述

命令不被允许时,系统会返回此错误码。

可能原因

认证器不支持无用户验证的操作。

处理步骤

不支持的操作,请检查传入参数是否正确。

1021310008 用户验证失败

错误信息

User verification failed.

错误描述

用户验证失败时,系统会返回此错误码。

可能原因

用户验证失败。

处理步骤

请根据提示重新验证指纹或面容。

1021310009 其他

错误信息

Other error.

错误描述

发生密钥产生失败、签名失败、内部错误等时,系统会返回此错误码。

可能原因

密钥产生失败、签名失败、内部错误等。

处理步骤

  1. 重试当前操作。

  2. 若重试持续失败,重启设备后再次尝试。