> For the complete documentation index, see [llms.txt](https://docs.helodata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helodata.com/helodata-zh/chan-pin/overview-1/authentication.md).

# 身份认证

移动代理沿用与住宅完全相同的两种认证模式，按运行环境选择。机制一致，**仅用户名中的 `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 **默认不需要**。仅当账户被标记进入风险复核时，请求可能返回以下错误，直到完成验证为止：

```
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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.