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

# 身份驗證

每個 API 請求都必須包含 API Key。您可以在 Security Settings 中新增 IP Allowlist、Request Signing 或同時啟用兩者，以保護 API 存取。

## 獲取 API Key

1. 登錄 [MetaSleuth](https://metasleuth.io)。
2. 打開 [Settings → APIs → API Keys](https://metasleuth.io/system/settings/personal/apis)。
3. 為要使用的服務產生或查看 API Key。

Address Label API 和 Risk Score API 各自使用獨立的 API Key 和 API Secret。請使用對應服務的憑據。

如果您通過銷售團隊獲取了定制 API 服務，請聯繫指定服務代表，獲取憑據和適用的設定說明。

## 使用 API Key

在每個請求中包含 `Api-Key` Header。請妥善保管 API Key，僅在伺服器端應用程式中使用。切勿將其放入版本控制、瀏覽器或行動應用程式套件、URL 或日誌。使用 HTTPS 並啟用證書驗證。

以下示例從環境變數讀取 Key。處理憑據時，請避免啟用 Shell 跟蹤（`set -x`）和詳細 HTTP 日誌。

以下示例使用您的 Risk Score API Key：

```sh
curl --request GET \
  --header "Api-Key: ${MS_API_KEY}" \
  'https://aml.blocksec.com/address-compliance/api/v3/chain-list'
```

此示例僅包含 API Key 認證。如果已啟用 IP Allowlist，請從允許的公用網路出口 IP 發送請求。如果要求 Request Signing，還需包含 [Request Signing](/zh_tw/blocksec-aml-api/introduction/request-signing.md) 中所述的簽名 Header。

## 附加安全校驗

| 安全方式            | 請求要求                              |
| --------------- | --------------------------------- |
| IP Allowlist    | 來源公用網路 IP 必須匹配允許的 IP 地址或 CIDR 網段。 |
| Request Signing | 要求簽名後，每個請求都必須包含有效簽名、時間戳和唯一 nonce。 |
| 同時啟用            | 請求必須同時通過兩項校驗。                     |

建議至少啟用一種安全方式來保護 API 存取。如果 API 管理頁面顯示安全設定截止時間，請在該時間前完成設定，以避免存取中斷。僅產生 Secret 並不代表完成設定。

設定步驟請參閱 [API Security Settings](/zh_tw/blocksec-aml-api/introduction/api-security-settings.md)，簽名說明請參閱 [Request Signing](/zh_tw/blocksec-aml-api/introduction/request-signing.md)。