接入指引

接入流程

步骤一：开通验证码服务

1. 登录验证码2.0控制台。

2. 在开通页面，单击立即购买后，完成购买。

   开通验证码服务后，您需要在概览页面的实例基本信息卡片区域，获取身份标，用于客户端接入。具体操作，请参见客户端接入。

步骤二：新建验证场景

最多支持创建15个场景。如果您需要创建更多场景，请提交工单联系我们。

1. 登录验证码2.0控制台。

2. 在左侧导航栏，单击场景管理。

3. 在场景管理页面，单击新建场景。

4. 在新建场景面板，完成如下配置后，单击确定。

   配置项	说明
   场景名称	为新建的验证码设置一个场景名称。 长度为1~32个字符，支持中文和大小写英文字母，可包含数字、下划线（_）。
   客户端类型	设置接入验证码的客户端类型，可选项： Web：选择该选项后，您需要在客户端和服务端集成验证码。具体操作，请参见Web和H5接入。 H5：选择该选项后，您需要在客户端和服务端集成验证码。具体操作，请参见Web和H5接入。 App(Webview+H5)：选择该选项后，您需要在客户端、服务端、App端集成验证码。具体操作，请参见App接入。
   验证码形态	选择验证码的形态，可选项： 无痕验证：无感知验证。 选择该项后，您需要发起无痕验证二次挑战。无痕验证二次挑战形态支持滑块验证和空间推理。 滑块验证：拖动滑块，完成验证。 拼图验证：拖动滑块，完成拼图。 空间推理：根据提示的问题，完成验证。
   策略状态	设置新建验证场景的状态，可选项： 正式（默认）：正式状态下，验证码会对服务端发起的验证请求进行风险咨询，并返回验证结果，实现攻防对抗。 测试：测试状态下，验证码只检查接入链路是否正常，而不会进行风险策略判断，仅返回设置的验证结果。测试完成后，您需要切回正式状态，预计需要5分钟左右生效。 测试状态下，各验证码形态支持设置如下验证结果： 无痕验证+滑块验证或拼图验证（二次验证）：无痕验证通过、无痕验证不通过二次挑战通过、无痕验证不通过二次挑战不通过。 无痕验证+空间推理（二次验证）：无痕验证通过、无痕验证不通过。 滑块验证：验证通过、验证不通过。 拼图验证：验证通过、验证不通过。 空间推理：不支持测试状态。 重要 无论策略状态设置为正式还是测试，验证码都会按照调用次数结算费用。

   成功创建验证场景后，您需要在验证场景列表，获取新建场景的场景ID，用于客户端接入。具体操作，请参见步骤三：接入验证码。

步骤三：接入验证码

步骤四：接入验证

一、测试客户端接入是否成功

接入配置完成后，打开集成验证码的页面浏览器控制台，查看Network信息。

如果存在如下所有内容，表示客户端接入成功：

• 初始化请求（图示①）

• 初始化请求的Preview中存在验证码相关信息（图示②），且success为true。

• 验证码资源（图示③）

二、测试服务端接入是否成功

客户端接入成功后，会通过业务接口将验证参数captchaVerifyParam发送给业务服务端。业务服务端调用阿里云验证接口VerifyIntelligentCaptcha后，会返回验证结果。

您可以在业务服务端请求（图示①）的Preview中查看验证结果（图示②）。如果success为true代表服务端接入成功，为false代表服务端接入失败。

三、测试验证码是否能正常使用

服务端接入成功后，会将业务结果和阿里云验证码结果返回给客户端，客户端根据返回结果做出不同的业务处理。您可以在客户端使用验证码，测试验证效果。

• 滑块验证、空间推理、拼图验证：按提示进行验证后，显示验证通过，则表示验证成功。

• 无痕验证：业务交互成功，则表示验证成功。以登录场景为例，输入用户名和密码并登录后，显示登录成功，则表示验证成功。

步骤五：发布上线

完成上述步骤后，即可将验证码发布上线。

相关操作

查看统计数据

完成接入配置后，您可以在概览页面，查看验证数据。更多信息，请参见数据统计。

删除验证场景

1. 在场景管理页面，定位到目标场景，单击操作列的删除。

2. 在删除确认对话框，确认场景信息，正确输入确认删除的提示文案后，单击确定。