OAuth 2.0 앱을 등록하면 Roblox 리소스에 액세스할 수 있습니다.등록 후 Roblox는 앱에 고유한 클라이언트 ID와 비밀을 할당하여 사용자로부터 자신의 Roblox 정보와 리소스에 대한 승인을 받을 수 있습니다.
앱 등록
앱을 등록하려면:
- 크리에이터 대시보드에서 OAuth 2.0 앱 페이지로 이동합니다.
- 클릭하십시오 OAuth 2.0 앱 생성 버튼.
- 유효하고 전역적으로 고유한 응용 프로그램 이름 을 입력하십시오.
- 읽고 동의하십시오 Roblox 서비스 약관 및 클릭하십시오 생성하기 .
- 클라이언트 ID 와 비밀 을 보안된 플레이스복사하고 저장하십시오.페이지를 닫은 후에는 비밀에 더 이상 액세스할 수 없으며 새로운 비밀만 생성할 수 있습니다.앱 등록을 완료한 후에도 앱의 다른 속성에 액세스하고 편집할 수 있습니다.
- 다음 섹션에 설명된 앱을 구성하려면 계속 편집 을 클릭하십시오.
일반 정보 구성
앱을 등록한 후에는 일반 정보를 포함하여 앱의 일반 정보를 구성해야 합니다.
- Roblox 커뮤니티의 모든 사람이 볼 수 있는 설명입니다.
- 앱에 대한 썸네일 이미지. 권장되는 파일 크기는 150x150픽셀 이상입니다.
- 앱의 입력 지점인 웹사이트 홈페이지와 같은 입력 링크 .
- 개발자가 앱을 승인하기 전에 최종 사용자가 읽을 개인정보 보호 조건 URL 과 서비스 조건 URL 입니다.각 URL은 HTTPS여야 하고 256자 이상일 수 없습니다.
권한 추가
앱 내에서 적절한 액세스 제어 및 보안을 보장하려면 권한 범위 를 추가해야 합니다.사용 가능한 권한 범위 유형은 두 가지입니다:
- ID 범위 사용자 ID에 대한 openid 및 전체 프로필에 대한 profile와 같은 인증을 위한.profile 범위를 선택하면 openid 도 선택해야 합니다.
- API별 권한 범위 , 예를 들어 자산의 읽기 권한에 대한 asset:read와 같은.앱에 필요한 최소 범위만 선택합니다.
리디렉션 URL 추가
리디렉션 URL 은 사용자가 앱 승인을 완료할 때 리디렉션되는 앱의 재입장 지점입니다.리디렉션 URL이 다음 요건을 충족하도록 하십시오:
- 모든 리디렉션 URL은 다음 형식 중 하나여야 합니다:
- 예를 들어 단순 HTTPS: https://www.example.com.
- 로컬 호스트에서 HTTP 또는 HTTPS(자체 서명 인증서)로 경로, 예를 들어:
- http://localhost:80
- https://localhost:80
- 특정 응용 프로그램이나 목적에 대한 사용자 지정 스키마, 예를 들어:
- my-app-scheme:/
- my-app-scheme://foo/bar/...
- my-app://action?param1=value1¶m2=value2
- 리디렉션 URL의 최대 길이는 256자입니다.
- 최대 10개의 리디렉션 URL을 추가할 수 있습니다.여러 개의 리디렉션 URL을 사용하면 테스트 환경을 갖추고 사용자가 중단 시간 없이 두 사이트 간에 마이그레이션할 수 있습니다.
검토를 위해 제출
악성 앱이 커뮤니티에 피해를 주는 것을 최소화하기 위해, 앱을 등록하면 널리 액세스할 수 없습니다.대신, 10명의 고유 사용자로 제한되는 개인 모드 에 남아 있습니다.이 모드는 팀 내에서 테스트 및 디버깅에 도움이 됩니다.
앱의 사용자 기반을 확장하려면 검토를 위해 제출하여 공개 모드로 게시해야 합니다.
- OAuth 2.0 앱 페이지로 이동합니다.
- 게시하려는 앱의 편집 및 게시 버튼을 클릭하십시오.
- 필요한 모든 정보를 입력하고 검토 및 게시 버튼을 클릭하십시오.보류 중인 검토 기간 동안 앱 권한에 제한이 있는 메시지가 나타납니다.
- 클릭 검토를 위해 제출 .
앱 검토가 보류 중인 동안 현재 검토 요청이 승인되거나 거부될 때까지 다른 요청을 편집하거나 제출할 수 없습니다.검토 중에 앱은 비공개 모드로 유지됩니다.앱이 승인되면 공개 모드로 전환되고 개인 모드로 되돌릴 수 없습니다.
앱이 승인되었든 거부되었든, 검토가 완료되면 결과에 대한 이메일 알림을 받습니다.
앱 편집 및 삭제
검토 중이 아니면 다음 단계로 앱을 편집하거나 삭제할 수 있습니다:
OAuth 2.0 앱 페이지로 이동합니다.
원하는 앱에 대해 편집 또는 삭제 를 클릭하십시오.
- 앱을 편집하기로 선택한 경우 등록의 동일한 단계와 요구 사항을 따르십시오.
- 앱을 삭제하기로 선택한 경우 예, 삭제 를 클릭하여 삭제를 확인하십시오. 앱을 삭제한 후에는 복구할 수 없습니다.
앱의 일반 정보나 리디렉션 URL을 수정하는 것은 사용자가 앱을 다시 승인할 필요가 없습니다.그러나 권한 범위를 추가하거나 수정하면 사용자로부터 새 권한에 대한 승인을 받아야 하고 새 토큰 집합을 획득해야 합니다.새 범위에 대한 승인을 얻지 않으면 앱은 기존 토큰을 계속 사용할 수 있지만 이전 범위에 제한됩니다.
비공개 모드의 앱에서는 시스템이 사용자와 편집 내용을 자동으로 업데이트합니다.공개 모드의 앱의 경우, 이러한 변경을 반영하기 위해 앱을 검토를 위해 다시 제출해야 합니다.그렇지 않으면 시스템은 커뮤니티에 출시하지 않고 게시되지 않은 변경 사항을 저장합니다.