メインコンテンツまでスキップ

Gadget サーバーからゲームサーバーへのリクエスト

Gadget サーバーはユーザーからのリクエストに応じてゲームサーバーへコンテンツリクエスト行います。

Gadget サーバーから送信される情報​

リクエストヘッダ​

ヘッダー名説明
User-Agentユーザー端末のブラウザ情報
Accept-Encodinggzipもしくはdeflate 通信を許容
  • ユーザーからの UserAgent リクエストヘッダは そのままゲームサーバーにプロキシーされます。この値で iPhone 端末か Android 端末などの判別をしてください。
  • いずれも端末固有の情報 (端末製造番号など) は Gadget サーバーにより削除されます。
  • 上記以外のユーザーからのリクエストヘッダは Gadget サーバーにより削除されます。

クエリパラメータ​

フィールド名説明
opensocial_app_idこのアプリケーションの ID
opensocial_viewer_idこのアプリケーションを利用しているユーザーの ID
opensocial_owner_idこのアプリケーションをインストールしているユーザーの ID
  • 現在は opensocial_viewer_id と opensocial_owner_id には同じ値が含まれます。
  • これらに加えてユーザが指定するクエリパラメータが含まれます。

OAuth Signature の検証​

Authorization ヘッダに含まれる OAuth Signature はゲームサーバーへのリクエストが改ざんされていないことを検証するための情報です。悪意を持った第三者からのリクエストを受けて予期しない動作を起こさないように必ず OAuth Signature の検証を行って行ください。なお、画像ファイルには通常 Authorization ヘッダは付きません。検証を行いたい場合は signed=1 クエリパラメータを付けていただく必要があります。

検証には以下の手順を踏みます。

Base String の生成​

生成は以下の手順で行います。

  1. HTTP リクエストメソッドを取得します。(例: GET)
  2. URL からクエリパラメータを除いたものを用意します。(例: http://example.com/123456789)
  3. Authorization ヘッダから realm と oauth_signature を除くプロトコルパラメータを取得します

Authorization ヘッダから取得するパラメータ​

フィールド名説明
oauth_consumer_keyアプリケーション登録時に発行される値
oauth_nonceリクエスト毎にユニークな値
oauth_signature_method署名方法 (HMAC-SHA1 固定)
oauth_timestampUNIX タイムスタンプ値
oauth_tokenアクセストークン
oauth_token_secretトークンシークレット
oauth_versionOAuth のバージョン (1.0 固定)

  4. Gadgetサーバから送られてきたクエリパラメータをすべて取得します。
  5. POST リクエストでContent-Typeが application/x-www-form-urlencoded の場合,ボディパラメータを取得します。
  6. 3から5で取得したパラメータを仕様にしたがって結合します。キーと値はそれぞれ英数字,"-", ".","_","~"以外のすべての文字をパーセントエンコードして "=" で連結します。また、連結したキーと値のペアはアルファベット順にソートして,"&" で連結します。なお、POSTされてきた日本語の文字コードをUTF-8に変換する必要はありません。

Base String の生成例​

例としてゲームサーバーに以下のようなリクエストが来た場合

GET ?opensocial_app_id=999999&opensocial_viewer_id=12345&opensocial_owner_id=12345 HTTP/1.1
Authorization:
OAuth realm="",
oauth_consumer_key="abcdefghij1234567890",
oauth_nonce="abcdefghij1234567890",
oauth_signature="I%2BInIlnDZOUuB%2FROXjjOC%2Bi09fc%3D",
oauth_signature_method="HMAC-SHA1",
oauth_timestamp="1234567890",
oauth_token="abcdefghij1234567890",
oauth_token_secret="abcdefghij1234567890",
oauth_version="1.0"

Base Stringは以下のようになります。

GET&http%3A%2F%2Fexample.com&
oauth_consumer_key%3Dabcdefghij1234567890%26
oauth_nonce%3Dabcdefghij1234567890%26
oauth_signature_method%3DHMAC-SHA1%26
oauth_timestamp%3D1234567890%26
oauth_token%3Dabcdefghij1234567890%26
oauth_token_secret%3Dabcdefghij1234567890%26
oauth_version%3D1.0%26
opensocial_app_id%3D999999%26
opensocial_owner_id%3D12345%26
opensocial_viewer_id%3D12345

Signature の生成と比較​

Signature は Base String をキー文字列で署名して生成します。

キー文字列はアプリケーション登録時に発行された Consumer Secret と Authorization ヘッダの oauth_token_secret をパーセントエンコードし,"&" で連結した値です。ダイジェスト値の生成には Authorization ヘッダの oauth_signature_method で指定されているアルゴリズム (現在はHMAC-SHA1固定) を利用します。この値をさらに BASE64 エンコードしたものが Signature になります(ダイジェスト値を生成したときに改行などの文字列が追加される場合は取り除いてから BASE64 エンコードしてください)。

この値と Authorization ヘッダの oauth_signature を比較することによってリクエストの検証を行うことができます。

先ほどの例を用いて取得できる値は、

I+InIlnDZOUuB/ROXjjOC+i09fc=

ですので、Authorization ヘッダの

oauth_signature="I%2BInIlnDZOUuB%2FROXjjOC%2Bi09fc%3D"

をURIアンエスケープした値と同じことで検証することができます。

注意事項​

備考

特定のフォームデータ形式をPOSTした際にsignatureが一致しないケースが発生しております。
現在、対応策を検討しておりますが OAuthライブラリ の影響をうけないアンダースコア形式を暫定対応として推奨します。

<input name="abc[123]" type="text" value="一致しない" />
<input name="abc_123" type="text" value="一致する" /> 

OAuth Signature の検証サンプルコード​

以下のサンプルコードは Signature の妥当性のチェックのみです。timestamp や nonce の妥当性チェックは別途行う必要があります。

Perl

  • サンプルで使われている OAuth::Lite モジュールは CPAN で配布されています。

  • OAuth::Lite モジュールは 1.24 以上を利用してください。

    #!/usr/bin/perl
    use strict;
    use warnings;
    use OAuth::Lite::ServerUtil;
    use OAuth::Lite::Util qw/parse_auth_header/;
    use CGI;
    my $cgi = CGI->new;
    my ($realm, $params) = parse_auth_header($ENV{HTTP_AUTHORIZATION});
    for my $key ($cgi->url_param) {
    $params->{$key} = [$cgi->url_param($key)];
    }
    if (uc $cgi->request_method eq 'POST'
    && $cgi->content_type =~ m{^\Qapplication/x-www-form-urlencoded}) {
    for my $key ($cgi->param) {
    $params->{$key} = [$cgi->param($key)];
    }
    }

    my $util = OAuth::Lite::ServerUtil->new(strict => 0);
    $util->support_signature_method('HMAC-SHA1');

    my $valid = $util->verify_signature(
    method => $cgi->request_method,
    url => $cgi->url,
    params => $params,
    consumer_secret => 'YOUR_CONSUMER_SECRET',
    token_secret => $params->{oauth_token_secret},
    );
    print $cgi->header;
    print $valid;

PHP

  • サンプルで使われている OAuth ライブラリはOAuth コミュニティにより配布されています。

    <?php
    require_once 'OAuth.php';

    $consumer_key = 'YOUR_CONSUMER_KEY';
    $consumer_secret = 'YOUR_COSUMER_SECRET';

    $req = OAuthRequest::from_request(NULL, NULL, NULL);
    $consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);
    $token = new OAuthToken(
    $req->get_parameter('oauth_token'),
    $req->get_parameter('oauth_token_secret'));
    $sign_method = new OAuthSignatureMethod_HMAC_SHA1();
    $sign = $req->get_parameter('oauth_signature');
    $valid = $sign_method->check_signature($req, $consumer, $token, $sign);
    ?>
    <?= $valid ?>

参考資料​

The OAuth Core 1.0 Protocol draft-hammer-oauth-10
OAuth Core 1.0 Revision A

更新履歴​

  • 2013/10/09
    • 配列フォームデータがPOSTされた場合に発生するsignature不具合に関する記述を追加
  • 2013/03/29
    • Accept-Encodingの記述を追加
  • 2013/03/15
    • ドキュメント移行
  • Gadget サーバーから送信される情報
    • リクエストヘッダ
    • クエリパラメータ
    • OAuth Signature の検証
    • Signature の生成と比較
    • 注意事項
    • OAuth Signature の検証サンプルコード
  • 参考資料
  • 更新履歴