カスタムポリシーを使用する署名付き URL の作成
トピック
カスタムポリシーを使用して署名付き URL を作成するには、以下の手順を実行します。
カスタムポリシーを使用して署名付き URL を作成するには
-
.NET または Java を使用して署名付き URL を作成しており、キーペアのプライベートキーをデフォルトの .pem 形式から .NET または Java 対応の形式に変更していない場合は、それを変換します。詳細については、「プライベートキーの形式の変更 (.NET および Java のみ)」を参照してください。
-
以下の値を指定の順序で連結し、パート間の空白文字 (タブと改行文字を含む) を削除します。アプリケーションコード内の文字列にエスケープ文字を含めることが必要になる場合があります。すべての値は文字列型です。各パートの番号 (
) は以下の 2 つの例の番号に対応します。
-
ファイルのベース URL
-
ベース URL は、署名付き URL を使用しなかった場合にファイルへのアクセスに使用する CloudFront URL であり、独自のクエリ文字列パラメータを含みます (ある場合)。ディストリビューション用の URL 形式の詳細については、「CloudFront でファイルの URL の形式をカスタマイズする」を参照してください。
以下の例は、ディストリビューションで指定する値を示しています。
-
以下の CloudFront URL は、ディストリビューション内のイメージファイルの URL です (CloudFront ドメイン名を使用)。
image.jpg
はimages
ディレクトリにあります。URL 内のファイルへのパスは、HTTP サーバーまたは Amazon S3 バケットのファイルへのパスに一致する必要があります。https://d111111abcdef8.cloudfront.net/images/image.jpg
-
以下の CloudFront URL には、クエリ文字列が含まれます。
https://d111111abcdef8.cloudfront.net/images/image.jpg?size=large
-
以下の CloudFront URL は、ディストリビューション内のイメージファイルの URL です。両方の URL で代替ドメイン名が使用されており、2 番目の URL にはクエリ文字列が含まれています。
https://www.example.com/images/image.jpg
https://www.example.com/images/image.jpg?color=red
-
以下の CloudFront URL は、代替ドメイン名と HTTPS プロトコルを使用するディストリビューション内のイメージファイルの URL です。
https://www.example.com/images/image.jpg
-
-
?
-
? は、クエリ文字列パラメータがベース URL の後に続いていることを示します。独自のクエリ文字列パラメータがない場合も ? を含めます。
-
クエリ文字パラメータ (ある場合)
& -
この値はオプションです。独自のクエリ文字列パラメータ、たとえば次のクエリ文字列パラメータを追加すると仮定します。
color=red&size=medium
この場合、? (
を参照) の後、かつ
Policy
パラメータの前にこのパラメータを追加します。特定のまれな状況では、Key-Pair-Id
の後にクエリ文字列パラメータを配置する必要があります。重要 パラメータに
Policy
、Signature
、またはKey-Pair-Id
という名前を付けることはできません。独自のパラメータを追加する場合は、最後のパラメータを含め、各パラメータの後に & を付加します。
-
Policy=
ポリシーステートメントの base64 エンコードバージョン
-
空白文字が削除され、base64 エンコードされた、JSON 形式のポリシーステートメント。詳細については、「カスタムポリシーを使用する署名付き URL のポリシーステートメントの作成」を参照してください。
ポリシーステートメントは、署名付き URL によってユーザーに許可されるアクセスをコントロールします。これには、ファイルの URL、有効期限切れ日時、URL が有効になる日時 (オプション)、ファイルへのアクセスが許可されている IP アドレスまたは IP アドレス範囲 (オプション) が含まれます。
-
&Signature=
ハッシュ化および署名されたバージョンのポリシーステートメント
-
ハッシュ化され、署名された base64 エンコードバージョンの JSON ポリシーステートメント。詳細については、「カスタムポリシーを使用する署名付き URL の署名の作成」を参照してください。
-
&Key-Pair-Id=
署名の生成に使用しているプライベートキーに対応する CloudFront パブリックキーのパブリックキー ID
-
CloudFront パブリックキーの ID (
K2JCJMDEHXQW5F
など)。パブリックキー ID は、署名付き URL の検証に使用するパブリックキーを CloudFront に通知します。CloudFront は、署名内の情報をポリシーステートメント内の情報と比較して、URL が改ざんされていないことを確認します。このパブリックキーは、ディストリビューションの信頼された署名者であるキーグループに属している必要があります。詳細については、「署名付き URL と署名付き Cookie を作成できる署名者の指定」を参照してください。
-
署名付き URL の例:
https://d111111abcdef8.cloudfront.net/image.jpg
?
color=red&size=medium&
Policy=eyANCiAgICEXAMPLEW1lbnQiOiBbeyANCiAgICAgICJSZXNvdXJjZSI6Imh0dHA
6Ly9kemJlc3FtN3VuMW0wLmNsb3VkZnJvbnQubmV0L2RlbW8ucGhwIiwgDQogICAgICAiQ
29uZGl0aW9uIjp7IA0KICAgICAgICAgIklwQWRkcmVzcyI6eyJBV1M6U291cmNlSXAiOiI
yMDcuMTcxLjE4MC4xMDEvMzIifSwNCiAgICAgICAgICJEYXRlR3JlYXRlclRoYW4iOnsiQ
VdTOkVwb2NoVGltZSI6MTI5Njg2MDE3Nn0sDQogICAgICAgICAiRGF0ZUxlc3NUaGFuIjp
7IkFXUzpFcG9jaFRpbWUiOjEyOTY4NjAyMjZ9DQogICAgICB9IA0KICAgfV0gDQp9DQo
&Signature=nitfHRCrtziwO2HwPfWw~yYDhUF5EwRunQA-j19DzZrvDh6hQ73lDx~
-ar3UocvvRQVw6EkC~GdpGQyyOSKQim-TxAnW7d8F5Kkai9HVx0FIu-5jcQb0UEmat
EXAMPLE3ReXySpLSMj0yCd3ZAB4UcBCAqEijkytL6f3fVYNGQI6
&Key-Pair-Id=K2JCJMDEHXQW5F
カスタムポリシーを使用する署名付き URL のポリシーステートメントの作成
カスタムポリシーのポリシーステートメントを作成するには、以下の手順を実行します。さまざまな方法でファイルへのアクセスを制御するポリシーステートメントのいくつかの例については、「カスタムポリシーを使用する署名付き URL のポリシーステートメントの例」を参照してください。
カスタムポリシーを使用する署名付き URL のポリシーステートメントを作成するには
-
以下の JSON 形式を使用してポリシーステートメントを構築します。詳細については、「カスタムポリシーを使用する署名付き URL のポリシーステートメントで指定する値」を参照してください。
{ "Statement": [ { "Resource": "URL or stream name of the file", "Condition": { "DateLessThan": { "AWS:EpochTime": required ending date and time in Unix time format and UTC }, "DateGreaterThan": { "AWS:EpochTime": optional beginning date and time in Unix time format and UTC }, "IpAddress": { "AWS:SourceIp": "optional IP address" } } } ] }
次の点に注意してください。
-
1 つのステートメントのみを含めることができます。
-
UTF-8 文字エンコードを使用します。
-
すべての句読点およびパラメータ名を、指定されたとおりに正確に含めます。パラメータ名の省略形は受け付けられません。
-
Condition
セクションのパラメータの順序は問題ではありません。 -
Resource
、DateLessThan
、DateGreaterThan
、およびIpAddress
の値については、「カスタムポリシーを使用する署名付き URL のポリシーステートメントで指定する値」を参照してください。
-
-
ポリシーステートメントからすべての空白文字 (タブと改行文字を含む) を削除します。アプリケーションコード内の文字列にエスケープ文字を含めることが必要になる場合があります。
-
MIME base64 エンコーディングを使用してポリシーステートメントを Base64 エンコードします。詳細については、RFC 2045, MIME (Multipurpose Internet Mail Extensions) Part One: Format of Internet Message Bodies の Section 6.8, Base64 Content-Transfer-Encoding
を参照してください。 -
URL クエリ文字列内の無効な文字を有効な文字で置き換えます。次の表に無効な文字と有効な文字を示します。
無効な文字 (置換元) 有効な文字 (置換先) +
- (ハイフン)
=
_ (下線)
/
~ (チルダ)
-
結果の値を署名付き URL の
Policy=
の後に付加します。 -
ポリシーステートメントのハッシュ化、署名、および base64 エンコードを行って、署名付き URL の署名を作成します。詳細については、「カスタムポリシーを使用する署名付き URL の署名の作成」を参照してください。
カスタムポリシーを使用する署名付き URL のポリシーステートメントで指定する値
カスタムポリシーのポリシーステートメントを作成する場合、以下の値を指定します。
- リソース
-
注記 Resource
の日付形式は 1 つだけ指定できます。クエリ文字列 (ある場合) が含まれるベース URL。ただし、CloudFront の
Policy
、Signature
、およびKey-Pair-Id
パラメータが除外されます。次に例を示します。https://d111111abcdef8.cloudfront.net/images/horizon.jpg?size=large&license=yes
重要 ディストリビューションで Resource パラメータを省略した場合、ユーザーは、署名付き URL の作成に使用するキーペアに関連付けられたあらゆるディストリビューションに関連付けられるすべてのファイルにアクセスできます。
次の点に注意してください。
-
プロトコル – 値は
http://
、https://
、または*://
で始まっている必要があります。 -
クエリ文字列パラメータ – クエリ文字列パラメータがない場合は、疑問符を省略します。
-
ワイルドカード文字 – 0 個以上の文字に一致するワイルドカード文字 (*)、または 1 個の文字に一致するワイルドカード文字 (?) を使用できます。文字列のどこにでも含めることができます。次に例を示します。この値は、
https://d111111abcdef8.cloudfront.net/*game_download.zip*
たとえば、次のファイルを含みます。
-
https://d111111abcdef8.cloudfront.net/game_download.zip
-
https://d111111abcdef8.cloudfront.net/example_game_download.zip?license=yes
-
https://d111111abcdef8.cloudfront.net/test_game_download.zip?license=temp
-
-
代替ドメイン名 – URL で代替ドメイン名 (CNAME) を指定する場合は、ウェブページまたはアプリケーション内のファイルを参照するときに代替ドメイン名を指定する必要があります。ファイルの Amazon S3 URL を指定しないでください。
-
- DateLessThan
-
URL の有効期限切れ日時。Unix 時間形式 (秒単位) および協定世界時 (UTC) で指定します。値を引用符で囲まないでください。UTC の詳細については、RFC 3339, Date and Time on the Internet: Timestamps (https://tools.ietf.org/html/rfc3339
) を参照してください。 たとえば、UTC の 2013 年 1 月 1 日午前 10 時 00 分は、Unix 時間形式の 1357034400 に変換されます。
これは、
Condition
セクションにおける唯一の必須パラメータです。CloudFront では、プライベートコンテンツへの永久的なアクセスがユーザーに許可されることのないよう、この値の指定が要求されます。詳細については、「CloudFront が署名付き URL 内の有効期限切れ日時を確認するタイミング」を参照してください。
- DateGreaterThan (オプション)
-
オプションの URL 開始日時。Unix 時間形式 (秒単位) および協定世界時 (UTC) で指定します。ユーザーは指定された日時よりも前にファイルにアクセスすることは許可されていません。値を引用符で囲まないでください。
- IpAddress (オプション)
-
GET リクエストを実行するクライアントの IP アドレス。次の点に注意してください。
-
ファイルへのアクセスをすべての IP アドレスに許可するには、
IpAddress
パラメータを省略します。 -
IP アドレスまたは IP アドレス範囲を 1 つ指定できます。たとえば、2 つの別々の範囲のどちらかにクライアントの IP アドレスが入っている場合にアクセスを許可するようなポリシーを設定することはできません。
-
1 つの IP アドレスからのアクセスを許可するには、以下のように指定します。
"
IPv4 IP アドレス
/32"
-
IP アドレス範囲は標準の IPv4 CIDR 形式 (
192.0.2.0/24
など) で指定する必要があります。詳細については、RFC 4632, Classless Inter-domain Routing (CIDR): The Internet Address Assignment and Aggregation Plan (https://tools.ietf.org/html/rfc4632) を参照してください。 重要 IPv6 形式の IP アドレス (例: 2001:0db8:85a3::8a2e:0370:7334) はサポートされていません。
IpAddress
を含むカスタムポリシーを使用する場合、ディストリビューションで IPv6 は有効にしません。一部のコンテンツへのアクセスを IP アドレスによって制限し、他のコンテンツで IPv6 リクエストをサポートする場合、2 つのディストリビューションを作成します。詳細については、トピック「ディストリビューションを作成または更新する場合に指定する値」の「IPv6 を有効にする」を参照してください。
-
カスタムポリシーを使用する署名付き URL のポリシーステートメントの例
以下のポリシーステートメントの例は、特定のファイル、ディレクトリ内のすべてのファイル、またはキーペア ID に関連付けられたすべてのファイルへのアクセスを制御する方法を示しています。また、この例は、個々の IP アドレスまたは IP アドレス範囲からのアクセスを制御する方法、および指定された日時以降にユーザーが署名付き URL を使用することを禁止する方法も示しています。
この例のいずれかをコピーして貼り付ける場合は、すべての空白文字 (タブと改行文字を含む) を削除し、適用可能な値を独自の値で置き換えて、右中かっこ ( } ) の後に改行文字を含めます。
詳細については、「カスタムポリシーを使用する署名付き URL のポリシーステートメントで指定する値」を参照してください。
トピック
ポリシーステートメントの例: IP アドレス範囲から 1 つのファイルにアクセスする
次の署名付き URL 内のカスタムポリシーの例では、UTC の 2013 年 1 月 1 日午前 10 時 00 分まで、範囲 https://d111111abcdef8.cloudfront.net/game_download.zip
の IP アドレスから、ユーザーがファイル 192.0.2.0/24
にアクセスできることを指定しています。
{ "Statement": [ { "Resource": "https://d111111abcdef8.cloudfront.net/game_download.zip", "Condition": { "IpAddress": { "AWS:SourceIp": "192.0.2.0/24" }, "DateLessThan": { "AWS:EpochTime": 1357034400 } } } ] }
ポリシーステートメントの例: IP アドレス範囲からディレクトリ内のすべてのファイルにアクセスする
以下のカスタムポリシーの例では、Resource
パラメータの * ワイルドカード文字が示すとおり、training
ディレクトリ内のあらゆるファイルを対象とする署名付き URL を作成できます。UTC の 2013 年 1 月 1 日午前 10 時 00 分まで、範囲 192.0.2.0/24
の IP アドレスから、ユーザーはファイルにアクセスできます。
{ "Statement": [ { "Resource": "https://d111111abcdef8.cloudfront.net/training/*", "Condition": { "IpAddress": { "AWS:SourceIp": "192.0.2.0/24" }, "DateLessThan": { "AWS:EpochTime": 1357034400 } } } ] }
このポリシーを使用する各署名付き URL には、たとえば次のように、特定のファイルを識別するベース URL が含まれます。
https://d111111abcdef8.cloudfront.net/training/orientation.pdf
ポリシーステートメントの例: キーペア ID に関連付けられたすべてのファイルに 1 つの IP アドレスからアクセスする
以下のカスタムポリシーの例では、Resource
パラメータの * ワイルドカード文字が示すとおり、あらゆるディストリビューションに関連付けられたあらゆるファイルを対象とする署名付き URL を作成できます。ユーザーは IP アドレス 192.0.2.10/32
を使用する必要があります。(CIDR 表記の値 192.0.2.10/32
は 1 つの IP アドレス 192.0.2.10
を参照します)。ファイルは、UTC の 2013 年 1 月 1 日午前 10 時 00 分から UTC の 2013 年 1 月 2 日午前 10 時 00 分まで使用できます。
{ "Statement": [ { "Resource": "https://*", "Condition": { "IpAddress": { "AWS:SourceIp": "192.0.2.10/32" }, "DateGreaterThan": { "AWS:EpochTime": 1357034400 }, "DateLessThan": { "AWS:EpochTime": 1357120800 } } } ] }
このポリシーを含める各署名付き URL には、たとえば次のように、特定の CloudFront ディストリビューション内の特定のファイルを識別するベース URL が含まれます。
https://d111111abcdef8.cloudfront.net/training/orientation.pdf
署名付き URL にはキーペア ID も含まれます。キーペア ID は、ベース URL に指定されたディストリビューション (d111111abcdef8.cloudfront.net) 内の信頼されたキーグループに関連付けられる必要があります。
カスタムポリシーを使用する署名付き URL の署名の作成
カスタムポリシーを使用する署名付き URL の署名は、ハッシュ化、署名、および base64 エンコードが行われたバージョンのポリシーステートメントです。カスタムポリシーの署名を作成するには、以下の手順を実行します。
ポリシーステートメントのハッシュ化、署名、およびエンコードを行う方法の詳細および例については、以下の各資料を参照してください。
オプション 1: カスタムポリシーを使用して署名を作成するには
-
「カスタムポリシーを使用する署名付き URL のポリシーステートメントを作成するには」の手順で作成した JSON ポリシーステートメントを、SHA-1 ハッシュ関数と RSA を使用してハッシュ化し、署名します。空白文字が含まれていないが、まだ base64 エンコードされていないバージョンのポリシーステートメントを使用します。
ハッシュ関数に必要なプライベートキーには、対応するパブリックキーがディストリビューション内のアクティブな信頼されたキーグループにあるものを使用してください。
注記 ポリシーステートメントをハッシュ化および署名するための方法は、プログラミング言語およびプラットフォームによって異なります。サンプルコードについては、「署名付き URL の署名を作成するためのコード例」を参照してください。
-
ハッシュ化および署名された文字列から、空白文字 (タブや改行文字を含む) を削除します。
-
MIME base64 エンコーディングを使用して文字列を Base64 エンコードします。詳細については、RFC 2045, MIME (Multipurpose Internet Mail Extensions) Part One: Format of Internet Message Bodies の Section 6.8, Base64 Content-Transfer-Encoding
を参照してください。 -
URL クエリ文字列内の無効な文字を有効な文字で置き換えます。次の表に無効な文字と有効な文字を示します。
無効な文字 (置換元) 有効な文字 (置換先) +
- (ハイフン)
=
_ (下線)
/
~ (チルダ)
-
結果の値を署名付き URL の
&Signature=
の後に付加し、「カスタムポリシーを使用して署名付き URL を作成するには」に戻って、署名付き URL の各パートの連結を終了します。