認証解決 API 操作とは - HTTPDNS - Alibaba Cloud ドキュメントセンター

1. 背景

HTTPDNS は、不正な使用による課金への影響を防ぐための認証メカニズムを提供します。この機能を実装するには、このドキュメントの指示に従ってください。

既存のユーザーは、非認証アクセス方式を使用するプロダクトを公開しています。これらのユーザーは、引き続き非認証 API 操作を使用する必要があります。

新しい認証 API 操作が利用可能です。新しいプロダクトバージョンでは、この新しい API 操作に徐々に移行できます。古いアプリバージョンのユーザー数が許容レベルまで減少したら、署名付きアクセスを有効にして、次の図に示すように課金への影響を防ぐことができます。

警告

HTTP API を使用する場合は、ベストプラクティスの推奨事項を読む必要があります。そうしないと、サービス障害のリスクがあります。

認証 API 操作

重要

署名アルゴリズム

sign = md5sum(host-secret-timestamp)

認証フィールドの説明

フィールド	説明
host	解決するホスト。URL の host パラメーターと同じ値を使用します。
secret	サーバーによって生成されます。[コンソール] > [設定] > [開発者設定] から取得できます。
timestamp	署名の有効期限。1970 年 1 月 1 日からの秒数で表します。これは 10 桁の正の整数です。説明署名の最大有効期間は 24 時間です。

署名の例

例 1 (標準解決 API 操作):
- 元のリクエスト: http://47.74.XXX.XXX/{account_id}/d?host=www.aliyun.com
- キーが `IAmASecret` で、署名が 2018 年 8 月 15 日 15:00:00 (UTC + 08:00) に有効期限切れになると仮定します。UNIX タイムスタンプは 1534316400 です。
- sign = md5sum("www.aliyun.com-IAmASecret-1534316400") = 60c71e98b6d7fcbb366243e224eab457
- 認証リクエスト: http://47.74.XXX.XXX/{account_id}/sign_d?host=www.aliyun.com&t=1534316400&s=60c71e98b6d7fcbb366243e224eab457
例 2 (バッチ解決 API 操作):
- 元のリクエスト:
  http://47.74.XXX.XXX/{account_id}/resolve?host=www.aliyun.com,www.taobao.com
- キーが `IAmASecret` で、署名が 2018 年 8 月 15 日 15:00:00 (UTC + 08:00) に有効期限切れになると仮定します。UNIX タイムスタンプは 1534316400 です。
- sign = md5sum("www.aliyun.com,www.taobao.com-IAmASecret-1534316400") = 12a3f6b1b14a46ca813ca6439beb59a4
- 認証リクエスト: http://47.74.XXX.XXX/{account_id}/sign_resolve?host=www.aliyun.com,www.taobao.com&t=1534316400&s=12a3f6b1b14a46ca813ca6439beb59a4

このスキームの長所と短所

認証が成功すると、HTTP 応答ステータスコードは 200 になり、応答は単一ドメイン名解決の [API 応答の説明] セクションで説明されているものと同じになります。
認証に失敗した場合、HTTP 応答ステータスコードは 403 または 400 になります。応答本文は、JSON フォーマットで特定のエラーコードを返します。
```
 { "code": "InvalidSignature" }
```