# 身份认证

移动代理沿用与住宅完全相同的两种认证模式，按运行环境选择。机制一致，**仅用户名中的 `type` 段不同**。

## 模式 A — 用户名 + 密码（默认）

```bash
curl -x http://helo_s1a2b3c4d5e-type-mob-region-us:PASSWORD@gate.helodata.io:7777 \
     https://example.com
```

密码是**移动**子账号的密码。即便名称相似，移动与住宅子账号的密码彼此独立。

## 模式 B — IP 白名单

```bash
curl -x http://helo_s1a2b3c4d5e-type-mob-region-us@gate.helodata.io:7777 \
     https://example.com
```

登记 IP：**控制台 → 移动 → {子账号} → IP 白名单**。每个子账号最多 50 个 IPv4 地址或 CIDR 网段。修改约 60 秒内生效。

> 注意：住宅与移动**各自维护独立白名单**。在住宅子账号添加 IP，不会自动授权给移动。

## 移动特有：KYC 准入

两种模式都额外要求**账号**（而非子账号）已通过 KYC。未通过 KYC 的请求返回：

```
HTTP/1.1 403 Forbidden
X-Helodata-Error-Code: kyc-required
```

详见 [身份验证 (KYC)](/helodata-zh/zhang-hu-yu-ji-fei/kyc.md)。

## 如何选择

权衡同住宅产品——见 [住宅认证](https://docs.helodata.com/helodata-zh/chan-pin/overview-1/pages/THQrjK6FttHJh9lPVHuA#如何选择)。移动特有的考虑：若客户端本身是手机或走 NAT 出口的蜂窝/动态 IP，白名单基本不可行，请用用户名+密码。

## 轮换凭证

重置移动子账号密码：

1. **控制台 → 移动 → {子账号} → 重置密码**。
2. 旧密码继续 60 秒有效，之后返回 `407`。
3. 更新部署。

## API

白名单与子账号凭证通过 [白名单 API](/helodata-zh/api-can-kao/whitelists.md) 与 [子账号 API](/helodata-zh/api-can-kao/sub-users.md) 管理，调用时 `product` 参数填 `mobile`。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/helodata-zh/chan-pin/overview-1/authentication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.