애플리케이션 런처를 통한 인증

엑솔라 런처 또는 Steam을 사용해 사용자에게 애플리케이션을 전달하는 경우, 런처의 자격 증명을 통해 사용자를 자동으로 인증할 수 있습니다.

방법

저희가 제공하는 방법 안내서에서 고급 설정에 대해 자세히 알아보세요.

런처를 통해 애플리케이션에서 권한 부여 설정 방법

엑솔라 런처를 사용하여 여러분의 애플리케이션을 사용자에게 전달하고 업데이트할 수 있습니다. 런처는 인증 도구를 내장하고 있습니다. 사용자 이름과 비밀번호의 재입력을 피하기 위하여 런처를 통하여 여러분 애플리케이션에서 인증하도록 설정하세요.

주의
런처를 사용하려면 로그인을 구현해야 합니다. 다른 권한 부여 시스템을 사용하는 것은 지원되지 않습니다.

함께 작업하기 위한 SDK와 런처를 설정

  1. 런처 설정은 게시자 계정에서 합니다.

알림
config.json 파일에서, 다음 객체의 값을 바꾸는 것으로 충분합니다.
  • launcher_project_id런처 ID게시자 계정 > 런처 > 일반 설정 > 일반 정보에서 명시하며
  • login_project_id로그인 ID게시자 계정 > 런처 > 일반 설정 > 인증에서 명시합니다

  1. 런처 UI 맞춤 설정.

주의
엑솔라 서버와 SDK 통합은 Commerce API 호출이 사용하므로 런처 스토어는 지원되지 않습니다.

  1. 런처 권한 부여 로직을 귀하의 애플리케이션에서 구현합니다.
  2. 런처 설치 파일 및 빌드 아카이브를 생성합니다.
  3. 애플리케이션 빌드를 생성합니다.
  4. 엑솔라 업데이트 서버에 애플리케이션 빌드를 업로드합니다.

런처를 통한 권한 부여 논리 구현

런처를 통한 애플리케이션의 권한 부여 절차:

  1. 사용자가 런처에서 권한 부여를 받습니다.
  2. 사용자가 애플리케이션을 설치하고 실행합니다.
  3. 런처가 애플리케이션을 실행하고 사용자 매개 변수를 명령 줄을 통해 전달합니다. 권한 부여 토큰이 xsolla-login-token 매개 변수에서 전달됩니다.
  4. 애플리케이션이 명령 줄 매개 변수를 처리하고 토큰을 얻습니다.
  5. 애플리케이션이 받은 토큰의 유효성을 검사합니다.
  6. 애플리케이션이 권한 부여 페이지를 표시하지 않고 자동으로 사용자에게 권한을 부여합니다.

이 논리의 구현 예시는 데모 프로젝트 W_LoginDemo 청사진에서 이용할 수 있습니다.

알림
SDK 메서드가 얻은 토큰을 사용하여 인게임 스토어 열기, 결체 처리 등을 합니다.

애플리케이션 빌드 만들기

  1. 언리얼 엔진 프로젝트로 이동합니다.
  2. Content Browser에서 사용자 권한 부여 맵을 여는데, 이는 토큰이 처리되고 있는 곳입니다.
  3. 메인 메뉴에서 Edit > Project Settings으로 이동합니다.
  4. Project> Maps & Modes로 이동한 다음 Game Default Map 필드에서 전에 열었던 권한 부여 맵을 선택합니다.

  1. Plugins > Xsolla Login로 이동.
  2. Project ID 필드에서, 프로젝트 ID를 명기하는데 이는 게시자 계정 > 프로젝트 설정 > 프로젝트 ID에 있습니다.
  3. Login ID 필드에서, 로그인 ID를 명기하는데, 이는 게시자 계정 > 런처 > 일반 설정 > 인증에 있습니다.
  4. 여러분이 빌드를 생성하는 플랫폼에 따라 메인 메뉴의 File > Package Project > Windows (64 bit)혹은 File > Package Project > Mac로 이동합니다.
  5. 팝업 창에서, 최종 빌드가 저장될 디렉토리의 경로를 지정합니다.

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

Steam을 통한 네이티브 인증 설정 방법

설치된 Steam 클라이언트를 거쳐 네이티브 인증을 통해 플레이어가 여러분의 애플리케이션에 진입할 수 있습니다. Steam을 통해 네이티브 인증을 설정한 후 또한 Steam을 거쳐 애플리케이션에 결제를 추가할 수 있습니다.

네이티브 인증 설정 방법:

  1. 게시자 계정에서 Steam을 통한 암묵 인증 설정.
  2. 언리얼 엔진 프로젝트 구성.
  3. 이벤트 처리 구성.
  4. Steam을 통한 인증 확인.

내 언리얼 엔진 프로젝트 구성하기

  1. 내 언리얼 엔진 프로젝트의 Config 카탈로그로 이동합니다.
  2. DefaultEngine.ini 파일 아래에 줄을 추가하고 SteamDevAppId 매개변수에 대해 Steam의 내 앱 ID를 지정합니다.

Copy
Full screen
Small screen
    [/Script/Engine.GameEngine]
    +NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="OnlineSubsystemSteam.SteamNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")
    
    [OnlineSubsystem]
    DefaultPlatformService=Steam
    
    [OnlineSubsystemSteam]
    bEnabled=true
    SteamDevAppId=480
    
    [/Script/OnlineSubsystemSteam.SteamNetDriver]
    NetConnectionClassName="OnlineSubsystemSteam.SteamNetConnection"

    1. 언리얼 에디터에서 프로젝트를 엽니다.
    2. Settings > Plugins > Online Platform으로 이동합니다.
    3. Online Subsystem Steam 모듈에서 Enabled 박스에 체크를 하고 Restart Now 버튼을 눌러 설정을 저장한 다음 언리얼 에디터를 다시 로드합니다.

    이벤트 처리 구성하기

    1. 아래 이미지에 프로젝트에 노드 추가 방법이 있습니다.

      Steam을 통해 사용자를 인증하려면, session ticketGetSessionTicket 메소드를 통해 받아야 합니다. 받은 값은 AuthenticateWithSessionTicket 메소드 호출 시 전달합니다. 그 결과로, API호출 시 쓰이는 토큰을 얻게 됩니다.

    1. 추가적인 토큰 검증을 위해, ValidateToken 메소드 콜백을 추가합니다 (선택 사항).

    Steam을 통한 인증 확인

    1. 단독 플랫폼을 위한 언리얼 엔진 프로젝트 빌드 생성.
    2. Steam 실행 후 로그인.
    3. 내 애플리케이션 실행. 모든 것이 정상이면 Steam 팝업 창이 나타납니다.

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

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

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