通常の送信方法(ペイロードの分割をしない)¶

ペイロードのハッシュ値全体を計算し、署名計算に含めることができます。これによりセキュリティが強化されますが、ペイロードを2回読み取るか、メモリにバッファーする必要があります。ペイロードが小さい場合は、この方法が適している場合があります。ただし、大きなファイルの場合、ファイルを2回読み取ると効率が悪くなる可能性があるため、データをチャンク単位でアップロードすることをお勧めします。詳細はこちらを参照ください。CanonicalRequestの作成時にペイロードのハッシュ値を含めます。x-iijgio-content-sha256ヘッダー値と同じ値を指定します。

ペイロードをチャンクに分割する場合¶

ペイロードの署名を計算の方法として、前述のようにペイロード全体を一度にハッシュ計算するのではなく、ペイロードを小さなチャンクに分割し、チャンク毎に署名を計算し認証する方式を提供しています。これによりペイロード全体を読み取って署名を計算する必要がなくなり、クライアント側での署名計算を効率的に行うことができます。最初のチャンクでは、リクエストヘッダーのみを使用するシードシグネチャを計算します。2番目のチャンクには、最初のチャンクの署名が含まれ、後続の各チャンクには、その前のチャンクの署名が含まれます。アップロードの最後に、ペイロードの最後のチャンクの署名を含む0バイトのデータを含む最終チャンクを送信します。詳細はシグネチャの内容(複数チャンク)を参照ください。

<CanonicalURI>要素¶

URI の絶対パス要素の URI エンコードバージョンで、HTTP ホストヘッダーからクエリ文字列パラメータ (存在する場合) を開始する疑問符 (”?”) までのすべてを含みます。IIJGIO dagへのリクエストのURIパスを正規化しません。たとえば、「my-object//example//photo.user」という名前のオブジェクトを持つバケットがあるとします。パスを正規化すると、リクエスト内のオブジェクト名が「my-object/example/photo.user」に変更されます。これは、そのオブジェクトの誤ったパスです。

例)

http://storage-dag.iijgio.com/examplebucket/myphoto.jpg
CanonicalURI = /examplebucket/myphoto.jpg

<CanonicalQueryString>要素¶

URIエンコードされたクエリ文字列パラメーターを指定します。名前と値を個別にURIエンコードします。また、CanonicalQueryString のパラメータをキー名のアルファベット順に並べ替える必要があります。ソートはURIエンコード後に行われます。名前が重複しているパラメータは、値でさらにソートする必要があります。

擬似コード

UriEncode("marker")+"="+UriEncode("someMarker")+"&"+
UriEncode("max-keys")+"="+UriEncode("20") + "&" +
UriEncode("prefix")+"="+UriEncode("somePrefix")

※読みやすくするために、この例には改行が追加されています※UriEncode()はUriEncode()に詳細記載

例)

http://storage-dag.iijgio.com/examplebucket?prefix=somePrefix&marker=someMarker&max-keys=20
CanonicalQueryString = prefix=somePrefix&marker=someMarker&max-keys=20

リクエストがサブリソースを対象とする場合、対応するクエリパラメータ値は空の文字列（”“）になります。

例)

http://storage-dag.iijgio.com/examplebucket?acl
CanonicalQueryString = UriEncode("acl") + "=" + ""

URIに「？」が含まれていない場合、リクエストにはクエリ文字列がなく、CanonicalQueryString を空の文字列（”“）に設定します。「\n」を含める必要があります。

public static String UriEncode(CharSequence input, boolean encodeSlash) {
        StringBuilder result = new StringBuilder();
        for (int i = 0; i < input.length(); i++) {
            char ch = input.charAt(i);
            if ((ch >= "A" && ch <= "Z") || (ch >= "a" && ch <= "z") || (ch >= "0" && ch <= "9") || ch == "_" || ch == "-" || ch == "~" || ch == ".") {
                result.append(ch);
            } else if (ch == "/") {
                result.append(encodeSlash ? "%2F" : ch);
            } else {
                result.append(toHexUTF8(ch));
            }
        }
        return result.toString();
    }

<CanonicalHeaders>要素¶

署名付きリクエストに含めるすべての HTTP ヘッダーのリストで構成されます。リストを作成するには、すべてのヘッダー名を小文字に変換し、先頭および末尾のスペースを削除します。ヘッダー値にある連続スペースを単一のスペースに変換します。リストには以下を含める必要があります。

• HTTPホストヘッダー。
• Content-Typeヘッダーがリクエストに存在する場合は、リストに追加する必要があります。
• リクエストに含める予定のx-iijgio-*ヘッダーも追加する必要があります。たとえば、一時的なセキュリティ認証情報を使用している場合は、リクエストにx-iijgio-security-tokenを含める必要があり、リストにもこのヘッダーを追加する必要があります。

擬似コード

CanonicalHeaders = CanonicalHeadersEntry0 + CanonicalHeadersEntry1 + ... + CanonicalHeadersEntryN
CanonicalHeadersEntry = Lowercase(HeaderName) + ":" + Trimall(HeaderValue) + "\n"

※ Lowercase() : 全ての文字列を小文字に変換する関数※ Trimall() : 値の前後のスペースを削除し、連続するスペースを単一のスペースに変換する関数

リストを構築するには、(小文字の) ヘッダーを文字コードでソートし、ヘッダー名を繰り返し処理します。次のルールに従って各ヘッダーを作成します。

• 小文字のヘッダー名とそれに続くコロンを追加します。
• このヘッダーの値のカンマ区切りリストを追加します。複数の値を持つヘッダーの値はソートしません。
• 改行 (\n) を追加します。

<SignedHeaders>要素¶

この値は、<CanonicalHeaders>要素に含めたヘッダーのリストです。

SignedHeaders = Lowercase(HeaderName0) + ";" + Lowercase(HeaderName1) + ";" + ... + Lowercase(HeaderNameN)

※ Lowercase() : 全ての文字列を小文字に変換する関数* すべてのヘッダー名を小文字に変換してソートし、セミコロンで連結します。

<HashedPayload>要素¶

ペイロードのSHA256ハッシュの16進値です。

ペイロードの構造

HexEncode(SHA256Hash(<payload>)

// リクエストにペイロードがない場合
HexEncode(SHA256Hash(""))

ALGORITHM定数¶

IIJGIO署名のバージョンと、署名の計算に使用したアルゴリズムを識別します。IIJGIO署名バージョン4の場合、このパラメーター値を「IIJGIO4-HMAC-SHA256」に設定します。 この文字列は、IIJGIO署名バージョン4（IIJGIO4）とHMAC-SHA256アルゴリズム（HMAC-SHA256）を識別します。

<RequestDateTime>要素¶

リクエスト日付。日付は、ISO8601 基本形式を使用し、x-iijgio-date ヘッダーで YYYYMMDD’T’HHMMSS’Z’ 形式で指定します。この値は、前のステップで使用した値と一致する必要があります。

<CredentialScope>要素¶

<requestDate>/<regionName>/<serviceName>/iijgio4_request

次の順序の文字列をスラッシュで区切ったものです。

1.リクエストの年（YYYY）、月（MM）、日（DD）を表す 8 桁の文字列としての日付情報（例: 20150830）。

2.小文字の英数字の文字列としてのリージョン情報。サービスのエンドポイントの一部であるリージョン名を使用します。

3.小文字の英数字の文字列としてのサービス名情報（例: dag）。

4.特殊な終了文字列: 「iijgio4_request」