사용자 절차

1. 사용자 ID 인증을 구성한 경우 사용자가 웹샵 솔루션으로 이동합니다.
2. 사용자는 다음 중 한 가지 방식으로 웹샵 솔루션에서 인증을 수행합니다.
   • 사용자가 빠른 로그인 블록에 자신의 ID를 입력하고 로그인 버튼을 클릭합니다.
   • 사용자가 선택한 아이템의 구매 버튼 또는 상단 표시줄의 로그인 버튼을 클릭합니다.
     1. 사용자 ID 입력 또는 소셜 네트워크 로그인을 위한 모달 창이 열립니다.
     2. 사용자가 ID를 입력하고 계속을 클릭하거나, 소셜 네트워크 아이콘을 클릭하여 소셜 네트워크를 선택한 후 소셜 네트워크 페이지에서 인증을 완료합니다.

3. 시스템이 게임에 사용자가 존재하는지 확인합니다. 이 ID 또는 소셜 계정을 가진 사용자가 게임 내에 존재하면 해당 사용자는 웹샵 솔루션에서 인증됩니다. 그렇지 않은 경우에는 오류 메시지가 표시됩니다.

획득 방법

1. 애플리케이션 측에서 사용자 유효성 검사 웹훅 처리를 구현합니다.

웹훅 수신 시 애플리케이션에서 수행해야 하는 작업:

• 웹훅에 전달된 ID로 사용자 검색.
• 결과에 따라 다음 상태 코드 중 하나를 전송:
  • 사용자를 찾은 경우 웹훅의 응답이 포함된 200 HTTP 코드
  • 사용자를 찾을 수 없는 경우 404 HTTP 코드
• 사용자 맞춤 설정을 위해 사용자 특성 전송

2. 관리자 페이지에서 프로젝트를 엽니다.
3. 사이드 바에서 웹사이트 빌더를 클릭합니다.
4. 웹사이트 빌더 열기를 클릭합니다.
5. 로그인 설정 블록으로 이동합니다.

6. 사용자 ID 옵션을 선택합니다.

7. 드롭다운 목록에서 새 로그인을 선택합니다.

8. 웹훅을 수신할 URL 입력.

9. 애플리케이션에 이미 연결되어 있는 소셜 네트워크를 통한 인증 설정(선택 사항):
   1. 관리자 페이지에서 프로젝트를 열고 로그인 섹션으로 이동합니다.
   2. 사이트 표시줄에서 구성을 클릭합니다.
   3. 인증 블록으로 이동한 후 소셜 로그인을 선택합니다.

1. 4. 소셜 네트워크를 설정하려면 소셜 네트워크 카드로 이동하여 제목 오른쪽에 있는 ⚙ 아이콘을 클릭한 후 연결을 선택합니다.

딥 링크는 사용자를 애플리케이션이나 웹사이트의 메인 페이지가 아닌 특정 섹션, 페이지 또는 작업으로 바로 연결되는 특수한 URL입니다.

딥 링크는 사용자 ID를 통해 로그인 시 추가 인증 수단으로 사용할 수 있습니다. 사용자의 모바일 기기에 게임이 설치되어 있으면 인증 토큰을 받을 수 있도록 딥 링크를 통해 게임으로 리디렉션됩니다.

사용자 절차

모바일 앱에서

1. 웹샵에서 인증되지 않은 사용자가 로그인 버튼 또는 구매 버튼을 클릭합니다. 사용자 ID를 입력하거나 모바일 게임을 통해 로그인할 수 있는 모달 창이 열립니다.

2. 사용자가 모바일 게임을 통한 로그인 버튼을 클릭합니다.
3. 사용자는 게임으로 리디렉션된 후 인증된 사용자로서 웹샵으로 자동 돌아갑니다.

데스크톱 버전에서

1. 웹샵에서 인증되지 않은 사용자가 로그인 버튼 또는 구매 버튼을 클릭합니다. 사용자 ID를 입력하거나 QR 코드를 사용하여 모바일 버전의 게임에 로그인할 수 있는 모달 창이 열립니다.

2. 사용자가 모바일 기기를 사용하여 QR 코드를 스캔합니다.
3. 사용자의 모바일 기기에서 웹샵이 열립니다.
4. 사용자는 자동으로 게임으로 리디렉션된 다음 인증된 사용자로서 웹샵으로 다시 돌아갑니다.

서비스 상호작용 절차

설정 방법

게임에서

1. 게임의 모바일 앱 설정에서 딥링크를 통해 게임을 열 수 있는 URL 스키마를 등록합니다.
   • 안드로이드 애플리케이션의 경우 AndroidManifest.xml 파일에서
   • iOS 애플리케이션의 경우 Info.plist 파일에서

스키마를 등록한 후 사용자가 게임을 통해 웹샵에서 인증하면 지정된 주소에서 게임이 열립니다.

게임 등록을 위한 URL 스키마 예제:
gamename://authorize?operationPayload=<VALUE>, 여기에서:
• gamename - 사용자 인증을 위해 모바일 기기를 열어야 하는 게임 이름.
• authorize - 게임 이름 게임을 연후 수행해야 하는 동작 이름의 예제. 애플리케이션의 운영 체제의 동작과 일치하는 동작 이름을 사용합니다.
• operationPayload=<VALUE> - 인증하는 동안 토큰 생성에 대한 정보를 포함하는 추가 매개 변수.

예제:

• iOS 애플리케이션에 URL 스키마 등록하기
• Android 애플리케이션에 URL 스키마 등록하기

Copy

Full screen

Small screen

• xml

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

Copy

Full screen

Small screen

• xml

<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 -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"}과 같은 응답이 제공됩니다.

3. 인증 성공 알림이 있는 팝업 창을 추가합니다(선택 사항).
4. 획득한 사용자 토큰을 사용하여 브라우저에서 웹샵 열기를 구현합니다.

인증된 사용자를 위해 브라우저에서 웹샵을 열기 위한 URL 생성 예제: 사용자 지정 도메인을 사용하고 있는 경우
• https:​//example.com/?token={token}, 엑솔라 도메인을 사용하고 있는 경우
• https:​//example.xsolla.site/?token={token}

여기에서 {token}은 사용자의 인증 토큰입니다.

사이트 빌더 내에서

1. 관리자 페이지에서 프로젝트를 열고 사이트 빌더로 이동합니다.
2. 사용자 ID를 통한 인증으로 웹샵 사이트의 카드에서 구성을 클릭합니다.
3. 로그인 설정으로 이동하여 사용자 ID 섹션을 선택합니다.
4. 딥 링크 인증 토글을 활성화합니다.

5. Deeplink URL 필드에서 사용자 인증 링크를 입력합니다.

6. 사이트에서 빠른 로그인 블록을 사용하고 있는 경우:
   1. 빠른 로그인 블록으로 이동합니다.
   2. 레이아웃 섹션에서 QR 코드 토글을 활성화합니다.

7. 인증을 확인하려면 미리보기를 클릭하십시오.
8. 웹 사이트를 게시하려면 게시를 클릭하십시오.

딥 링크는 사용자를 애플리케이션이나 웹사이트의 메인 페이지가 아닌 특정 섹션, 페이지 또는 작업으로 바로 연결되는 특수한 URL입니다.

딥 링크를 사용하면 사용자 ID 또는 엑솔라 로그인을 통한 인증 프로세스를 거치지 않아도 클릭 한 번으로 게임에서 웹샵으로 인증할 수 있습니다.

사용자의 모바일 기기에 게임이 설치되어 있으면 인증 토큰을 받을 수 있도록 딥 링크를 통해 게임으로 리디렉션됩니다.

딥 링크를 기본 인증 수단으로 사용할 경우, 결제 정보를 저장할 수 있습니다. 이는 사용자 ID와 딥 링크를 통한 인증으로는 불가능합니다. 이 경우 딥 링크는 인증 속도를 높일 뿐 새로운 기능을 추가하지 않습니다.

사용자 절차

모바일 앱에서

1. 웹샵에서 인증되지 않은 사용자가 로그인 버튼 또는 구매 버튼을 클릭합니다. 모바일 게임을 통해 로그인할 수 있는 모달 창이 열립니다.

2. 사용자가 모바일 게임을 통한 로그인 버튼을 클릭합니다.
3. 사용자는 게임으로 리디렉션된 후 인증된 사용자로서 웹샵으로 자동 돌아갑니다.

데스크톱 버전에서

1. 웹샵에서 인증되지 않은 사용자가 로그인 버튼 또는 구매 버튼을 클릭합니다. QR 코드를 사용하여 모바일 버전의 게임에 로그인할 수 있는 모달 창이 열립니다.

2. 사용자가 모바일 기기를 사용하여 QR 코드를 스캔합니다.
3. 사용자의 모바일 기기에서 웹샵이 열립니다.
4. 사용자는 자동으로 게임으로 리디렉션된 다음 인증된 사용자로서 웹샵으로 다시 돌아갑니다.

서비스 상호작용 절차

설정 방법

게임에서

1. 게임의 모바일 앱 설정에서 딥링크를 통해 게임을 열 수 있는 URL 스키마를 등록합니다.
   • 안드로이드 애플리케이션의 경우 AndroidManifest.xml 파일에서
   • iOS 애플리케이션의 경우 Info.plist 파일에서

스키마를 등록한 후 사용자가 게임을 통해 웹샵에서 인증하면 지정된 주소에서 게임이 열립니다.

게임 등록을 위한 URL 스키마 예제:
gamename://authorize?operationPayload=<VALUE>, 여기에서:
• gamename - 사용자 인증을 위해 모바일 기기를 열어야 하는 게임 이름.
• authorize - 게임 이름 게임을 연후 수행해야 하는 동작 이름의 예제. 애플리케이션의 운영 체제의 동작과 일치하는 동작 이름을 사용합니다.
• operationPayload=<VALUE> - 인증하는 동안 토큰 생성에 대한 정보를 포함하는 추가 매개 변수.

예제:

• iOS 애플리케이션에 URL 스키마 등록하기
• Android 애플리케이션에 URL 스키마 등록하기

Copy

Full screen

Small screen

• xml

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

Copy

Full screen

Small screen

• xml

<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 형식의 인증 토큰 생성을 구현합니다.

엑솔라 API는 기본 인증을 사용합니다. 모든 API 요청에는 Authorization: Basic 헤더가 포함되어야 합니다. 여기에서, your_authorization_basic_key는 Base64 표준으로 인코딩된 client_id:client_secret 쌍입니다.

서버 인증을 위한 OAuth 2.0 클라이언트 설정은 관리자 페이지를 통해 수행됩니다. 자세한 절차는 문서를 참조하세요.

curl을 사용하여 사용자 토큰 생성 API 메서드를 호출하는 예제:

curl -X 'POST' \
'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
-H 'Accept: /' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic <Base64Encoded(client_id:client_secret)>' \
-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"}과 같은 응답이 제공됩니다.

3. 인증 성공 알림이 있는 팝업 창을 추가합니다(선택 사항).
4. 획득한 사용자 토큰을 사용하여 브라우저에서 웹샵 열기를 구현합니다.

인증된 사용자를 위해 브라우저에서 웹샵을 열기 위한 URL 생성 예제: 사용자 지정 도메인을 사용하고 있는 경우
• https:​//example.com/?token={token}, 엑솔라 도메인을 사용하고 있는 경우
• https:​//example.xsolla.site/?token={token}

여기에서 {token}은 사용자의 인증 토큰입니다.

사이트 빌더 내에서

1. 관리자 페이지에서 프로젝트를 열고 사이트 빌더로 이동합니다.
2. 웹샵 사이트 카드에서 구성을 클릭합니다.
3. 로그인 설정으로 이동하고 딥 링크 섹션을 선택합니다.

4. Deeplink URL 필드에서 사용자 인증 링크를 입력합니다.

5. 사이트에서 빠른 로그인 블록을 사용하고 있는 경우:
   1. 빠른 로그인 블록으로 이동합니다.
   2. 블록 설정에서 QR 코드 로그인 버튼에 대한 표시 스타일을 조정합니다.

6. 인증을 확인하려면 미리보기를 클릭하십시오.
7. 웹 사이트를 게시하려면 게시를 클릭하십시오.

사용자 절차

1. 엑솔라 로그인 인증을 구성한 경우 사용자는 웹샵 솔루션으로 이동합니다.
2. 사용자가 선택한 아이템의 구매 버튼, 상단 표시줄의 로그인 버튼 또는 빠른 로그인 블록의 로그인 버튼을 클릭합니다.
3. 엑솔라 로그인에서 설정한 인증 방식이 포함된 모달 창이 열립니다.

4. 사용자는 인증을 진행하고 필요한 경우 추가 데이터를 입력합니다.
5. 시스템이 게임에 사용자가 존재하는지 확인합니다. 사용자가 게임 내에 존재하면 해당 사용자는 웹샵 솔루션에서 인증됩니다. 그렇지 않은 경우에는 오류 메시지가 표시됩니다.

획득 방법

1. 사이트의 빌더에서 로그인 설정 블록으로 이동합니다.

2. 엑솔라 로그인 인증 옵션을 선택합니다.
3. 드롭다운 목록에서 신규 로그인을 선택합니다.

4. 모달 윈도우의 로그인 프로젝트 설정으로 이동하거나 인증 메소드 설정을 클릭합니다. 엑솔라 로그인 블록에 있습니다.

5. 사용자 데이터 저장소 연결.

사용자 데이터 저장 방법에 따라, 다양한 제품 기능을 사용할 수 있습니다 (사용자 데이터 스토리지 옵션 비교 참조).

엑솔라 저장소

로그인 제품이 모든 인증 로직을 처리하기를 원하는 경우, 엑솔라 저장소를 연결합니다. 더욱 유연한 설정이 가능합니다.

로그인 프로젝트를 만드는 경우, 엑솔라 스토리지가 기본값으로 연결되고, 구성하기 위해 추가 단계가 필요하지 않습니다. 기본 스토리지 유형을 변경하고 엑솔라 스토리지에 다시 연결해야 하는 경우, 다음 단계를 따릅니다:

1. 사용자 데이터베이스 블록으로 이동하여 스토리지 섹션을 선택합니다.
2. 엑솔라 스토리지를 선택하고 변경 사항 저장을 클릭합니다.

PlayFab 저장소

PlayFab 기능을 사용자 작업에 사용하려면 PlayFab 저장소를 연결합니다. 저장소가 저장하는 사용자 데이터:

• 사용자 이름
• 사용자 이메일 주소
• 사용자 암호
• 양식이 설정된 경우 확장된 등록 양식의 필드

PlayFab 저장소는 다음의 기능에 대한 접근 권한을 제공합니다:

• 사용자 등록
• 사용자 이메일 주소 또는 사용자 이름과 비밀번호를 통한 인증
• Twitch를 통한 인증
• 사용자 비밀번호 초기화
• 사용자 차단

저장소 연결 방법:

1. 사용자 데이터베이스 블록으로 이동해 스토리지 섹션을 선택합니다.
2. PlayFab을 선택합니다.
3. 타이틀 ID 필드에서, PlayFab 계정의 같은 필드 값을 입력합니다.
4. 변경 사항 저장을 클릭합니다.

Firebase 스 저장소

Firebase 기능을 사용자 작업에 사용하려면 Firebase 저장소를 연결합니다. 저장소가 저장하는 사용자 데이터:

• 사용자 이름
• 사용자 이메일 주소
• 사용자 암호
• 양식이 설정된 경우 확장된 등록 양식의 필드

1. 사용자 데이터베이스 블록으로 이동해 스토리지 섹션을 선택합니다.
2. Firebase를 선택합니다.
3. API 키 필드에서, Firebase 계정의 같은 필드 값을 입력합니다.
4. 변경 사항 저장을 클릭합니다.

사용자 정의 저장소

자체 권한 부여 시스템을 사용하고 귀하의 애플리케이션에 사용자 데이터를 저장하는 경우, 사용자 지정 저장소를 연결합니다.

사용자 지정 저장소는 다음 기능에 대한 액세스 권한을 제공합니다:

• 사용자 등록
• 사용자 이메일 주소 또는 사용자 이름과 비밀번호를 통한 인증
• 전화번호를 통한 암호 없는 인증
• 소셜 네트워크를 통한 인증
• 사용자 암호 초기화

1. 사용자 지정 저장소를 연결합니다.
2. 엑솔라 로그인 서버의 요청 처리를 설정합니다.

사용자 지정 저장소 연결

1. 사용자 데이터베이스 블록으로 이동해 스토리지 섹션을 선택합니다.
2. 사용자 지정 저장소를 선택합니다.
3. API 요청을 보낼 URL을 입력합니다:
   • 사용자 확인 URL
   • 신규 사용자 URL
   • 암호 재설정 URL
   • 전화 URL로 암호 없는 로그인
   • 소셜 로그인 URL
4. 변경 사항 저장을 클릭합니다.
5. 설정한 URL에 대해 다음과 같은 방식으로 반응하는 API를 실행합니다:
   • 성공적인 요청의 경우 HTTP 200 / HTTP 204. 추가 사용자 데이터를 포함하는 JSON은 필요한 경우 응답 본문에 위치할 수 있습니다. 전달된 데이터가 JWT에 기록됩니다 (partner_data 매개 변수).
   • 실패 요청에 대한 기타 HTTP 상태 코드.

엑솔라 로그인 서버의 요청 처리 설정

엑솔라 로그인 서버 요청은 관리자 페이지에서 지정한 URL로 Authorization: Bearer <JWT> 헤더와 전송됩니다. JWT는 프로젝트의 비밀 키로 서명됩니다.

요청 처리 방법:

1. 수신 JWT 검증.
2. 검증에 성공하면, JWT를 해독하고 아래 테이블로부터의 요청이 있는지 확인합니다. library를 찾아 해독에 사용합니다.

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}