> ## Documentation Index
> Fetch the complete documentation index at: https://sequence-0fb8d9e6-6256-forte-config.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ユーザー認証
> Sequence インフラスタックを用いた web3 ゲーム向け Unreal SDK API のセッション管理に関するドキュメントです。
## 必要環境
* 必要なログイン方法を [Sequence Builder](https://sequence.build/) で有効にしていることを確認してください。
* [プラットフォーム要件](/sdk/unreal/advanced/platforms) ページで、選択した認証方法がUnrealプロジェクトで正しく設定されているかの詳細をご確認ください。
## メールログインの開始
任意のメールアドレスでユーザーをサインインさせると、ワンタイムパスワードが受信箱に届きます。
Email Requires Code イベントをリッスンしてください。
```cpp theme={null}
const TFunction OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartEmailLogin(Email, OnApiSuccess, OnApiFailure);
```
## メールログインのコード確認
任意のメールアドレスでユーザーをサインインさせると、ワンタイムパスワードが受信箱に届きます。
Email Requires Code イベントをリッスンしてください。
```cpp theme={null}
const FString Code = "123456";
const TFunction OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->ConfirmEmailLoginWithCode(Code, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
## ゲストとしてサインイン
ゲストとしてユーザーをサインインさせることができます。ただし、アプリをアンインストールまたはサインアウトするとウォレットへのアクセスが失われます。
ウォレットへのアクセスを維持するために、[アカウント連携機能](/sdk/unreal/onboarding/authentication#account-federation)を活用して、他のメールやソーシャルアカウントとウォレットを連携しましょう。
```cpp theme={null}
const TFunction OnApiSuccess = [] { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartGuestSession(OnApiSuccess, OnApiFailure);
```
## ソーシャルサインイン
デスクトップで SSO 認証を開始するには、必要な id\_token を取得するためにブラウザへ遷移する必要があります。
モバイルでは、統合プラグインを使って SDK がこの処理を自動で行います。
デスクトッププラットフォームでは、`Sign in Web View Required` イベントをリッスンし、返された `Sign In URL` を開いてください。
モバイルプラットフォームでは、`Id Token Received` イベントをリッスンしてください。
`Sign In` 関数を呼び出したら、`SequenceSessionsBP` サブシステムで `Session Established` イベントをリッスンし、サインインが成功したか確認します。問題が発生した場合は `Session Creation Failure` をリッスンしてください。
### Google Id トークンを取得
```cpp theme={null}
USequenceSessions* Sessions = NewObject();
if (Sessions->IsBrowserRequired)
const FString Url = this->Sessions->GetGoogleSignInUrl();
else
Sessions->GetGoogleTokenId(this);
```
### Apple Id トークンを取得
```cpp theme={null}
USequenceSessions* Sessions = NewObject();
if (Sessions->IsBrowserRequired)
const FString Url = this->Sessions->GetAppleSignInUrl();
else
Sessions->GetAppleTokenId(this);
```
### Google でサインイン
有効なGoogle Idトークンでサインインします。[Google Idトークンの取得方法](/sdk/unreal/onboarding/authentication#get-google-id-token)ノードをご参照ください。
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### Apple でサインイン
有効なApple Idトークンでサインインします。[Apple Idトークンの取得方法](/sdk/unreal/onboarding/authentication#get-apple-id-token)ノードをご参照ください。
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### Epic でサインイン
有効な Epic Games Id トークンでサインインします。[Unreal 用 EOS プラグイン](https://dev.epicgames.com/documentation/en-us/unreal-engine/online-subsystem-eos-plugin-in-unreal-engine) を参照してください。
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### OIDC Id トークンでセッション開始
Google、Apple、Epic Games から取得した有効な Id トークンを使ってセッションを開始する場合にこの方法を利用します。
```cpp theme={null}
const FString IdToken = "ey1234";
const TFunction OnApiSuccess = []() { };
const FFailureCallback OnApiFailure = [](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->StartOidcSession(IdToken, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
## PlayFab
[設定](/sdk/unreal/getting_started)時に `SequenceConfig.ini` ファイルへPlayFabタイトルIDを記載し、[BuilderでPlayFabの設定](/solutions/builder/embedded-wallet/playfab-configuration)も行ってください。
### PlayFab登録
```cpp theme={null}
const TFunction OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->PlayFabRegistration(UsernameIn, EmailIn, PasswordIn, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### PlayFabログイン
```cpp theme={null}
const TFunction OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->PlayFabLogin(UsernameIn, PasswordIn, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
### PlayFabセッションチケットによる認証
```cpp theme={null}
const TFunction OnApiSuccess = [this, OnSuccess]() { };
const FFailureCallback OnApiFailure = [this, OnFailure](const FSequenceError& Error) { };
const TFunction OnApiFederationRequired = [this](const FFederationSupportData& FederationData) { };
USequenceSessions* Sessions = NewObject();
Sessions->PlayFabAuthenticateWithSessionTicket(SessionTicket, OnApiSuccess, OnApiFailure, OnApiFederationRequired);
```
## アカウントフェデレーション
別のアカウントをウォレットに連携するには、同じ認証方法を再利用するだけです。
SDKは[既存のセッションが保存されているか](/sdk/unreal/onboarding/manage_sessions#check-existing-session)を確認し、自動的にそのアカウントとの連携を試みます。