ディープリンク経由の認証設定

ディープリンクは、ユーザーIDまたはエクソーラログイン経由での認証プロセスの代わりに、ゲームを通じてウェブショップでワンクリックで認証できるようになります。

ユーザーのモバイルデバイスにゲームがインストールされている場合、認証トークンを取得するために、ディープリンク経由でゲームにリダイレクトされます。

ユーザーフロー

モバイルアプリの場合

1. ウェブショップで未認証のユーザーがログインボタンまたは購入ボタンをクリックします。ユーザーIDを入力するか、モバイルゲームからログインするためのモーダルウィンドウが開きます。

2. ユーザーはゲームを通してログインボタンをクリックします。
3. ユーザーは、認証ユーザーとして自動的にウェブショップにリダイレクトされます。

デスクトップ版

1. ウェブショップで未認証のユーザーがログインボタンまたは購入ボタンをクリックします。ユーザーIDを入力するか、QRコードを使ってモバイル版ゲームにログインするためのモーダルウィンドウが開きます。

2. ユーザーはモバイルデバイスを使用してQRコードをスキャンすると、モバイルデバイスでウェブショップが開きます。
3. モバイル版のゲームは、ユーザーのモバイルデバイスで開きます。
4. ユーザーは、認証されたユーザーとして自動的にモバイルデバイス上のウェブショップにリダイレクトされます。

サービスインタラクションフロー

セットアップ方法

ゲーム側

1. ゲームのモバイルアプリ設定で、ディープリンク経由でゲームを開くためのURLスキームを新規登録してください：
   • Androidアプリ — AndroidManifest.xmlファイル
   • iOSアプリ — Info.plistファイル

• gamename — ユーザー認証のためにモバイルデバイスで開くゲーム名。
• authorize — ゲーム名のゲームが開いた後に実行されるアクション名の例。アプリケーションのオペレーティングシステムのアクションと一致するアクション名を使用してください。

<key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>gamename</string>
      </array>
    </dict>
  </array>

AndroidアプリケーションでURLスキームを登録する例：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="gamename" android:host="authorize" />
</intent-filter>

2. ゲームのユーザーIDを使用したJWT形式の認証トークンの生成を実装します。

curlを使用してユーザートークン生成APIメソッドを呼び出す例：

curl --location 'https://sb-user-id-service.xsolla.com/api/v1/user-id' \
--header 'Content-Type: application/json' \
--data '{
 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 "webhookUrl": "https://nowebhook.com",
 "settings": {
   "projectId": 123456,
   "merchantId": 123456
 },
 "user": {
   "id": "123",
   "name": "a-user-name"
 }
}'

{token=“JWT_TOKEN”}のような応答が返されます。

3. 認証成功の通知を含むポップアップウィンドウを追加します（任意）。
4. 取得したユーザートークンを使用して、「ブラウザでウェブショップを開く」を実装します。

認証されたユーザーがブラウザでウェブショップを開くためのURLを作成する例：

• https:​//example.com/?token={token}、カスタムドメインを使用する場合
• https:​//example.xsollasitebuilder.com/?token={token}、エクソーラドメインを使用する場合

サイトビルダー内

1. アドミンページであなたのプロジェクトを開きます。
2. サイドメニューで、「サイトビルダー」をクリックします。
3. ウェブショップサイトのカード上で、ユーザーID経由の認証が設定されている場合、「構成」をクリックしてください。
4. 「ログイン設定」に移動し、「ユーザーID」セクションを選択します。
5. 「ディープリンク認証」トグルを「オン」に設定します。

6. 「ディープリンクURL」フィールドに、ユーザー認証用のリンクを入力します。

7. サイトでファストログインブロックを使用する場合：
   1. ファストログインブロックに移動します。
   2. 「レイアウト」セクションで、「QRコード」トグルを「オン」にします。

8. 認証を確認するには、「プレビュー」をクリックしてください。
9. ウェブサイトを公開するには、「公開」をクリックします。