원활한 인증을 활성화하는 방법

작동 방식

런처를 배포하는 웹사이트에 사용자가 로그인하면 런처 계정이 자동으로 로그인되며, 런처를 통해 웹사이트의 사용자 데이터를 게임으로 전송할 수 있습니다.

획득 방법

원활한 인증을 활성화하려면 다음을 구현합니다.

  1. 일회용 암호 검색
  2. 설치 프로그램 이름에 일회용 암호 추가
  3. 게임으로 전송된 사용자 데이터 처리(선택 사항)

일회용 암호 검색

일회용 암호 검색을 구현하는 방법:

  • 엑솔라 로그인을 사용하는 경우, https://launcher.xsolla.com/otp URL에 대한 POST 요청을 구현합니다. 요청 본문에서 다음 매개변수가 있는 JSON을 전달합니다.
    • refresh_token - 사용자 새로고침 토큰
    • access_token - 사용자 액세스 토큰
    • tracking_payload - 게임으로 전송해야 하는 사용자 데이터. 문자열의 최대 길이는 255자

알림
tracking_payload 매개변수를 사용할 경우 해당 값을 빈 칸으로 둘 수 없습니다.
주의
이 기능은 OAuth 2.0 인증을 연결한 경우에만 사용할 수 있습니다.

엑솔라 로그인을 사용하여 일회용 암호를 검색하는 요청의 예시:

Copy
Full screen
Small screen

    curl -X POST "https://launcher.xsolla.com/otp" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{  \"access_token\": \"string\",  \"refresh_token\": \"string\",  \"tracking_payload\": \"string\"}"

    • 엑솔라 로그인을 사용하지 않는 경우, 게임으로 전송해야 하는 사용자 데이터를 tracking_payload 쿼리 매개변수로 전송합니다. 문자열의 최대 길이는 255자입니다.

    엑솔라 로그인을 사용하지 않는 경우에 일회용 암호를 검색하는 요청의 예시:

    Copy
    Full screen
    Small screen

      curl
      -X POST
      "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>"
      -H
      "accept: application/json"
      -H
      "Content-Type: application/json"

      알림
      tracking_payload 매개변수를 사용할 경우 해당 값을 빈 칸으로 둘 수 없습니다.

      설치 프로그램 이름에 일회용 암호 추가하기

      수신된 일회용 암호는 UUID 형식의 36자 문자열입니다. LauncherName_<OTP>.exe와 같은 형식으로 다운로드할 때 설치 프로그램 파일 이름에 일회용 암호를 추가하도록 구현합니다. 여기서 <OTP>가 일회용 암호입니다.

      게임에서의 사용자 데이터 검색

      런처는 아래 예시와 같이 명령줄 인수 --xsolla-payload의 값으로 tracking_payload 매개변수로 수신한 데이터를 전달합니다.

      Copy
      Full screen
      Small screen

        curl -X POST "https://launcher.xsolla.com/otp" -H  "accept: application/json" -H  "Content-Type: application/json" -H "Authorization: <JWT>" -d "{  \"access_token\": \"string\",  \"refresh_token\": \"string\"}"

        알림
        런처는 게임이 시작될 때마다 사용자 데이터를 게임으로 전송합니다.
        이 기사가 도움이 되었나요?
        감사합니다!
        개선해야 할 점이 있을까요? 메시지
        유감입니다
        이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
        의견을 보내 주셔서 감사드립니다!
        메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
        이 페이지 평가
        이 페이지 평가
        개선해야 할 점이 있을까요?

        답하기 원하지 않습니다

        의견을 보내 주셔서 감사드립니다!
        마지막 업데이트: 2021년 2월 4일

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

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