Windows Azure Storageを利用したアプリケーションの作成（後編）

Windows Azureで作成するアプリケーションの基礎（4）

HTTPリクエストの認証

　Windows Azure Storageにアクセスするには、HTTPリクエストに、Authorization（認証）ヘッダーを追加します。

　REST APIのAuthentication Schemesでは、次のように形式が定められています。

Authorization: "[SharedKey|SharedKeyLite] <AccountName>:<Signature>"

　SharedKeyとSharedKeyLiteのどちらを選択するかで、その後に続く、<Signature>の部分のスキーマが異なってきます。ブロブやキューではSharedKeyのみ使用可能で、テーブルの場合どちらかをを選択することができます。<AccountName>の部分には、ストレージアカウントを指定します。

　この最後に来る<Signature>の部分は、REST APIの仕様で定められた文字列（HTTPメソッド、MIMEコンテンツタイプなどの情報を、改行コードで連結したもの）を認証キー（SharedKey）を用いてHMAC-SHA256アルゴリズムで署名したものです。

　この署名の際に使用する認証キー（SharedKey）は、ストレージアカウントの作成時に、エンドポイントと共に取得することができます（ストレージアカウントと認証キーの実際の取得方法については、前回の記事を参照してください）。また、サインインしたAzure Services Developer Portal上で、いつでも再生成することができます。ローカル環境のDevelopment Storage上では、この認証キーの値は、エンドポイントと同じく固定値となります。

　サンプルコードでは、BlobStorageUtilityクラスのToSignatureStringメソッドで、認証キーでの署名を行っています。受け取った文字列をバイト配列に変換し（※1）、認証キーを用いてHMAC-SHA256アルゴリズムで署名します（※2）。

［リスト2］ToSignatureStringメソッド（BlobStorageUtility.cs）

private static string ToSignatureString(string str)
{
    string signatureString = String.Empty;

    // Windows Azure Storageの認証キーをバイト配列に変換
    byte[] sharedKeyByte = Convert.FromBase64String(accountSharedKey);

    // 文字列をバイト配列に変換
    byte[] signatureStringBytes = Encoding.UTF8.GetBytes(str);  // ※1

    // HMAC-SHA256アルゴリズムで署名
    using (HMACSHA256 hmacsha256 = new HMACSHA256(sharedKeyByte))
    {
        signatureString = System.Convert.ToBase64String(
            hmacsha256.ComputeHash(signatureStringBytes));  // ※2
    }

    return signatureString;
}

　Authentication Schemesの仕様の詳細については、msdnの「Authentication Schemes」を参照してください。

メタデータの設定

　コンテナやブロブにメタデータを設定したい場合には、次のような形式で、HTTPリクエストにヘッダーを追加します。

x-ms-meta-{メタデータ名}:{メタデータ値}

　例えば、（サンプルで行っているように）titleという名前のメタデータをブロブに設定する場合は、

x-ms-meta-title:青い花のズーム写真

　というように、Put BlobのHTTPリクエストにヘッダーを追加します（実際にはメタデータの値はURLエンコードする必要があります）。

　サンプルコードでは、BlobStorageUtilityクラスのPutBlobRequestメソッドで、x-ms-meta-titleというヘッダー名を使用して画像のタイトル情報を追加しています（※1）。

［リスト3］PutBlobRequestメソッド（BlobStorageUtility.cs）

HttpWebRequest request = null;

（省略）

// HTTPリクエストを作成
request = (HttpWebRequest)WebRequest.Create(uri);

（省略）

// x-ms-meta-titleヘッダーを追加（メタデータとしてタイトル情報を追加）
request.Headers.Add("x-ms-meta-title", HttpUtility.UrlEncode(title));  // ※1

レスポンスの仕様

　リクエストの結果は、HTTPレスポンスのステータスコードで判断します。リクエストが成功だったのか、エラーの場合にはその理由も、このステータスコードにより判断することができます。例えば、コンテナ作成が成功した場合には、201（Created）が返ってきます。

　REST APIでは、使用するHTTPメソッドで、成功時のステータスコードが決まっています。以下にメソッドごとのステータスコードをまとめます。

成功時のステータスコード

HTTPメソッド	成功時のステータスコード
PUT	201（Created）
GET	200（OK）
DELETE	200（OK） または 202（Accepted）

　エラー時のステータスコードについては、さまざまな値が定義されています。詳細については、msdnの「Status and Error Codes」を参照してください。

　さらに、リクエストによっては、レスポンスヘッダに値が格納されたり、レスポンスボディにXMLデータやバイナリデータが含まれることがあります。例えば、ブロブの列挙（List Blobs）の場合、レスポンスボディにXMLデータが含まれ、その中にコンテナ内のブロブの情報が列挙されています。また、ブロブの取得（Get Blob）の場合なら、レスポンスヘッダにはデータサイズなどのコンテンツ情報が、レスポンスボディにはブロブのバイナリデータが含まれます。

　サンプルコードでは、Default.aspx.csのDisplayメソッドで、ブロブの列挙（List Blobs）のリクエストでレスポンスボディに格納されたXMLデータの解析を行っています。

［リスト4］Displayメソッド（Default.aspx.cs）

// HTTPレスポンスを取得
using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
{
    if (response.StatusCode == HttpStatusCode.OK)
    {
        using (Stream stream = response.GetResponseStream())
        {
            XmlReader reader = XmlReader.Create(stream);  // ※1
            XDocument doc = XDocument.Load(reader);  // ※2

            var blobList = from list in doc.Descendants("Blob")
                           select new BlobData
                           {
                               BlobUrl = (string)list.Element("Url"),
                               ImageUrl = "GetImage.aspx?url=" + (string)list.Element("Url")
                           };  // ※3

            DataList1.DataSource = blobList;
            DataList1.DataBind();
        }
    }
    else
    {
        （省略）
    }
}

　レスポンスボディに格納されたストリームから、XmlReaderオブジェクトを作成します（※1）。次に、XmlReaderオブジェクトからXMLデータを読み込み（※2）、LINQを使用してブロブのリストを取得します（※3）。