Rejestracja aplikacji OAuth 2.0

Rejestracja aplikacji OAuth 2.0 pozwala na uzyskanie dostępu do zasobów Roblox.Po rejestracji Roblox przypisuje aplikacji unikalny identyfikator klienta i sekret, który możesz użyć do uzyskania autoryzacji od użytkowników do uzyskiwania dostępu do ich informacji i zasobów Roblox.

Rejestruj swoją aplikacja

Aby rejestrować aplikacja:

1. W menu Pulpitu nawigacyjnego twórcy, przejdź do strony aplikacji OAuth 2.0.
2. Kliknij przycisk Twórz aplikację OAuth 2.0 .
3. Wpisz ważną i globalnie unikalną nazwę aplikacji .
4. Przeczytaj i zaakceptuj Warunki usług Roblox i kliknij Utwórz .
5. Kopiuj i przechowuj identyfikator klienta i sekret w bezpiecznym miejsce.Po zamknięciu strony nie masz już dostępu do sekretu i możesz generować tylko nowy.Po zakończeniu rejestracji aplikacjanadal możesz uzyskać dostęp i edytować inne właściwości aplikacja.
6. Kliknij Kontynuuj edycję , aby skonfigurować swoją aplikacja, opisaną w następnych sekcjach.

Konfiguruj ogólną informację

Po rejestracji aplikacjamusisz skonfigurować jej ogólną informację, w tym:

• opis, który jest widoczny dla wszystkich w społeczności Roblox.
• Miniatura obrazu dla twojej aplikacja. Zalecany rozmiar pliku wynosi co najmniej 150x150 pikseli.
• Link wejściowy jako punkt wejścia do aplikacja, tak jak strona główna witryny aplikacja.
• A URL prywatności i URL usługi dla użytkowników końcowych, które należy przeczytać przed autoryzacją aplikacja.Każda URL musi być HTTPS i nie więcej niż 256 znaków.

Dodaj uprawnienia

Aby zapewnić właściwą kontrolę dostępu i bezpieczeństwo w aplikacja, musisz dodać zakresy uprawnień .Dostępne są dwa rodzaje zakresów uprawnień:

• Zakresy tożsamości do uwierzytelniania, takie jak openid dla identyfikatorów użytkownika i profile dla pełnych profili.Jeśli wybierzesz zakres profile , musisz również wybrać openid .
• Sceny uprawnień specyficzne dla API , takie jak asset:read na uprawnienie do odczytu zasobów.Wybierz tylko minimalną liczbę zakresów, których potrzebujesz dla swojej aplikacja.

Dodaj przekierowane URL-e

Przekierowane URL-e są punktami powrotu do aplikacji, do których użytkownicy są przekierowywani po zakończeniu autoryzacji aplikacja.Upewnij się, że Twoje przekierowane URL-e spełniają następujące wymagania:

• Wszystkie przekierowane URL-e muszą być w jednej z następujących form:

  • Prosty HTTPS, na przykład: https://www.example.com .
  • Ścieżki na localhost z HTTP lub HTTPS (certyfikat samodzielnie podpisany) do celów lokalnego debugowania, na przykład:

    • http://localhost:80
    • https://localhost:80
  • Niestandardowe schematy dla konkretnych aplikacji lub celów, na przykład:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• Maksymalna długość URL przekierowania wynosi 256 znaków.
• Możesz dodać do 10 przekierowanych URL-ów.Dzięki wielu przekierowaniom URL możesz mieć środowiska testowe i pozwolić użytkownikom na migrację między dwoma witrynami bez przestojów.

Prześlij do recenzować, przyglądać się

Aby zmniejszyć szanse na szkody złośliwych aplikacji dla społeczności, rejestracja aplikacji nie czyni jej szeroko dostępną.Zamiast tego pozostaje w trybie prywatnym z ograniczeniem 10 unikalnych użytkowników .Ten tryb jest przydatny do testowania i debugowania w ramach twojego zespołu.

Jeśli chcesz rozszerzyć bazę użytkowników dla swojej aplikacja, musisz opublikować ją w trybie publicznym, przesyłając ją do recenzować, przyglądać się:

1. Przejdź na stronę aplikacji OAuth 2.0.
2. Kliknij przycisk Edytuj i publikuj dla aplikacji, którą chcesz opublikować.
3. Wypełnij wszystkie wymagane informacje i kliknij przycisk Przegląd i publikacja .Pojawia się wiadomość z ograniczeniami w zakresie uprawnień aplikacji podczas okresu oczekiwania na recenzję
4. Kliknij Prześlij do przeglądu .

Choć recenzja aplikacji jest w oczekujące, nie możesz edytować ani nie możesz zatwierdzić kolejnej prośby, dopóki obecna prośba o recenzję nie zostanie zaakceptowana lub odrzucona.Twoja aplikacja pozostaje w trybie prywatnym podczas recenzować, przyglądać się.Gdy twoja aplikacja zostanie zatwierdzona, przechodzi do trybu publicznego i nie możesz jej odwrócić do trybu prywatnego.

Niezależnie od tego, czy twoja aplikacja została zatwierdzona, czy odrzucona, otrzymasz powiadomienie e-mail o wyniku po zakończeniu przeglądu.

Edytuj i usuwaj aplikacja

Możesz edytować lub usuwać aplikację za pomocą następujących kroków, jeśli nie jest ona w trakcie recenzować, przyglądać się:

1. Przejdź na stronę aplikacji OAuth 2.0.

2. Kliknij Edytuj lub Usuń dla pożądanego aplikacja.

   • Jeśli zdecydujesz się edytować aplikacja, postępuj zgodnie z tymi samymi krokami i wymaganiami rejestracji rejestracji.
   • Jeśli zdecydujesz się usunąć aplikacja, kliknij Tak, usuń , aby potwierdzić usunięcie. Po usunięciu aplikacjanie można jej odzyskać.

Modyfikacja ogólnych informacji o aplikacji lub przekierowanie URL-ów nie wymaga od użytkowników ponownego autoryzowania aplikacji.Jeśli jednak dodasz lub zmodyfikujesz zakresy uprawnień, musisz uzyskać autoryzację dla nowych uprawnień od użytkowników i nabyć nowy zestaw tokenów.Jeśli nie uzyskasz autoryzacji dla nowych zakresów, twoja aplikacja może nadal korzystać z istniejących tokenów, ale jest ograniczona do poprzednich zakresów.

Dla aplikacji w trybie prywatnym system automatycznie aktualizuje twoje edycje z użytkownikami.W przypadku aplikacji w trybie publicznym musisz ponownie prześlij aplikację do przeglądu, aby odzwierciedlić te zmiany.W przeciwnym razie system zapisuje nieopublikowane zmiany dla Ciebie bez uwalniania ich do społeczności.