SDK는 소셜 로그인에 다음 공급 업체를 지원합니다:

• Amazon
• Apple
• Baidu
• Battle.net
• Discord
• Facebook
• GitHub
• Google
• Kakao
• LinkedIn
• MSN
• Mail.ru
• Microsoft
• Naver
• Odnoklassniki
• PayPal
• QQ
• Reddit
• Steam
• Twitch.tv
• Twitter
• VK
• Vimeo
• WeChat
• Weibo
• Xbox Live
• Yahoo
• Yandex
• YouTube

웹 서비스를 통한 인증 설정 방법:

1. 애플리케이션 인터페이스에서 소셜 네트워크를 통한 인증에 사용할 버튼을 추가합니다.
2. 게시자 계정에서 로그인 프로젝트에서 사용할 소셜 연결을 설정합니다.
3. 애플리케이션 측에서 인증 로직을 구현합니다.

엑솔라 관리자 페이지에서 로그인 프로젝트용 SNS 설정

1. 게시자 계정에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 로그인을 클릭합니다.
3. 로그인 프로젝트의 패널에서 구성을 클릭합니다.
4. 탐색 페이지에서 인증 블록으로 이동한 후 소셜 로그인 섹션을 선택합니다.

5. 사용자가 애플리케이션에 등록하고 로그인할 때 사용할 수 있는 소셜 네트워크를 연결합니다.

1. • SNS를 연결하려면, 패널에 있는 ⚙을 클릭하고 연결을 선택합니다.

1. • 여러 개의 소셜 네트워크를 동시에 연결하려면, 필요한 패널을 선택합니다(테두리가 녹색으로 변합니다). 그런 다음, 관리 드롭다운 메뉴에서 연결을 선택합니다.

1. • 사용 가능한 소셜 네트워크를 모두 연결하려면 모두 선택을 클릭합니다. 그런 다음, 관리 드롭 다운 메뉴에서, 연결을 선택합니다.

애플리케이션 측에서 통합하기

소셜 로그인 버튼을 클릭하면 다음 로직을 구현합니다.

1. 데스크톱 애플리케이션의 경우:
   1. GetSocialNetworkAuthUrl SDK 메소드를 사용하여 등록/로그인 페이지 URL를 가져옵니다.
   2. BrowserHelper.Instance.InAppBrowser 메소드를 사용하여 브라우저에서 등록/로그인 페이지를 엽니다.
   3. URL 변경 이벤트를 구독합니다. 이렇게 하려면 BrowserHelper.Instance.InAppBrowser.AddUrlChangeHandler(OnUrlChanged) 콜백을 추가합니다.
   4. 사용자 인증에 성공한 후 페이지 URL 변경 사항을 추적합니다.
   5. 활성 페이지의 URL에서 인증 코드를 가져옵니다. ParseUtils.TryGetValueFromUrl() SDK 도우미 메소드를 사용하여 이 작업을 수행할 수 있습니다.
   6. ExchangeCodeToToken SDK 메소드를 사용하여 인증 코드를 토큰으로 교환하고 이를 엑솔라 서버에 대한 요청에 사용합니다.

2. Android 애플리케이션의 경우:
   1. AndroidSDKSocialAuthHelper 클래스의 개체를 생성합니다.
   2. PerformSocialAuth 메소드를 호출한 후 메소드에 다음 매개변수를 전달합니다.
      • SocialProvider - 소셜 네트워크의 이름
      • onSuccess - 성공적인 사용자 인증 콜백
      • onCancelled - 사용자의 인증 콜백 취소
      • onError - 오류 콜백
   3. onSuccess 콜백이 token 매개변수에서 반환하는 토큰을 가져와 엑솔라 서버에 대한 요청에 사용합니다.

4. iOS 애플리케이션의 경우:
   1. IosSDKSocialAuthHelper 클래스의 개체를 생성합니다.
   2. PerformSocialAuth 메소드를 호출한 후 메소드에 다음 매개변수를 전달합니다.
      • SocialProvider - 소셜 네트워크의 이름
      • onSuccess - 성공적인 사용자 인증 콜백
      • onCancelled - 사용자의 인증 콜백 취소
      • onError - 오류 콜백
   3. onSuccess 콜백이 LoginOAuthJsonResponse 개체의 access_token 필드에서 반환하는 토큰을 가져와 엑솔라 서버에 대한 요청에 사용합니다.

기본 인증은 모바일 기기에서 구성된 SNS 계정을 통해 사용자가 여러분의 애플리케이션에 로그인할 수 있게 합니다.

사용자가 처음 로그인하면, SNS 애플리케이션은 실행된 다음 사용자 인증 권한을 요청합니다. 그후에는 인증이 자동으로 사용자에게 아무것도 요구하지 않고 자동으로 수행됩니다.

현재 SDK가 다음 SNS를 통한 기본 인증을 구현했습니다.

• Google
• Facebook
• WeChat
• QQ

기본 인증 구성 방법:

1. 애플리케이션 인터페이스에서 소셜 네트워크를 통한 인증에 사용할 버튼을 추가합니다.
2. Android용 Unity 프로젝트 빌드를 생성합니다.
3. 개발자 계정에서 SNS용 애플리케이션 구성 방법:
   1. Facebook을 통한 인증:
      1. 등록하고 새 애플리케이션을 만듭니다.
      2. Facebook 개발자 계정에서 애플리케이션 페이지를 설정합니다.
   2. Google을 통한 인증은 Google API 콘솔에서 프로젝트를 설정합니다.
   3. WeChat을 통한 인증:
      1. 등록하고 새 애플리케이션을 만듭니다.
      2. 검토용 애플리케이션을 제출합니다.
   4. QQ를 통한 인증:
      1. 등록하고 새 애플리케이션을 만듭니다.
      2. 검토용 애플리케이션을 제출합니다.

3. 엑솔라 측에서 SNS를 통한 인증 설정 방법:
   1. Facebook 및 Google은 게시자 계정에서 SNS 연결을 설정합니다.
   2. WeChat 및 QQ는 계정 관리자에게 문의합니다.
4. Unity 프로젝트용 자산을 설정합니다.
5. 애플리케이션 측에서 인증 로직을 구현합니다.

Android용 Unity 프로젝트 빌드 생성

1. Unity 프로젝트로 이동합니다.
2. 메인 메뉴에서 File > Build settings를 클릭합니다.
3. Platform 패널에서 Android를 클릭합니다.
4. Build를 클릭합니다.

추가 기본 인증 구성을 하려면 다음이 필요합니다.

• File > Build settings에서 Android 플랫폼을 선택한 후 Inspector 패널의 Package Name 필드에서 확인할 수 있는 패키지 이름.
• Android 클래스 이름 — 애플리케이션 네임스페이스를 포함한 메인 활동의 클래스 이름(예: com.domain.appname.activity). AndroidManifest.xml에서 확인할 수 있는 클래스 이름. 메인 활동의 태그에는 android.intent.action.MAIN 작업과 android.intent.category.LAUNCHER 카테고리 정보가 포함된 intent-filter 태그가 포함되어 있어야 합니다.
• Android 해시 키. OpenSSL을 사용하여 가져올 수 잇습니다.

Facebook 개발자 계정의 어플리케이션 페이지 설정

1. Facebook 개발자 계정의 프로젝트 설정으로 이동합니다.
2. 설정 > 기본으로 이동합니다.
3. 플랫폼 추가를 클릭하고 Android를 선택합니다.
4. 패키지 이름을 Google Play 패키지 이름 필드의 Unity 프로젝트에서 지정합니다.
5. Android 클래스 이름을 클래스 이름 필드의 Unity 프로젝트에서 지정합니다.
6. Android 디버그 해시 키를 키 해시 필드의 Unity 프로젝트에서 지정합니다.
7. 변경 사항 저장을 클릭합니다.

추가 고유 인증 구성을 위해서는 설정 > 기본 섹션의 프로젝트 설정에 있는 앱 ID와 앱 시크릿 코드가 필요합니다.

Google API 콘솔에서 프로젝트 설정

1. Google API 콘솔로 이동합니다.
2. 새 프로젝트를 클릭합니다.
3. 프로젝트 이름과 위치를 지정하고 저장을 클릭합니다.
4. 만든 프로젝트로 이동하여 OAuth 동의 화면을 측면 메뉴에서 클릭합니다.
5. 외부 옵션을 선택하고 생성을 클릭합니다.
6. 필요한 매개 변수를 지정하고 저장을 클릭합니다.
7. 측면 메뉴에서 자격 증명을 클릭합니다.
8. Unity 애플리케이션용 OAuth 2.0 클라이언트 생성 방법:

1. 1. 자격 생성을 클릭한 후 OAuth 클라이언트 ID를 선택합니다.
   2. 애플리케이션 유형 필드에서 Android를 지정합니다.
   3. 이름을 지정합니다.
   4. 패키지 이름 필드의 Unity 프로젝트에서 패키지 이름을 지정합니다.
   5. SHA-1 인증 지문 필드의 Unity 프로젝트에서 Android 해시 키를 지정합니다.
   6. 생성을 클릭합니다.
   7. 확인을 클릭합니다.

9. 웹 애플리케이션용 OAuth 2.0 클라이언트 생성 방법:
   1. 자격 증명 생성을 클릭하고 OAuth 클라이언트 ID를 선택합니다.
   2. 웹 애플리케이션을 애플리케이션 유형 필드에서 지정합니다.
   3. 이름을 지정합니다.
   4. URI 추가를 권한이 부여된 리디렉션 URI 섹션에서 클릭하고 https://login.xsolla.com/api/social/oauth2/callback URI을 지정합니다.
   5. 생성을 클릭합니다.
   6. 확인을 클릭합니다.

추가 고유 인증 구성을 위해서는 웹 어플리케이션의 클라이언트 ID 설정에서 Client ID와 Client Secret가 필요합니다.

엑솔라 관리자 페이지에서 로그인 프로젝트용 SNS 설정

1. 게시자 계정에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 로그인을 클릭합니다.
3. 로그인 프로젝트의 패널에서 구성을 클릭합니다.
4. 탐색 페이지에서 인증 블록으로 이동한 후 소셜 로그인 섹션을 선택합니다.

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

Unity 프로젝트에 대한 자산 설정

1. Unity 프로젝트로 이동합니다.
2. Window > Xsolla > Edit Settings를 메인 메뉴에서 클릭합니다.
3. 애플리케이션 ID 지정:
   1. Facebook App ID 필드의 Facebook 개발자 계정에서 앱 ID를 지정합니다.
   2. Google server ID 필드의 Google API 콘솔에서 웹 애플리케이션용 클라이언트 ID를 지정합니다.
   3. WeChat App ID 필드의 WeChat 애플리케이션 설정에서 AppID를 지정합니다.
   4. QQ App ID 필드의 QQ 애플리케이션 설정에서 AppID를 지정합니다.

애플리케이션 측에서 통합하기

소셜 로그인 버튼을 클릭하면 다음 로직을 구현합니다.

• Android 애플리케이션의 경우 AndroidSDKSocialAuthHelper 인스턴스를 생성하고 PerformSocialAuth 메소드를 호출합니다. 구현 예시는 데모 프로젝트의 Assets/Xsolla.Demo/Login/Scripts/Login/Auth/AndroidSocialAuth.cs 스크립트에서 제공됩니다.

• iOS 애플리케이션의 경우 IosSDKSocialAuthHelper 인스턴스를 생성하고 PerformSocialAuth 메소드를 호출합니다. 구현 예시는 데모 프로젝트의 Assets/Xsolla.Demo/Login/Scripts/Login/Auth/IosSocialAuth.cs 스크립트에서 제공됩니다.