接入指引
本文中含有需要您注意的重要提示信息，忽略该信息可能对您的业务造成影响，请务必仔细阅读。
开通验证码2.0后，您需要在客户端和服务端接入验证码后，才能使用验证码进行验证。本文介绍如何在客户端和服务端接入。
接入流程
如果您在接入过程中遇到任何问题，请提交工单联系我们。
步骤一：开通验证码服务
步骤二：新建验证场景
新建验证场景时，您可以先创建一个策略状态为测试的验证场景，跳过验证码的风险策略判断，仅检测接入链路是否正常，避免在接入测试过程中，被验证码误判断为机器行为。
完成接入配置后，如果链路正常，您需要及时将该场景的策略状态修改为正式，使验证码进行正常的风险策略判断，实现攻防对抗。
登录验证码2.0控制台。
在左侧导航栏，单击场景管理。
在场景管理页面，单击新建场景。
在新建场景面板，完成如下配置后，单击确定。
配置项
说明
场景名称
为新建的验证码设置一个场景名称。
长度为1~32个字符，支持中文和大小写英文字母，可包含数字、下划线（_）。
客户端类型
设置接入验证码的客户端类型，可选项：
验证码形态
选择验证码的形态，可选项：
无痕验证：无感知验证。
选择该项后，您需要发起无痕验证二次挑战。无痕验证二次挑战形态支持滑块验证、拼图验证、空间推理和图像复原。
滑块验证：拖动滑块，完成验证。
拼图验证：拖动滑块，完成拼图。
空间推理：根据提示的问题，完成验证。
图像复原：拖动滑块，完成拼图。
策略状态
设置新建验证场景的状态，可选项：
正式（默认）：正式状态下，验证码会对服务端发起的验证请求进行风险咨询，并返回验证结果，实现攻防对抗。
测试：测试状态下，验证码只检查接入链路是否正常，而不会进行风险策略判断，仅返回设置的验证结果。测试完成后，您需要切回正式状态，预计需要5分钟左右生效。
测试状态下，各验证码形态支持设置如下验证结果：
无痕验证+滑块验证或拼图验证（二次验证）：无痕验证通过、无痕验证不通过二次挑战通过、无痕验证不通过二次挑战不通过。
无痕验证+空间推理（二次验证）：无痕验证通过、无痕验证不通过。
滑块验证：验证通过、验证不通过。
拼图验证：验证通过、验证不通过。
空间推理：不支持测试状态。
图像复原：验证通过、验证不通过。
重要无论策略状态设置为正式还是测试，验证码都会按照调用次数结算费用。
成功创建验证场景后，您需要在验证场景列表，获取新建场景的场景ID，用于客户端接入。具体操作，请参见步骤三：接入验证码。
步骤三：接入验证码
如果您在接入过程中遇到问题，请提交工单联系我们。
Web和H5接入
如果采用Web和H5接入，新建验证场景时，客户端类型需选择为Web或H5。
App接入
如果采用App接入，新建验证场景时，客户端类型需选择为App(Webview+H5)。
客户端接入：在使用验证功能的客户端页面（Web和H5）中，集成验证码初始化代码，实现客户端接入。关于集成验证码的初始化代码示例，请参见客户端接入。
服务端接入：在客户端页面（Web和H5）对应的服务端中，集成SDK后，调用服务端接入初始化接口VerifyIntelligentCaptcha，发起验证码验证。具体操作，请参见服务端接入。
App端接入
Android App端：利用WebView组件在App应用中开启并部署需要接入阿里云验证码2.0的业务页面。具体操作，请参见使用WebView在Android App中接入验证码2.0。
iOS App端：利用WKWebView组件在App应用中开启并部署需要接入阿里云验证码2.0的业务页面。具体操作，请参见使用WKWebView在iOS App中接入验证码2.0（Swift）。
微信小程序接入
如果采用微信小程序接入，新建验证场景时，客户端类型需选择为微信小程序。
微信小程序接入：在控制台添加验证场景后，您需要在使用验证功能的微信小程序页面中，集成验证码初始化代码，实现微信小程序接入。具体操作，请参见微信小程序接入。
步骤四：接入验证
一、测试客户端接入是否成功
接入配置完成后，打开集成验证码的页面浏览器控制台，查看Network信息。
如果存在如下所有内容，表示客户端接入成功：
初始化请求（图示①）
初始化请求的Preview中存在验证码相关信息（图示②），且success为true。
验证码资源（图示③）
二、测试服务端接入是否成功
客户端接入成功后，会通过业务接口将验证参数captchaVerifyParam发送给业务服务端。业务服务端调用阿里云验证接口VerifyIntelligentCaptcha后，会返回验证结果。
您可以在业务服务端请求（图示①）的Preview中查看验证结果（图示②）。如果success为true代表服务端接入成功，为false代表服务端接入失败。
不同业务的服务端请求可能不同。上图以bizquery为例。
三、测试验证码是否能正常使用
服务端接入成功后，会将业务结果和阿里云验证码结果返回给客户端，客户端根据返回结果做出不同的业务处理。您可以在客户端使用验证码，测试验证效果。
滑块验证、空间推理、拼图验证：按提示进行验证后，显示验证通过，则表示验证成功。
无痕验证：业务交互成功，则表示验证成功。以登录场景为例，输入用户名和密码并登录后，显示登录成功，则表示验证成功。
步骤五：发布上线
完成上述步骤后，即可将验证码发布上线。
相关操作
查看统计数据
完成接入配置后，您可以在概览页面，查看验证数据。更多信息，请参见数据统计。
删除验证场景
删除验证场景后，所有历史数据均会被删除，且不支持数据回滚。同时，该配置对应的验证码也将调用失败。请确认不再继续使用该验证场景后，再进行删除。
在场景管理页面，定位到目标场景，单击操作列的删除。
在删除确认对话框中，输入场景ID进行二次确认，勾选风险提醒，单击确定。
