一、功能原理
客户端集成 SDK 后，SDK 采集设备环境信息（如手机运动状态、触屏习惯等）生成唯一的设备码（Device_Token），并将该字段放入请求 Header 中传递给 WAF。WAF 对 Device_Token 进行解码与风险检测，若检测到设备异常则拦截，正常则放行回源站。
二、前提条件
·已购买 Web 应用防火墙、BOT 流量管理功能及客户端安全。
·已 提交工单，联系腾讯云工程师生成 SDK_Channel。
三、操作步骤
1. 登录 WAF 控制台，在左侧导航栏中，选择 BOT 管理。
2. 在 BOT 管理页面，选择 BOT 规则配置 > 客户端安全 > 接入配置。
3. 在客户端安全页面，获取已生成的 SDK_Channel，用于客户端 SDK 集成。
4. 下载对应平台的 SDK 及集成文档，按集成文档将其集成到客户端产品中。支持的平台包括 iOS、Android、HarmonyOS、小程序、H5 等。
5. 配置 Device_Token 在业务请求中的位置，以便 WAF 获取相应内容并进行后续解析。
| 参数 | 说明 |
| 名称 | 必填。自定义配置名称，用于标识该条 Device_Token 配置，最多 128 个字符。 |
| 描述 | 填写配置的备注说明，便于后续管理，最多 128 个字符。 |
| 参数位置 | 指定 Device_Token 在请求中的传递位置，支持 QUERY、BODY、COOKIE、HEADERS。 |
| 参数标识 | 填写 Device_Token 对应的参数名，WAF 将根据该标识从请求中提取对应值进行解析，最多 64 个字符。 |
6. 配置会话标识并关联场景。配置会话提取功能，以便 WAF 能基于会话 ID 区分不同的设备客户端。具体操作如下：
6.1 前往会话管理，新建会话标识或打开已有会话标识。
注意：说明：
注意：会话管理具体操作详情请参见 会话管理。
6.2 在会话标识配置的高级设置中，将会话标识绑定到需要客户端安全防护的场景。
四、配置规则
客户端安全支持在简易模式和多场景模式下配置客户端规则。系统预置的客户端规则从设备、应用、网络及行为等维度进行风险检测。
五、简易模式
1. 在简易模式页面，单击前往防御设置，选择客户端规则。
2. 在客户端规则页签，按需配置规则：
·非法 token 开关：当请求携带的设备 Token 解密失败时，该请求无法被任何客户端场景规则匹配。开启后，系统将按所选动作对这类请求执行处置，防止攻击者通过构造非法 Token 绕过客户端防护。
·防护等级：可在严格与正常两个等级间切换。
·执行动作：可调整各规则的执行动作，包括监控、重定向、JS 校验、人机识别、拦截。
·规则开关：调整规则生效状态。
六、多场景模式
在多场景模式页面，单击目标场景的查看配置，在防护规则集中选择客户端规则，即可进行客户端规则配置。配置项与 简易模式 一致。
七、自定义规则
简易模式和多场景模式下均支持自定义规则。在新建或编辑自定义规则时，匹配条件 > 匹配字段可选择客户端风险标签（即设备标签）分类下匹配字段，根据解码出的风险类型（如黑灰产设备、自动化作弊工具等），结合其他条件（如 Host）进行组合防护。具体风险标签种类以控制台展示为准。自定义规则的相关操作详情请参见 自定义规则。
八、防护应用
完成接入配置和规则配置后，在 BOT 攻击分析 > 攻击分类趋势 > 客户端规则中，可查看命中的客户端风险类型及具体数据。若发现某设备持续进行薅羊毛等违规行为，可根据获取到的 Device_Token，添加 自定义规则 对该违规设备进行封控。