カスタム HTTP レスポンスヘッダーを設定して、アクセラレーションドメイン名配下のリソースへのレスポンスにヘッダーを追加できます。これにより、オリジン間リソース共有 (CORS) などの機能を有効にできます。
背景情報
オリジン間リソース共有 (CORS) は、HTML5 が提供する標準的なソリューションです。これにより、Webアプリケーションサーバーはクロスオリジンアクセスを管理でき、これは異なるドメイン間での安全なデータ共有に不可欠です。
クライアントがリソースをリクエストする際に、レスポンスヘッダーを設定してクロスオリジンアクセスを有効にできます。CDN がクロスオリジンリクエストを受信すると、対応する CORS ルールを読み取り、権限チェックを実行します。CDN は各ルールを順序どおりに評価し、最初に一致したルールを適用してリクエストを処理し、対応するヘッダーを返します。一致するルールがない場合、CORS 関連のヘッダーは追加されません。
HTTP レスポンスヘッダーの設定は、ドメイン名レベルで適用されます。これらの設定は、ブラウザーなどのクライアントの動作にのみ影響し、CDN ノードのキャッシュ動作には影響しません。カスタム HTTP レスポンスヘッダーは、ワイルドカードドメイン名ではサポートされていません。
操作手順
ApsaraVideo VOD コンソールにログインします。
-
左側のナビゲーションペインで、設定の管理 > 配信の高速化設定 > ドメイン名 を選択します。
設定するドメイン名を見つけ、[設定] をクリックします。
指定したドメイン名の左側のナビゲーションウィンドウで、キャッシュ をクリックします。
-
カスタム HTTP レスポンスヘッダー タブをクリックします。
-
追加 をクリックして、カスタム HTTP レスポンスヘッダーを追加します。
次の例は、カスタム HTTP レスポンスヘッダーの追加方法を示しています。
パラメーター
説明
[レスポンスヘッダーの操作]
指定したレスポンスヘッダーを追加、削除、変更、または置換できます。
[カスタムレスポンスヘッダーのパラメーター]
ドロップダウンリストから カスタム または [Cache-Control] などの標準レスポンスヘッダーを選択します。詳細については、「レスポンスヘッダーのパラメーター」をご参照ください。
[カスタムレスポンスヘッダー名]
カスタム で [カスタマイズ] を選択した場合、このパラメーターは必須です。名前は次の要件を満たす必要があります：
-
大文字、小文字、ハイフン (-)、数字で構成されていること。
-
長さが 1〜100 文字であること。
[レスポンスヘッダー値]
レスポンスヘッダーの値を入力します。詳細については、「レスポンスヘッダーのパラメーター」をご参照ください。
[重複を許可するかどうか]
-
許可されています：新しいヘッダーとオリジンサーバーの元のヘッダーの名前が同じ場合、新しいヘッダーが元のヘッダーを置き換えます。
-
許可されていません：新しいヘッダーとオリジンサーバーの元のヘッダーの名前が同じであっても、CDNは元のヘッダーを変更せずに新しいヘッダーを追加します。
-
-
決定 をクリックして設定を完了します。
新しいルールがリストに表示されます。その後、操作 列の 変更 または 削除 をクリックして管理できます。
レスポンスヘッダーのパラメーター
次の表のすべてのレスポンスヘッダーは、カスタムヘッダーを除き、HTTP/2 をサポートしています。
|
パラメーター |
説明 |
例 |
|
カスタマイズ |
カスタムレスポンスヘッダーを追加できます。ヘッダー名は次の要件を満たす必要があります：
|
Test-Header |
|
Cache-Control |
クライアントがリクエストとレスポンスの際に従うキャッシュメカニズムを指定します。 |
no-cache |
|
Content-Disposition |
クライアントがリクエストされたコンテンツをファイルとして保存するときのデフォルトのファイル名を指定します。 |
examplefile.txt |
|
Content-Type |
レスポンスオブジェクトのコンテンツタイプを指定します。サポートされるタイプには、テキスト、画像、音声、動画、ファイルなどがあります。 |
image |
|
Pragma |
特定のディレクティブを実装するために使用される HTTP/1.0 レスポンスヘッダーです。リクエスト-レスポンスチェーンに沿ってさまざまな効果をもたらす可能性があり、HTTP/1.1 との互換性のために使用されます。 |
no-cache |
|
Access-Control-Allow-Origin |
クロスオリジンリクエストで許可されるオリジンを指定します。アスタリスク (*) を入力すると、すべてのドメインが許可されます。完全なドメイン名 (例： 説明
|
|
|
Access-Control-Allow-Methods |
クロスオリジンリクエストで許可されるメソッドを指定します。複数のメソッドをカンマ (,) で区切って指定できます。 |
POST,GET |
|
Access-Control-Allow-Headers |
クロスオリジンリクエストで許可されるヘッダーフィールドを指定します。 |
X-Custom-Header |
|
Access-Control-Expose-Headers |
レスポンスの一部として公開できるヘッダーを指定します。複数のヘッダーをカンマ (,) で区切って指定できます。 |
Content-Length |
|
Access-Control-Allow-Credentials |
クレデンシャルを使用してリクエストが行われたときに、ブラウザーがフロントエンドの JavaScript コードにレスポンスを公開できるかどうかを示します。
|
true |
|
Access-Control-Max-Age |
プリフライトリクエストの結果をキャッシュできる期間を秒単位で指定します。 |
600 |