多因素认证 API

更新时间: 2022-03-11 11:21:01

MFA 检测

检测手机号或者邮箱是否可以被用作 MFA

public static void mfaCheck(String phone, String email, @NotNull AuthCallback<JSONObject> callback)

参数

• phone 被检测的手机号。可以为空
• email 被检测的邮箱。可以为空

示例

AuthClient.mfaCheck("13012345678", null, (code, message, ok) -> {
    if (code == 200) {
        if (ok) {
            
        }
    }
});

AuthClient.mfaCheck(null, "abc@gmail.com", (code, message, ok) -> {
    if (code == 200) {
        if (ok) {
            
        }
    }
});

短信验证

通过短信进行多因素认证

public static void mfaVerifyByPhone(String phone, String code, @NotNull AuthCallback<UserInfo> callback)

参数

• phone 手机号码
• code 短信验证码

示例

AuthClient.mfaVerifyByPhone("13012345678", "1234", (code, message, userInfo)->{
    // userInfo 用户信息
});

邮箱验证

通过邮件验证码进行多因素认证

public static void mfaVerifyByEmail(String email, String code, @NotNull AuthCallback<UserInfo> callback)

参数

• email 邮箱地址
• code 邮件验证码

示例

AuthClient.mfaVerifyByEmail("abc@gmail.com", "1234", (code, message, userInfo)->{
    // userInfo 用户信息
});

TOTP 验证

通过一次性密码 TOTP (Time-based One Time Password) 进行多因素认证

public static void mfaVerifyByTOTP(String code, @NotNull AuthCallback<UserInfo> callback)

参数

• code TOTP code

示例

AuthClient.mfaVerifyByTOTP("1234", (code, message, userInfo)->{
    // userInfo 用户信息
});

恢复码验证

用户在绑定 TOTP 时会得到一个恢复码，用户需要安全保存该恢复码，在调用此 API 时，将其作为参数传入。

注意，恢复码验证成功后，会生成新的恢复码，旧的恢复码失效

public static void mfaVerifyByRecoveryCode(String code, @NotNull AuthCallback<UserInfo> callback)

参数

• code 恢复码

示例

AuthClient.mfaVerifyByRecoveryCode("1234", (code, message, userInfo)->{
    // 新的恢复码
    String newCode = userInfo.getRecoveryCode();
});