ユーザー認証をセットアップする

認証されたユーザーは、ウェブショップで商品を購入したり、カタログでユニークなオファーを見ることができます。

認証付きウェブショップの主な機能:

  • ウェブショップでの複数の認証方法。
  • パーソナライズされたストアフロントと正規ユーザー用のプロモコードを設定することができます。
  • 個人情報の保護と処理に関する地域の法令を遵守します。
  • レート制限とDDoS対策。

以下の認証方法のいずれかを選択することができます:

  • ユーザーID認証
    • ウェブショップとゲームとの連携を簡略化します。
    • 認証ウィジェットには登録やパスワード入力は必要ありません。ユーザーは、ゲームからユーザーIDを入力するか、ゲームへのログインと同じソーシャルネットワークアカウントを使用する必要があります。

お知らせ
ゲームでエクソーラログインが設定されていない場合は、ユーザーID認証を使用します。
  • ユーザーIDとディープリンク認証
    • ディープリンクは、ユーザーIDでログインする際の追加の認証方法として使用できます。
    • ユーザーIDとディープリンク認証ウィジェットには、登録やパスワードの入力は必要ありません。ユーザーは、ゲームからユーザーIDを入力するか、ディープリンクを使用してゲーム経由でログインするだけです。
お知らせ
ゲームが認証用のディープリンクをサポートしている場合は、ユーザーIDとディープリンク認証を使用します。
  • ディープリンク認証
      ディープリンクを主なログイン方法として使用すると、ユーザーID認証では不可能な支払いの詳細を保存できます。
お知らせ
ゲームが認証のためにディープリンクをサポートしている場合は、ディープリンク認証を使用します。
  • エクソーラログインによる認証
    • 幅広い認証方法を提供します:ソーシャルネットワーク、ワンタイムコードやリンク、ログインとパスワード。
    • エクソーラログインウィジェットをカスタマイズできます。
    • 認証に年齢制限を課すことができます。
お知らせ
エクソーラログイン認証がすでに設定されている場合は、このソリューションを使用します。
いずれの認証方法でも、サイトにファストログインブロックを追加することができます。

ディープリンクとは、アプリケーションやウェブサイトのメインページだけでなく、特定のセクション、ページ、アクションに直接ユーザーを誘導する特別なURLのことです。

ディープリンクは、ユーザーIDでログインする際の追加の認証方法として使用できます。 ゲームがユーザーのモバイル端末にインストールされている場合、ディープリンクを介してゲームにリダイレクトされ、認証トークンが取得されます。

ユーザーフロー

  1. ウェブショップで未認証のユーザーがログインボタンまたは購入ボタンをクリックします。ユーザーIDを入力するか、モバイルゲームからログインするためのモーダルウィンドウが開きます。
  1. ユーザーは「モバイルゲームからログイン」ボタンをクリックします。
  2. ユーザーはゲームにリダイレクトされ、認証されたユーザーとして自動的にウェブショップに戻ります。

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

  1. ユーザーはモバイルデバイスを使用してQRコードをスキャンします。
  2. ウェブショップはユーザーのモバイル端末で開きます。
  3. ユーザーは自動的にゲームにリダイレクトされ、認証されたユーザーとしてウェブショップに戻ります。
  1. ゲームのモバイルアプリ設定で、ディープリンク経由でゲームを開くためのURLスキームを新規登録してください:
    • Androidアプリ — AndroidManifest.xmlファイル
    • iOSアプリ — Info.plistファイル

    スキームを登録した後、ユーザーがゲームを介してウェブショップで認証すると、ゲームは指定されたアドレスでゲームが開きます。

    ゲームを登録するためのURLスキームの例:
    gamename://authorize?operationPayload=<VALUE>、ここで:
    • gamename — ユーザー認証のためにモバイル端末で開く必要があるゲームの名前。
    • authorize — ゲーム名のゲームが開いた後に実行されるべきアクション名の例。アプリケーションのOSのアクションと一致するアクション名を使用します。
    • operationPayload=<VALUE> — 認証時にトークンを生成するための情報を含む追加パラメータ。

  1. 例:
Copy
Full screen
Small screen
<key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>gamename</string>
      </array>
    </dict>
  </array>

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

パラメータ種類説明文
loginId
stringアドミンページからの認証メソッドのID。必須
settings.projectId
stringブラウザのアドレスバーでプロジェクト名の横に指定されている、アドミンページで確認できるプロジェクトID。URLの形式は次のようになります:https://publisher.xsolla.com/<merchantId>/projects/<projectId>必須
settings.merchantId
stringパブリッシャーアカウントにあるマーチャントID。パブリッシャーアカウントの任意のページの会社設定 > 会社セクションまたはブラウザアドレスバーで指定されます。URLの形式は次のようになります:https://publisher.xsolla.com/<merchantId>/必須
user.id
stringゲーム内のユーザーID。必須
user.country
string2文字の国コードは、ISO 3166-1 alpha-2に従って使用されます。エクソーラがサポートしている国国の決定プロセスの詳細については、ドキュメンテーションを確認してください。必須
例:US
operationPayload
string認証時のトークン生成に関する情報を含む追加のパラメーターです。必須

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

    Copy
    Full screen
    Small screen
    curl -X 'POST' \
    'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
    -H 'accept: /' \
    -H 'Content-Type: application/json' \
    -d '{
     "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
     "settings": {
       "projectId": 123456,
       "merchantId": 123456
     },
     "user": {
       "id": "123",
       "country": "US"
     }
     "operationPayload": "kosarb2NyrtIWaegJAH1f6P7XrBYPXYDya5coc_ZzcfiS_5o4QTUAL-CcGRC_Kv4CAtg"
    }'
    

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

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

      認証されたユーザーがブラウザでウェブショップを開くためのURLを作成する例:
      • カスタムドメインを使用している場合はhttps:​//example.com/?token={token}
      • エクソーラドメインをしようしている場合はhttps:​//example.xsolla.site/?token={token}
      ここで、{token}はユーザーの認証トークンです。
    お知らせ
    まず、ユーザーIDによる認証を設定します。これは、ユーザーがディープリンク認証を利用できない場合、別の認証方法を提供するために必要です。例えば、ユーザーのモバイルデバイスにゲームがインストールされていない場合などです。
    1. パブリッシャーアカウントのプロジェクトを開き、サイトビルダーに移動します。
    2. ウェブショップサイトのカード上で、ユーザーID経由の認証が設定されている場合、「構成」をクリックしてください。
    3. ログイン設定」に移動し、「ユーザーID」セクションを選択します。
    4. ディープリンク認」トグルを有効にします。
    1. ディープリンクURL」フィールドに、ユーザー認証用のリンクを入力します。
    1. サイトで「ファストログイン」ブロックを使用している場合:
      1. ファストログインブロックに移動します。
      2. レイアウト」セクションで、「QRコード」トグルを有効にします。
    1. 認証を確認するには、「プレビュー」をクリックしてください。
    2. ウェブサイトを公開するには、「公開」をクリックします。

「ファストログイン」ブロックのセットアップ

ファストログインブロックは、ユーザーがサイト上で認証するための追加の方法を提供します。

ブロックの外観とその機能は、選択した認証方法によって異なります。

サイトにユーザーIDによる認証が構成されている場合、ファストログインブロックにはIDを入力するフィールドとログインボタンが表示されます。

機能:

  • モーダルウィンドウへの追加の遷移なしでのユーザー認証。
  • ブロックのコンテンツを設定します。以下のセクションを有効にして構成することができます:
    • タイトル
    • 説明
    • ユーザーIDの見つけ方
    • カスタム背景

また、JSコードを使って、テキストやボタン、画像を追加するなど、ブロックの機能を拡張することもできます。

サイトにエクソーラログインによる認証が設定されている場合、ファストログインブロックに認証を呼び出す追加のボタンが表示されます。ブロック内のボタンをクリックすると、「エクソーラログイン」メソッドのいずれかを使って認証するためのモーダルウィンドウが開きます。

機能:

  • 認証を求めるボタンのテキストを設定する
  • カスタム背景を設定する

また、JSコードを使って、テキストやボタン、画像を追加するなど、ブロックの機能を拡張することもできます。

新しいサイトの場合、ファストログインブロックはデフォルトでウェブショップテンプレートに追加されますが、必要に応じて削除できます。

先に作成したサイトにファストログインブロックがない場合は、追加することができます。

ファストログインブロックを追加するには:

  1. アドミンページであなたのプロジェクトを開きます。
  2. サイドメニューで、「サイトビルダー」をクリックします。
  3. サイト」セクションで、サイトを選択し、「サイトビルダーを開く」をクリックします。
  4. ブロックを追加」をクリックします。
  5. ファストログイン」ブロックを選択します。
お知らせ

ファストログインブロックを使用するには、「ログイン設定」セクションのドロップダウンリストから認証オプションを事前に選択する必要があります。

ログイン設定セクションのユーザーID認証方法では、ウェブフックを受信するためのURLも指定する必要があります。指定しない場合、ユーザー認証が利用できないため、サイトを公開できません。

サイトプレビュー中のユーザー認証は、ウェブフックURLを追加しなくても可能です。

次のステップ

  1. サンドボックスモードでウェブショップをテストします
  2. サイトを公開します

統合フロー

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2025年4月2日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!
フィードバックを送信できませんでした
後でもう一度お試しいただくか、doc_feedback@xsolla.comまでお問い合わせください。