オリジンの設定

このドキュメントではオリジンごとに設定する機能について説明します。

ImageFluxホスト名

ImageFluxホスト名についての設定
Name	ImageFluxへのアクセスの際に使用するホスト名。独自ドメインを使用する場合は変更可能
CNAME	独自ドメイン使用時にDNSでCNAME先として設定するホスト名

説明文についての設定
Description	このオリジン設定についての任意の説明文

ImageFluxではオリジンの取得方法としてHTTPとS3 API(Amazon S3、さくらのオブジェクトストレージ、Google Cloud Storage)に対応しています。

HTTPでオリジンから画像を取得します。nginxやApache HTTP ServerなどすでにWebサーバで画像を公開している場合はこちらを利用します。

HTTPオリジンについての設定
Scheme	オリジンからの取得するHTTPスキーム (httpまたはhttps)
Host	オリジンとして使用するHTTPサーバのホスト名
Path Prefix	オリジンから取得する際にパスの先頭につけるプレフィックス文字列たとえば`/images`と指定すると、オリジンから取得する際すべてのURLのパスに`/images`をつけてリクエストします。

Amazon S3、さくらのオブジェクトストレージ、またはGoogle Cloud StorageのバケットからREST APIを用いて画像を取得します。

S3 APIオリジンについての設定
Access Key ID	取得に用いるIAMアカウントのアクセスキーID Google Cloud Storageの場合は、Googleのドキュメントに従い、HMACキーを作成・取得してください。
Secret Access Key	取得に用いるIAMアカウントのシークレットアクセスキー
End Point	取得先エンドポイント名 Amazon S3の場合は指定する必要はありません。さくらのオブジェクトストレージで石狩第1サイトの場合、 `s3.isk01.sakurastorage.jp`を指定してください。 Google Cloud Storageの場合、Cloud Console / Cloud Storage / 設定ページの[相互運用性]タブ内のリクエストエンドポイントを指定してください。
Region	取得先リージョンのホスト名たとえばAWS S3でアジアパシフィック (東京)の場合、 `ap-northeast-1`を指定してください
Bucket	取得先のバケット名
Path Prefix	バケットから取得する際にパスの先頭につけるプレフィックス文字列たとえば`/images`と指定すると、オリジンから取得する際すべてのURLのパスに`/images`をつけてリクエストします。

URL署名に関する設定
Enable Signed URL	署名URLを有効にする
Signing Secret	シークレットを指定する

URL署名機能を有効にします。詳しくはURL署名を参照してください。

キャッシュに関する設定
Default cache duration in seconds	キャッシュの保持期間のデフォルト値(秒) `0`～`2147483647`を指定可能です。オリジンのレスポンスにキャッシュの保持期間に関する設定が含まれない場合、この値を適用します。具体的には`Cache-Control`ヘッダの`s-maxage`ディレクティブをこの値に設定し、`must-revalidate`ディレクティブを指定します。オリジンが既に`Cache-Control`ヘッダまたは`Expires`ヘッダを返している場合や、クライアントのリクエストに`Authorization`ヘッダが含まれている場合などでは、`Cache-Control`ヘッダの追加・変更は行いません。また、この値を0に設定した場合も`Cache-Control`ヘッダの追加・変更は行いません。

その他の詳細設定
Hostヘッダ値	Hostヘッダとして送信する文字列 HTTPオリジンの場合、デフォルトでは上記のHostで指定した値がHostヘッダに設定されますが、この項目を設定した場合はその値がHostヘッダに設定されます。設定可能な文字列はHostヘッダの値として有効なものに限られます。通常、この項目を設定する必要はありません。 S3 APIオリジンの場合、この項目は存在しません。

パスパラメータに関する設定
Base Prefix	パラメータを指定するパスのプレフィックスオリジンにリクエストする際、マッチしたプレフィックスは取り除かれます
Target Prefix	オリジンから取得する際に利用するパスのプレフィックス
Parameter	指定する変換パラメータ URLによるパラメータの上書き・変更を許可しないにチェックをいれるとURLへの変換パラメータ指定を抑止します

オリジンの特定のパスに対して、あらかじめパラメータを設定できます。たとえば以下の例では、/small/以下にリクエストすると、縮小された画像を応答することを実現しています。

Base Prefixのマッチングは最長一致で行われます。複数のパスパラメータと一致する場合は、最も長いBase Prefixのパラメータのみが使用されます。