若您的业务场景涉及海外接入,本文以 Web 接入方式为例,介绍验证码海外接入的操作流程及核心注意事项。
前提条件
已开通阿里云验证码2.0服务。
已新建接入方式为Web/H5的验证场景。
已为阿里云账号创建AccessKey。
重要严禁使用主账号 AccessKey 进行接入,主账号 AccessKey 泄露将导致所有云资源面临安全风险。请使用 RAM 用户的 AccessKey 完成接入,以最小化权限泄露的影响范围。接入阿里云验证码前,需为 RAM 用户授予验证码服务权限策略 AliyunYundunAFSFullAccess。
步骤一:客户端接入
在控制台添加验证场景后,需要在使用验证功能的Web或H5页面中,集成验证码初始化代码,实现客户端接入。更多具体操作,请参见Web和H5客户端接入。
若接入方式为非中国内地接入,请注意以下配置事项:
language:默认为cn(简体中文),验证码提供了17种语言类型,可以根据业务需求,在客户端接入时设置自定义验证码的文案与多语言。更多详情,请参见自定义文案与多语言设置。
region:请设置为sgp(新加坡),如果不设置则默认为cn(中国内地)。若希望在除新加坡以外的其他非中国地域实现加速接入,请设置为ga(全球加速)。
更多参数说明,请参见参数说明。
步骤二:服务端接入
完成客户端接入后,还需要在服务端调用接口,发起验证请求。更多具体操作,请参见服务端接入。
若您的业务接入方式为非中国内地,请严格确保服务端 Endpoint 与客户端 Region 参数在“国内/海外”属性上保持一致,严禁混用,否则会导致验证请求返回错误。具体配置规则如下:
国内环境配置:当 Region 参数设置为
cn时,必须使用国内调用地址,不可使用海外地址。海外环境配置:当 Region 参数设置为
sgp(新加坡)或ga(全球加速)时,必须使用以下任一海外调用地址,不可使用国内地址:新加坡节点:
captcha.ap-southeast-1.aliyuncs.com全球加速节点(就近接入,流量最终路由至新加坡):
captcha-open-ga.aliyuncs.com
重要提示:在使用全球加速域名时,系统不支持透出客户端的真实源 IP,服务端获取到的 IP 将为全球加速节点的 IP。
步骤三:查看统计数据
接入后,可以通过概览页面,查询近期验证数据,实时了解验证码的防护数据。更多具体详情,请参见查看统计数据。