MaxKey/docs/authn/mfa.md

双因素认证（MFA）

双因素身份认证就是通过你所知道再加上你所能拥有的这二个要素组合到一起才能发挥作用的身份认证系统。双因素认证是一种采用时间同步技术的系统，采用了基于时间、事件和密钥三变量而产生的一次性密码来代替传统的静态密码。每个动态密码卡都有一个唯一的密钥，该密钥同时存放在服务器端，每次认证时动态密码卡与服务器分别根据同样的密钥，同样的随机参数（时间、事件）和同样的算法计算了认证的动态密码，从而确保密码的一致性，从而实现了用户的认证。就像我们去银行办卡送的口令牌.

多因素认证（MFA），是一种计算机访问控制的方法，用户要通过两种以上的认证机制之后，才能得到授权，使用计算机资源。MFA的目的是建立一个多层次的防御，使未经授权的人访问计算机系统或网络更加困难，从而提高安全性。

双因素认证

1、短信认证 腾讯云短信/阿里云短信/网易云信/定制

2、电子邮件

短信认证

腾讯云短信

配置maxkey中spring/maxkey-security.xml secretId 账号Appkey

secretKey 密钥appSecret

smsSdkAppid 短信SDKAPPID

templateId 短信模板ID

sign 签名

<!--
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.TimeBasedOtpAuthn">
</bean>
-->  
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.sms.SmsOtpAuthnTencentCloud">
    <property name="secretId" value="94395d754eb55693043f5d6a2b772ef4" />
    <property name="secretKey" value="05d5485357bc" />
    <property name="smsSdkAppid" value="1486220095" />
    <property name="templateId" value="14860095" />
    <property name="sign" value="1486009522" />
</bean>

阿里云短信

配置maxkey中spring/maxkey-security.xml

accessKeyId 账号Appkey

accessSecret 密钥appSecret

templateCode 短信模板ID

signName 签名

<!--
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.TimeBasedOtpAuthn">
</bean>
-->  
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.sms.SmsOtpAuthnAliyun">
    <property name="accessKeyId" value="94395d754eb55693043f5d6a2b772ef3" />
    <property name="accessSecret" value="05d5485357bc" />
    <property name="templateCode" value="SMS_187590021" />
    <property name="signName" value="MaxKey" />
</bean>

网易云信

配置maxkey中spring/maxkey-security.xml

appKey 网易云信分配的账号Appkey

appSecret 网易云信分配的密钥appSecret

templateId 短信模板ID

<!--
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.TimeBasedOtpAuthn">
</bean>
-->  
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.sms.SmsOtpAuthnYunxin">
    <property name="appKey" value="94395d754eb55693043f5d6a2b772ef4" />
    <property name="appSecret" value="05d5485357bc" />
    <property name="templateId" value="14860095" />
</bean>

电子邮件

配置邮箱地址

文件 maxkey/config/applicationConfig.properties

#  EMAIL configuration
config.email.username=maxkey@163.com
config.email.password=password
config.email.smtpHost=smtp.163.com
config.email.port=465
config.email.senderMail=maxkey@163.com
config.email.ssl=true

配置maxkey中spring/maxkey-security.xml

subject 邮件主题

messageTemplate 邮件内容模板，请勿修改参数{0}为用户名，{1}认证码，{2}有效间隔

<!--
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.TimeBasedOtpAuthn">
</bean>
-->  
<bean id="tfaOptAuthn" class="org.maxkey.crypto.password.opt.impl.MailOtpAuthn">
    <property name="subject" value="MaxKey One Time PassWord" />
    <property name="messageTemplate" value="{0} You Token is {1} , it validity in {2}  minutes." />
</bean>