sts_flutter

Description:

sts flutter

sts_flutter #
AHCA STS Flutter plugin.
AHCA Flutter平台手机盾SDK插件
说明 #
此插件是在手机盾原生SDK上封装的Flutter平台插件，其功能和接口与原生SDK一致。
目前只支持Android平台的原生功能，iOS部分的待定。
初始化 #
初始化手机盾配置，建议在自定义Application类的onCreate生命方法内操作：
StsFlutter.init("服务地址", "AppKey", "SecretKey");
StsFlutter.initFace("活体检测授权码", "活体检测授权文件名");
copied to clipboard
注意，同时需要在确定用户信息和唯一标识后调用以下接口：
StsFlutter.initUseId("用户唯一标识");
copied to clipboard
可选的流程 #
请根据实际需求进行配置，例如项目无需使用手机盾活体检测功能，则无需配置initFace。
在使用证书前（例如签名、签章等），需要先判断证书是否已申请，如果证书不存在，需要调用申请证书接口，申请成功后方可使用。建议在调用证书签名/证书签章/证书登录等接口之前，先调用申请证书接口，当该接口返回码为1或10503时，再调用需要操作的证书功能的接口。
同时手机盾还提供了判断本地证书数据是否存在的接口，即isLocalCertExist接口，这是为了方便对流程响应速度有需求的业务场景，例如，APP证书登录场景，由于checkCert、certLogin或其他接口需要联网，存在一定的耗时，可仅使用isLocalCertExist接口仅判断本地证书是否存在，证书存在则调用证书登录接口，证书不存在则显示密码输入框或验证码相关控件，进行后续申请证书的操作。
StsCodeTable #
StsCodeTable类包含了SDK接口返回的部分错误码和对应解释，例如常用的 1(成功) 10502(参数不全或为空) 10502(证书不存在或已损坏) 10503(证书已存在)等
StsFlutter #
StsFlutter类包含接口外，还包括部分接口使用的固定标识
如申请个人证书接口的StsUserInfo实体类的证件类型属性(cardType)即可使用以下标识
static const String CARD_TYPE_ID_CARD = "00"; // 身份证
static const String CARD_TYPE_TEMPORARY_ID_CARD = "01"; // 临时身份证
static const String CARD_TYPE_HOUSEHOLD_REGISTER = "02"; // 户口本
static const String CARD_TYPE_PASSPORT = "03"; // 护照
static const String CARD_TYPE_MILITARY_ID_CARD = "04"; // 军人身份证
static const String CARD_TYPE_ARMED_POLICE_ID_CARD = "05"; // 武警身份证
copied to clipboard
如certSign、certLogin等接口的dataType、dataFormat参数可使用如下标识
static const String DATA_TYPE_ORIGINAL_TO_HEXADECIMAL = "0"; // 原文数据转成16进制
static const String DATA_TYPE_BYTE_BY_HEXADECIMAL = "1"; // byte类型数据（16进制编码）
static const String DATA_TYPE_CHINESE_TO_HEXADECIMAL = "2"; // 中文转成16进制
static const String DATA_TYPE_ORIGINAL = "3"; // 原文数据
static const String DATA_TYPE_BYTE_BY_BASE64 = "4"; // byte类型数据（Base64编码加密后的值）

static const String DATA_FORMAT_P1 = "p1"; // P1
static const String DATA_FORMAT_P7 = "p7"; // P7
static const String DATA_FORMAT_P7_ENVELOPE = "p7envelope"; // P7数字信封
static const String DATA_FORMAT_DEFAULT = "default"; // 裸签名
copied to clipboard