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

# 身份验证

Phalcon Compliance APP REST API 使用 API 密钥进行安全身份验证。请妥善保管 API 密钥，以保护您的数据。

### 获取 API 密钥

在项目工作区中，前往 ***系统 -> API***，然后点击 ***生成密钥*** 创建密钥。每个项目最多支持 3 个有效密钥，所有 API 调用都会计入项目的使用配额。

### 使用 API 密钥

在 HTTP 请求标头中加入 API 密钥，以对 API 请求进行身份验证：

**请求标头格式**

* 键：api-key
* 值：您的 API 密钥

### 可选 IP 白名单

您可以在 **系统 → API → 管理 → 安全设置** 中为每个 API 密钥配置 IP 白名单。启用后，请求必须包含有效的 API 密钥，并且来自允许的公网出站 IP 地址。

验证为可选功能，默认处于禁用状态。保存 IP 白名单不会启用验证；请在应用准备就绪后单独开启。有关配置和故障排除，请参阅 [IP 白名单指南](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/account/api-keys/ip-allowlist.md)。
