概要
3种认证流程
使用 Mobage JavaScript SDK 登录 Mobage Connect ,有以下3种流程。
- 画面不跳转直接登录的Hybrid 流程
- 【选项】画面跳转登录的 Authorization Code Grant 流程
- 【选项】不使用 Game Server 直接登录的 Client-Side 流程
如果您使用 Mobage JavaScript SDK ,那么您可以采用以前在 Proxy Server 模式中不能实现的 画面不跳转直接登录的流程**( Hybrid** 流程**)** ,根据游戏的提供情况,您也可以组合使用上述流程。
各种流程的特点汇总如下。
- 关于登录时机的设置和实现时的注意事项,请参见这里。
- 关于不同登录时机的优缺点,请参见这里。
- 要错开登录时机时,请务必确认面向非 Mobage 会员的开发注意事项。
- 登录时,“简易会员”会同 NBPF SPWeb、NBPF Shell App 一起流入。关于“简易会员”,请参见这里 。
画面不跳转直接登录的 Hybrid 流程
不是从游戏画面跳转至登录认证画面,而是在游戏画面之外的新Window中打开登录认证画面的流程。建议基本上采用 Hybrid 流程。
用户在登录认证画面(新Window)中完成输入并通过验证后,登录认证画面的Window关闭,用户回到原来的游戏画面。
【流程的简要解说】
① 执行 getConnectedStatus ,确认游戏登录状态。
② 执行 Hybrid 流程,登录画面会新开选项卡。
③ 会显示 Mobage 的登录画面,输入ID / Password ,或进行新会员注册。
④ 会显示 NBPF 验证画面。触摸“游戏开始”,进入游戏安装完成状态。
⑤ 执行 getConnectedStatus ,进入游戏开始完成状态。
【选项】画面跳转登录的 Authorization Code Grant 流程
使用 Game Server ,按原来的方式进行画面跳转的流程。
用户从游戏画面跳转至登录认证画面,在登录认证画面中完成输入并通过验证后,页面跳转,返回至原来的游戏画面。
如果您使用 Authorization Code Grant 流程,那么您将不能使用 Shell App SDK。
如果您需要使用 Shell App SDK ,那么请您使用Hybrid 流程。
【选项】不使用 Game Server 直接登录的 Client-Side 流程
不使用 Game Server 的休闲游戏用流程。
不进行 Game Server 的登录会话管理,因此使用 Client-Side Storage 进行用户数据管理。
登录认证画面与 画面不跳转直接登录的流程 同样,在游戏画面之外打开新 Window 。
进入登录教程所需的事前准备
在本教程中,将介绍在实装登录样例代码的同时使用 Mobage JavaScript SDK的处理。
下载登录样例代码
登录样例代码可从 Github 克隆。
$ git clone https:``//github.com/DeNADev/mobage-jssdk-sample-login.git |
登录样例代码的安装目标
本登录样例代码由 PHP 文件组构成,复制到 PHP 的执行目录。
在本教程中,复制到 http://localhost/ 可确认动作的目录。
在 Mobage Developers Japan(开发者网站) 中注册应用软件
在 Mobage Developers Japan(开发者网站)中,进行应用软件的注册和设置。
请确认并执行以下详细内容。
-
设置 JavaScript SDK
在此进行以下设置。
JSONWebToken验证用程序库的设置
在公钥 X509 format 中,使用以下程序库。
https://github.com/F21/jwt
程序库配置如下
mobage-jssdk-sample-login/JWT/JWT.php |
使用SDK所需的常数设置
关于使用 Mobage JavaScript SDK 的所有程序所需的各种设置,
为实现通用而汇总的程序是 mobage-jssdk-sample-login/config.php 。
记载 BASE_URI 中不含路径的通信方式和主机名。("http://localhost"等)
如果样例放在默认目录以外,请在这里进行适当更改。
※在下文中使用“BASE_URI . $_SERVER['PHP_SELF']”的描述,应避免出错。
mobage-jssdk-sample-login/config.php
define(``'BASE_URI'``, 'http://localhost'```);` |
记载 Mobage Developers Japan(开发者网站) 发行的Client ID, Client Secret。
mobage-jssdk-sample-login/config.php
define(``'CLIENT_ID'``, 'YOUR_CLIENT_ID'``); define(``'CLIENT_SECRET'``, 'YOUR_CLIENT_SECRET'``); |
对 Client Secret值需要严加管理,以防外泄。
万一有外泄可能时,请从 Mobage Developers Japan(开发者网站) 的垂询窗口进行垂询。
记载 Developers Site 中提前注册的 Client URI, Redirect URI。
(在此注册与记载 Hybrid 流程使用的 RedirectURI 和 Authentication Code Grant 流程使用的 Redirect URI 这两项)
如果样例放在默认目录以外,请在这里进行适当更改。
mobage-jssdk-sample-login/config.php
define(``'CLIENT_URI'``, BASE_URI . '/mobage-jssdk-sample-login'``); define(``'REDIRECT_POST_ENDPOINT'``, CLIENT_URI . '/hybrid_flow/login_cb_post.php'``); define(``'REDIRECT_GET_ENDPOINT'``, CLIENT_URI . '/authorization_code_grant_flow/login_cb_get.php'``); |
变更履历
- 2015/12/14
- 添加对面向 Mobage 会员的开发注意事项的链接