メインコンテンツへスキップ
見出し画像

ソシャゲのサーバーを作る。アカウントと認証を設計する(3)

    前回はキャラクターのマスターデータを入れるところまでやりました。

    今回はユーザーデータのテーブルを作ろうと思っていました。
    誰がどのキャラを持っているか、レベルはいくつか。そういうやつですね。

    ただ、user_idテーブル作ったとして、登録するところがない。

    「誰のデータか」が決まっていないと、ユーザーデータは1行も作れません。
    というわけで今回は、アカウントをどう作って、どうやってその人だと分かるのか。

    認証まわりの設計をやろうと思います。
    今回は仕組みの話だけ。

    ソシャゲの認証は、Webのログインと違う

    まず前提から。
    ソシャゲって、インストールして起動したら、もう遊べますよね。

    メールアドレスを入れることも、パスワードを決めることもあまりありません。
    気づいたらアカウントができています。
    最近は初回起動時にメールアドレスや、プラットフォームでのサインインが必要なタイトルもありますが。

    Webのサービスとはずいぶん違います。
    まず会員登録があって、メールが飛んできて、確認リンクを踏んで、ようやく始まるというのが多いのではないかと。

    なぜゲームはそうしないかというと、入口で人が減るからではないでしょうか、面倒なので、はい削除みたいな。
    広告を見て、ストアからダウンロードして、起動して。
    ここまで来た人にメールアドレスの入力を求めると、そこそこの割合が離脱します。
    せっかく来てくれたのに、ゲームの画面を見る前に帰ってしまう。
    個人的にもゲームを遊ぶだけなのに面倒だなと思うことがあります。
    もったいないですね。
    なので、まず起動したらフツーに遊べて、アカウントは裏で勝手に作っておく、というのがプレイ体験としてはいいと思います。

    そのかわり、超重要なことがあります。
    機種変更です、これはしっかりどうするか決めておかないと詰みます。

    メールアドレスもパスワードも無いということは、アカウントを取り戻す手段が無いということです。

    端末の中に「あなたはこの人です」という情報が入っているだけなので、端末を変えたらその情報が引き継がれません。
    新しい端末では、新規の人として扱われます。

    そのための引き継ぎコードですね。
    機種変更の前に発行して、メモしておいて、新しい端末で入力する。
    あれを面倒だと思ったことがある人は多いと思いますが、パスワードを入力させずにゲームを始めさせた結果として、ああなっています。

    認証のフロー

    作りとしてはこんな感じで。

    ■ 初回起動
    
    クライアント                       サーバー
      |                                 |
      |-- POST /auth/prepare ---------->|
      |                                 |  ワンタイムキーを発行
      |                                 |  数分で失効するように保存
      |<-- {onetime_key, expires_in} ---|
      |
      |  端末固有キーを生成して保存
      |
      |-- POST /auth/signup ----------->|
      |   {onetime_key, device_key}     |  ワンタイムキーを検証して即削除
      |                                 |  端末キーで既存アカウントを検索
      |                                 |    あり → その user_id(=ログイン)
      |                                 |    なし → user を作成
      |                                 |  トークンを発行
      |<-- {user_id, token} ------------|
      |
      |  トークンを保存
    
    ■ 以降のリクエスト
    
      |-- GET /user/hero/list --------->|
      |   Authorization: Bearer <token> |  トークンから user_id を引く
      |                                 |  無ければ 401
      |<-- {heroes:[...]} --------------|
    

    signupが、作成とログインを兼ねている

    ここが分かりにくいところかもしれません。
    signupという名前ですが、2回目以降に叩かれたら既存のアカウントを返します。
    端末キーが既に登録されていれば、その人ですからね。

    つまりクライアント側から見ると、初回起動もその後も、やることは同じです。
    起動したらsignupを叩く。
    新規なら作られるし、既存ならログインになる。
    ゲームを起動しただけでログイン済みになっている理由が、これですね。

    なぜprepareが要るのか

    いきなりsignupだけでも動きます。
    端末キーを送りつければアカウントは作れるので。
    分けているのは、アカウントを無限に作れる口を野ざらしにしないためです。
    prepareで発行したキーが無いとsignupは通らない。
    キーは数分で切れるし、一度使ったら消える。
    これだけでも、機械的に叩き続けるコストは上がります。
    もうひとつ、prepareとsignupの間隔も見られます。
    人間が操作していれば、それなりに時間がかかりますからね。

    テーブルを設計する

    api_game_userのほうに作ります。

    user

    CREATE TABLE `user` (
      `id` BIGINT NOT NULL AUTO_INCREMENT,
      `name` VARCHAR(32) NOT NULL,
      `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
      `last_login_at` DATETIME NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

    プレイヤー本体です。
    前回のマスタと違ってAUTO_INCREMENTが付いています。
    ユーザーのIDは誰かが決めるものではなく、重複しないことだけが条件なので、データベースに任せるのが確実ですね。
    認証に使う情報は、ここには入れません。

    user_auth

    CREATE TABLE `user_auth` (
      `id` BIGINT NOT NULL AUTO_INCREMENT,
      `user_id` BIGINT NOT NULL,
      `auth_type` TINYINT NOT NULL,
      `auth_key_hash` CHAR(64) NOT NULL,
      `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
      PRIMARY KEY (`id`),
      UNIQUE KEY `uk_auth` (`auth_type`, `auth_key_hash`),
      KEY `idx_user_id` (`user_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

    認証の手段を別のテーブルに切りました。
    userに列を足す形でも動くんですが、認証手段は増えるんですよね。
    最初は端末キーだけでも、そのうち引き継ぎコード、SNS連携、メール登録と増えていきます。
    そのたびにユーザーテーブルに列が生えるのは避けたいところです。

    1人が複数の認証手段を持てる形にしておくと、後から足すだけで済みます。
    auth_typeで種類を区別して、同じuser_idに何行でもぶら下げられますね。
    uk_authのユニーク制約は、同じ鍵で2つのアカウントができないようにするためです。
    signupが二重に叩かれても、片方は必ず弾かれます。

    鍵はそのまま保存しない

    auth_key_hashという名前のとおり、端末キーをそのまま入れていません。
    ハッシュにしてから保存します。
    もしデータベースの中身が漏れたとき、生の鍵が入っていたら全アカウントに成りすませます。
    ハッシュなら、漏れても鍵そのものは分かりません。

    照合するときは、送られてきた鍵を同じようにハッシュ化して比較するだけですね。
    元に戻す必要はないので、これで足ります。

    device_keyとtokenを分ける

    フロー図で、端末キーとトークンを別のものとして扱っていました。ここも意図があります。
    端末キーは変えられません。
    アカウントの本体に近いものですね。
    トークンは変えられます。
    期限が来たら再発行しますし、怪しければ失効させられます。
    これを同じにしてしまうと、鍵が漏れた瞬間に打つ手が無くなります。
    毎回のリクエストで飛ばすものは、失効できるものにしておく。
    分けておく理由はここですね。

    セッションをどこに置くか

    トークンからuser_idを引く処理は、すべてのAPIが必ず通ります。
    キャラ一覧を見るときも、ガチャを引くときも、まず「あなたは誰か」を確定させてから本題に入るので。
    1日に何十回、何百回と通る道ですね。
    置き場所は2つあります。
    データベースに置くなら、セッションのテーブルを1つ作って引くだけです。
    コンテナとかマイクロサービスが増えないのが利点ですね。
    ただし全リクエストがそのSELECTを通ることになります。
    Redisなどに置くなら、メモリ上のキーバリューなので速いです。
    あと有効期限を設定できるので、切れたセッションが勝手に消えます。
    データベースだと期限切れのレコードを自分で掃除することになりますね。
    さっきのワンタイムキーも同じで、数分で消えていい、一度使ったら捨てる、履歴を残す価値も無い。
    これはRedis向きのデータです。

    とりあえずデータベースだけで作って、そのあとRedisを入れようと思います。

    ボットとかの話

    軽く触れておこうかと思いますが。

    /auth/prepareは認証が要らないエンドポイントです。
    誰でも叩けます。
    当然、機械にも叩かれます、つまりそういうことです(笑)
    ここをIP制限かけたりするわけですね。
    完全には防げません。

    今回はここまで

    • ソシャゲの認証がメールもパスワードも使わない理由
    • prepareとsignupの2段構え
    • userとuser_authを分ける理由
    • 鍵はハッシュで保存する
    • セッションの置き場所
    次回はこれを実装します。アカウントが作れて、トークンでAPIが叩けるところまでですね。

    【最後まで読んでいただきありがとうございます!】
    面白かったと感じた方は、ぜひ「スキ」と「フォロー」をお願いします!

     
     
    泥臭い現場のリアルを語る現役エンジニア ゲーム開発歴30年。会社員・フリーランスの両方で修羅場をくぐり抜けてきた50代現役サーバプログラマです

    あなたへのおすすめ