OAuth 2.0 앱 등록

당신의 OAuth 2.0 앱을 등록하면 Roblox 리소스에 접근할 수 있습니다. 등록 후, Roblox는 앱에 고유한 클라이언트 ID와 비밀을 할당하며, 이를 통해 사용자에게서 Roblox 정보와 리소스에 접근하기 위한 권한을 얻을 수 있습니다.

앱 등록하기

앱을 등록하려면:

1. Creator Dashboard로 가서 OAuth 2.0 Apps 페이지로 이동합니다.
2. 앱 생성 버튼을 클릭합니다.
3. 유효하고 전 세계적으로 고유한 애플리케이션 이름을 입력합니다.
4. Roblox 서비스 이용 약관을 읽고 동의한 후 생성을 클릭합니다.
5. 클라이언트 ID와 비밀을 안전한 장소에 복사하여 저장합니다. 페이지를 닫은 후에는 비밀에 접근할 수 없으며, 새로 생성할 수 있습니다. 앱 등록을 마친 후에도 앱의 다른 속성에 접근하고 수정할 수 있습니다.
6. 편집 계속하기를 클릭하여 앱을 구성합니다. 이는 다음 섹션에서 설명합니다.

일반 정보 구성하기

앱을 등록한 후 일반 정보를 구성해야 합니다. 여기에는 다음이 포함됩니다:

• Roblox 커뮤니티의 모든 사람이 볼 수 있는 설명입니다.
• 앱을 위한 썸네일 이미지입니다. 추천 파일 크기는 최소 150x150 픽셀입니다.
• 앱의 진입 지점으로서 진입 링크입니다. 예를 들어 앱의 웹사이트 홈페이지를 입력합니다.
• 최종 사용자가 앱에 대한 권한을 부여하기 전에 읽을 수 있는 개인정보 보호 약관 URL과 서비스 약관 URL입니다. 각 URL은 HTTPS 형식이어야 하며 최대 256자여야 합니다.

권한 추가하기

앱 내에서 적절한 접근 제어 및 보안을 보장하기 위해 권한 범위를 추가해야 합니다. 사용 가능한 두 가지 유형의 권한 범위가 있습니다:

• openid와 같이 사용자 ID에 대한 인증을 위한 신원 범위 및 전체 프로필에 대한 profile입니다. profile 범위를 선택하면 openid도 선택해야 합니다.
• 자산의 읽기 권한에 대한 asset:read와 같은 API 특정 권한 범위입니다. 앱에 필요한 최소한의 범위만 선택하십시오.

리디렉션 URL 추가하기

리디렉션 URL은 사용자가 앱 권한 부여를 완료했을 때 리디렉션되는 앱의 재진입 포인트입니다. 리디렉션 URL은 다음 요구 사항을 충족해야 합니다:

• 모든 리디렉션 URL은 다음 형식 중 하나여야 합니다:

  • 일반 HTTPS, 예: https://www.example.com.`
  • 로컬 디버깅 목적으로 HTTP 또는 HTTPS(자체 서명된 인증서)인 localhost의 경로, 예:

    • `http://localhost:80``
    • `https://localhost:80``
  • 특정 애플리케이션 또는 목적을 위한 사용자 지정 스킴, 예:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• 리디렉션 URL의 최대 길이는 256자입니다.
• 최대 10개의 리디렉션 URL을 추가할 수 있습니다. 여러 리디렉션 URL을 통해 테스트 환경을 만들고 사용자들이 두 사이트 간에 다운타임 없이 이동할 수 있도록 할 수 있습니다.

검토 제출하기

악의적인 앱이 커뮤니티에 피해를 주는 가능성을 최소화하기 위해, 앱 등록은 광범위하게 접근할 수 있게 하지 않습니다. 대신, 앱은 비공개 모드로 유지되며, 10명의 고유 사용자로 제한됩니다. 이 모드는 팀 내에서 테스트 및 디버깅에 유용합니다.

앱의 사용자 기반을 확장하려면 공개 모드로 게시해야 하며, 이를 위해 검토를 제출해야 합니다:

1. OAuth 2.0 apps 페이지로 이동합니다.
2. 게시하려는 앱에 대한 편집 및 게시 버튼을 클릭합니다.
3. 모든 필수 정보를 기입하고 검토 및 게시 버튼을 클릭합니다. 대기 중인 검토 기간 동안 앱 권한에 대한 제한이 포함된 메시지가 나타납니다.
4. 검토 제출을 클릭합니다.

앱 검토가 대기 중일 때는 현재 검토 요청이 승인되거나 거부될 때까지 다른 요청을 편집하거나 제출할 수 없습니다. 검토 동안 앱은 비공개 모드로 유지됩니다. 앱이 승인되면 공개 모드로 전환되며, 다시 비공식 모드로 되돌릴 수 없습니다.

앱이 승인되거나 거부 여부에 관계없이 검토가 완료되면 결과를 알리는 이메일을 받습니다.

앱 편집 및 삭제하기

앱이 검토 중이지 않으면 아래 단계를 따라 앱을 편집하거나 삭제할 수 있습니다:

1. OAuth 2.0 apps 페이지로 이동합니다.

2. 원하는 앱에 대해 편집 또는 삭제를 클릭합니다.

   • 앱 편집을 선택한 경우 등록의 동일한 단계와 요구 사항을 따릅니다.
   • 앱 삭제를 선택한 경우 예, 삭제를 클릭하여 삭제를 확인합니다. 앱을 삭제한 후에는 복구할 수 없습니다.

앱의 일반 정보나 리디렉션 URL을 수정해도 사용자가 앱을 다시 권한 부여할 필요는 없습니다. 그러나 권한 범위를 추가하거나 수정하는 경우, 새로운 권한에 대해 사용자의 승인을 얻어야 하며 새로운 토큰 세트를 획득해야 합니다. 새로운 범위에 대한 승인을 받지 않으면 기존 토큰을 계속 사용할 수 있지만 이전 범위로 제한됩니다.

비공식 모드의 앱에 대한 시스템은 사용자와 함께 편집 사항을 자동으로 업데이트합니다. 공개 모드의 앱은 이러한 변경 사항을 반영하기 위해 검토 제출을 다시 제출해야 합니다. 그렇지 않으면 시스템이 게시되지 않은 변경 사항을 저장하되 커뮤니티에 공개하지는 않습니다.