
ソシャゲのサーバーを作る。アカウントと認証を設計する(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が叩けるところまでですね。
【最後まで読んでいただきありがとうございます!】
面白かったと感じた方は、ぜひ「スキ」と「フォロー」をお願いします!