PlayFab 저장소

PlayFab 저장소를 사용하는 경우, 다음 기능에 접근할 수 있습니다:

Note
PlayFab 메소드를 사용하여 사용자에게 추가 이메일을 보낼 수 있습니다.

상호작용 절차

로그인 위젯을 사용하거나 여러분의 애플리케이션을 클라이언트로 사용할 수 있습니다. 클라이언트와 엑솔라 로그인 서버간의 상호작용은 다음과 같습니다:

  1. 클라이언트는 엑솔라 로그인 서버로 요청을 보냅니다. 요청 양식은 JWT, OAuth 2.0, 및 Password 엔드포인트에 기술되어 있습니다.
  2. 엑솔라 로그인 서버는 PlayFab에 요청을 보냅니다.
  3. 엑솔라 로그인 서버는 PlayFab으로부터의 응답을 처리하고 클라이언트에 결과를 반환합니다.
  4. 클라이언트는 응답을 처리합니다.

PlayFab에서 사용자 등록

사용자 등록은 다음 절차를 따릅니다. 사용자 등록 완료를 위한 사용자 계정 확인 이메일 전송을 전송하는 것으로 설정할 수 있습니다.

사용자 등록 절차

  1. 클라이언트는 엑솔라 로그인 서버에 Register new user 요청을 보냅니다.
  2. 엑솔라 로그인 서버는 등록 요청을 보냅니다.
  3. 사용자 데이터는 엑솔라 데이터베이스에 기록됩니다.
  4. 엑솔라 로그인 서버는 PlayFab의 데이터 변경 요청을 보냅니다.
  5. 계정 확인을 설정한 경우:
    1. 솔루션 통합을 위해 API 호출를 사용하는 경우, 등록이 완료됩니다.
    2. 솔루션 통합에 로그인 위젯을 사용하는 경우, 사용자는 다음 메시지와 함께 페이지로 리디렉션 됩니다: 계정 확인 이메일이 {email address}로 발송되었습니다.
    계정 확인 기능을 설정하지 않는 경우, 사용자는 등록 이후 자동으로 로그인됩니다.

PlayFab에서 사용자 계정 확인

계정 확인 이메일 전송을 설정하려면, 다음 절차를 완료합니다:

  1. 지침을 따라 PlayFab에서 프로젝트를 설정합니다.
  2. Create an email templateCreate a rule to send an email when a contact email is updated 단계를 다음 Requirements 모듈에서 완료했는지 확인하세요.
  3. 계정 관리자에게 연락하기.

Note
PlayFab을 사용하는 프로젝트에 가입한 사용자는 이메일 주소 확인 없이 로그인할 수 있습니다.

사용자 이메일 주소와 암호를 통한 인증

사용자 이메일 주소와 비밀번호를 통한 인증에는 두 가지 유형이 있습니다. JWT 표준 기반 및 OAuth 2.0 프로토콜 기반 인증.

Note
엑솔라 스토리지에 사용자 데이터가 없는 경우:
  1. 사용자 데이터가 그곳에 기록됩니다.
  2. 엑솔라 로그인 서버는 PlayFab의 데이터 변경 요청을 보냅니다.

JWT 표준 기반 인증 흐름

  1. 클라이언트는 Auth by username and password 요청을 엑솔라 로그인 서버에 보냅니다.
  2. 엑솔라 로그인 서버는 인증 요청을 PlayFab에 보냅니다.
  3. 엑솔라 로그인 서버는 사용자 JWT를 생성하며:
    • PlayFab 요청에 대한 응답으로부터의 PlayFabId 값은 external_account_id 요구에 기록됩니다.
    • PlayFab 요청에 대한 응답으로부터의 SessionTicket 값은 session_ticket 요구에 기록됩니다.
    • PlayFab 요청에 대한 응답으로부터의 EntityToken 값은 entity_token, entity_id, entity_type 요구에 기록됩니다.
  4. 사용자는 login_url로 쿼리 매개변수 token과 함께 리디렉션됩니다. 사용자 JWT는 token 매개변수에 기록됩니다.

OAuth 2.0 프로토콜 기반 인증 흐름

  1. 클라이언트는 Auth by username and password 요청을 redirect_uri 매개변수와 함께 엑솔라 로그인 서버로 보냅니다.
  2. 엑솔라 로그인 서버는 인증 요청을 PlayFab에 보냅니다.
  3. 엑솔라 로그인 서버는 쿼리 매개변수에 login_url과 함께 code를 반환하며 redirect_uri를 전달합니다.
  4. 사용자는 redirect_uri로 쿼리 매개변수 code와 함께 리디렉션됩니다.
  5. 클라이언트는 Generate JWT 요청을 엑솔라 로그인 서버로 전송하여 수신한 사용자 JWT code를 교환합니다.
  6. 엑솔라 로그인 서버는 사용자 JWT를 생성하며:
    • PlayFab 요청에 대한 응답으로부터의 PlayFabId 값은 external_account_id 요구에 기록됩니다.
    • PlayFab 요청에 대한 응답으로부터의 SessionTicket 값은 session_ticket 요구에 기록될 수 있는데, 이는 scope=playfabAuth by username and password 요청에 전달한 경우에 한합니다.
    • PlayFab 요청에 대한 응답으로부터의 EntityToken 값은 entity_token, entity_id, entity_type 요구에 기록됩니다.

Twitch를 통한 인증

Twitch를 통해 사용자를 인증하려면 PlayFab에서 SNS를 설정해야 합니다. Twitch를 통한 인증에는 두 가지 유형이 있습니다. JWT 표준 기반 및 OAuth 2.0 프로토콜 기반 인증.

Note
PlayFab의 사용자 레코드가 Twitch 계정에 연결된 경우, 이는 하나의 계정으로 간주됩니다.

JWT 표준 기반 인증 흐름

  1. 클라이언트는 Auth via social network 요청을 엑솔라 로그인 서버로 보냅니다.
  2. 엑솔라 로그인 서버는 인증 요청을 PlayFab으로 보냅니다.
  3. 사용자 데이터는 엑솔라 데이터베이스에 기록됩니다.
  4. 엑솔라 로그인 서버는 사용자 JWT를 생성하며:
    • PlayFab 요청에 대한 응답으로부터의 PlayFabId 값은 external_account_id 요구에 기록됩니다.
    • PlayFab 요청에 대한 응답으로부터의 SessionTicket 값은 session_ticket 요구에 기록됩니다.
    • PlayFab 요청에 대한 응답으로부터의 EntityToken 값은 entity_token, entity_id, entity_type 요구에 기록됩니다.
  5. 사용자는 login_url로 쿼리 매개변수 token과 함께 리디렉션됩니다. 사용자 JWT는 token 매개변수에 기록됩니다.

OAuth 2.0 프로토콜 기반 인증 흐름

  1. 클라이언트는 Auth via social network 요청을 redirect_uri 매개변수와 함께 엑솔라 로그인 서버로 보냅니다.
  2. 엑솔라 로그인 서버는 인증 요청을 PlayFab으로 보냅니다.
  3. 사용자 데이터는 엑솔라 데이터베이스에 기록됩니다.
  4. 엑솔라 로그인 서버는 PlayFab에서의 데이터 변경 요청을 보냅니다.
  5. 사용자는 redirect_uri로 쿼리 매개변수 code와 함께 리디렉션됩니다.
  6. 클라이언트는 Generate JWT 요청을 엑솔라 로그인 서버로 보내어 수신한 사용자 JWT code를 교환합니다.
  7. 엑솔라 로그인 서버는 사용자 JWT를 생성하며:
    • PlayFab 요청에 대한 응답으로부터의 PlayFabId 값은 external_account_id 요구에 기록됩니다.
    • PlayFab 요청에 대한 응답으로부터의 SessionTicket 값은 session_ticket 요구에 기록될 수 있는데, 이는 scope=playfab를 Twitch 인증 요청에 전달한 경우에 한합니다.
    • PlayFab 요청에 대한 응답으로부터의 EntityToken 값은 entity_token, entity_id, entity_type 요구에 기록됩니다.

Twitch 인증 설정

  1. Twitch 계정을 생성하고 Twitch 클라이언트 ID를 받습니다.
  2. 게시자 계정에서 프로젝트를 엽니다.
  3. 사이드 메뉴에서 로그인을 클릭하고 로그인 프로젝트 > 로그인 프로젝트 > 소셜 연결로 이동합니다.
  4. Twitch 클라이언트 ID애플리케이션 ID 필드에 입력하여 Twitch.tv를 연결합니다.
  5. PlayFab 계정에서 Twitch를 설정하려면 지침을 따릅니다.
  6. 엑솔라 로그인을 API 호출로 통합한 경우:
    1. Twitch를 통한 인증 링크를 가져옵니다. 이를 위해 SNS 인증 호출을 사용합니다 (JWT 혹은 OAuth 2.0).
    2. 수신한 링크를 UI에 배치합니다.

사용자 암호 재설정

사용자 비밀번호 초기화 절차는 다음과 같습니다:

  1. 클라이언트가 엑솔라 로그인 서버에 Reset password 요청을 보냅니다.
  2. 엑솔라 로그인 서버는 비밀번호 초기화 요청을 PlayFab에 보냅니다.
  3. 갱신된 비밀번호가 PlayFab에 기록됩니다.

사용자 차단

게시자 계정을 통해 사용자를 차단할 수 있습니다. 차단된 사용자는 인증할 수 없습니다. 차단은 엑솔라 측에서만 기록 및 저장됩니다.

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!

계속 읽기

마지막 업데이트: 2021년 6월 25일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누릅니다.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!