[롤 시작 알림 서비스] - (2) 롤 계정으로 로그인, RSO(Riot Sign On) Client 신청하기

 

RSO Client 신청 과정을 소개하는 포스팅입니다. 

 

RSO 신청페이지 접속

'APPS' > 'MESSAGES' 에서 확인 가능합니다.

우선 RSO 기능을 이용하시려면, Production Key를 발급받으셔야 합니다. 
발급에 관한 내용은 이전 포스팅을 참고해 주세요.

 
 Production Key를 정상적으로 발급받으셨다면,

라이엇으로부터 위와 같이 RSO 통합 신청 관련 메시지를 받으실 수 있습니다.

첫 번째 링크를 클릭해 주세요.
 

 

 이제 여러분의 서비스를 등록해 주어야 합니다.

'Request App' 버튼을 클릭하면 등록에 필요한 정보들을 확인하실 수 있습니다.

 

RSO 통합을 위한 서비스 등록

여러분의 서비스와 RSO 기능을 통합하기 위한 제출 폼입니다. 양식을 요약하면 다음과 같습니다.

 

1. Application ID

- Production Key를 발급받으셨을때 제일 상단에 있는 App ID 6자리를 입력해주세요.

 

2. Client Name

- 여러분의 서비스명을 입력해 주세요. 앞으로 여러분의 서비스는 RSO를 통해 사용자의 Riot 계정 정보를 열람할 수 있는 써드파티 서비스가 됩니다. 여기서 사용자가 처음 로그인 요청을 할 때 정보 열람에 대한 동의를 구하게 되는데요. 이때, 사용자의 계정 정보를 제공받는 서비스가 어디인지를 명시하기 위해 Client Name이 사용됩니다.

 

2. Client Logo

- 여러분의 서비스 로고 이미지를 첨부해 주세요. 60x60 ~ 275x275 크기의 PNG 파일을 권장합니다.

 

3. Game Access

- RSO 기능을 통해 접근하고자 하는 게임을 선택해 주세요.

 

4. Privacy Policy URL

- 여러분의 서비스에 대한 개인 정보 처리 방침을 작성하여 사이트 내에 기재하고, 해당 페이지 링크를 적어 주세요.

 

5. Terms of Service URL

- 마찬가지로 서비스 이용약관 링크를 적어주세요.

 

 

6. Redirect URIs

- RSO로부터 로그인 요청이 완료되었을 때 리다이렉트할 URI를 적어주시면 됩니다. 그 전에 여러분이 배포한 서비스 URL에 대해 만족해야 할 몇 가지 조건이 있는데요. 아래 사진은 URL 유효성을 만족하지 않은 경우들의 예시 입니다.

 

마지막은 올바른 조건으로 등록한 URL입니다.

1. 리다이렉션 URI는 호스트 IP 주소를 포함할 수 없습니다. (AWS Route 53 같은 DNS 서비스로부터 도메인을 달아주셔야 합니다.)
2. 로컬 호스트를 포함할 수 없습니다. ex) localhost 또는 127.0.0.1
3. SSL 적용이 필요합니다.
4. 포트번호는 생략합니다.

  위의 조건들을 만족시키셨다면 위 사진에서 등록된 마지막 URL 형식이 될 텐데요. 여기에 리다이렉션되는 엔드 포인트를 포함하여 적어주시면 됩니다.

 

7. Post Logout Redirect URIs

- 마찬가지로 로그아웃 요청이 완료되었을 때 리다이렉트할 URI를 적어주시면 됩니다. 근데 RSO Docs를 까보면 로그아웃 API가 없습니다. 그래도 나중에 제공될 수도 있으니 일단 적어주세요. 그래서 현재까지는 사용자가 라이엇 홈페이지에 직접 들어가서 로그아웃 버튼을 누르는 것이 최선입니다.

 

로컬에서는 어떻게 테스트하나요?

 네이버 카카오랑은 달리, 라이엇은 localhost 등록이 안됩니다. 대신 이를 식별 가능한 다름 이름으로 바꿔주면 등록이 가능한데요. 여러분이 사용하시는 로컬 디바이스의 hosts 파일에서 설정하실 수 있습니다.

 

 이전에 수정 이력이 없다면, 현재 여러분의 서비스가 로컬에서 동작하는 IP(127.0.0.1)에는 localhost라는 도메인명이 매핑되어 있습니다. 이와 같은 방식으로 동일한 IP에 local.mydomain.com 같은 여러분만의 로컬 도메인명을 만들어 매핑해 주시면 됩니다. 보통은 여러분의 서버 도메인 앞에 local을 붙여줍니다.

 

 

Hosts 파일 수정하는 방법

우선 메모장을 관리자 권한으로 실행해 주세요.

hosts 파일을 수정하기 위해서는 관리자 권한이 필요합니다.

 

실행된 메모장 파일에서 '열기' 버튼을 클릭해 주세요.

 

 

설치 드라이브 > Windows > System32 > drivers > etc 경로로 들어간 다음,

하단에 '모든 파일' 항목을 클릭해 주면 위와 같은 파일 목록이 표시됩니다.

여기서 hosts 파일을 클릭하고 '열기' 버튼을 클릭해 주세요.

 

# Copyright (c) 1993-2009 Microsoft Corp.
#
# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
#
# This file contains the mappings of IP addresses to host names. Each
# entry should be kept on an individual line. The IP address should
# be placed in the first column followed by the corresponding host name.
# The IP address and the host name should be separated by at least one
# space.
#
# Additionally, comments (such as these) may be inserted on individual
# lines or following the machine name denoted by a '#' symbol.
#
# For example:
#
#      102.54.94.97     rhino.acme.com          # source server
#       38.25.63.10     x.acme.com              # x client host

# localhost name resolution is handled within DNS itself.
#	127.0.0.1       localhost
#	::1             localhost

127.0.0.1 local.mydomain.com

 

 파일을 열어보면 위와 같은 내용이 보이는데요. 이미 내부적으로 127.0.0.1에 localhost가 매핑된 것을 보실 수 있습니다. 이런 설정으로부터 평소에 localhost라는 도메인명을 사용할 수 있던 것입니다.

 

 이제 동일한 방식으로 파일 하단에 여러분이 로컬에서 사용할 도메인명을 추가하여 할당해 주세요. 할당될 IP는 동일하게 127.0.0.1을 사용하셔도 되고, 연결된 공유기의 IPv4 주소를 사용하셔도 됩니다. (둘 다 하셔도 됩니다.) 설정을 마치셨다면 저장을 눌러 저장된 내용을 꼭 확인해 주세요.

 

일반적으로 hosts 파일을 건드리는 것은 위험한 작업입니다.

hosts 파일을 잘못 변경하여 사용자를 의도치 않은 서버로 보낼 수 있기 때문입니다.

따라서 여러분이 새로 생성한 도메인과 ip 주소에 오탈자가 없는지 잘 확인하셔야 하고,

만약 hosts 파일에 주석 처리가 되어있지 않은 이상한 ip가 적혀있다면 지우셔야 합니다.

 

로컬 Redirect URI 등록하고 제출하기

 설정하신 로컬 도메인을 등록해 보시면 유효성 검사에 통과하실 수 있습니다.

이제 모든 내용을 등록하였으니 폼을 제출하시면 됩니다.

 

RSO 승인 여부는 제출일로부터 약 1주일 정도 소요되는데요. 그동안 RSO Docs를 공부하시면 됩니다.

 

 

RSO 신청 완료

 승인이 되셨다면 위와 같이 여러분의 Riot 계정에 등록된 메일로 Client ID를 받으실 수 있습니다.

 

Client ID는 RSO 기능 구현 시, 인증을 위해 사용됩니다.

 

 

다음 포스팅에서는 RSO 로그인 기능을 구현하는 방법에 대해 알아보겠습니다.

---