Rejestracja aplikacji OAuth 2.0

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Rejestracja twojej aplikacji OAuth 2.0 umożliwia jej dostęp do zasobów Roblox. Po rejestracji Roblox przydziela aplikacji unikalne ID klienta i sekret, który możesz użyć do uzyskania autoryzacji od użytkowników, aby uzyskać dostęp do ich informacji i zasobów Roblox.

Rejestracja aplikacji

Aby rejestrować aplikacja:

  1. W Panelu twórcy, przejdź do strony Aplikacje OAuth 2.0.
  2. Kliknij przycisk Utwórz aplikację OAuth 2.0 .
  3. Wpisz ważne i globalnie unikalne Nazwa aplikacji .
  4. Przeczytaj i zgadza się z Warunkami korzystania z usługi Roblox i kliknij Utwórz.
  5. Kopiuj i przechowuj identyfikator klienta i tajne w bezpiecznym miejsce. Po zamknięciu strony nie masz już dostępu do tajnego i możesz generować tylko nowy. Po zakończeniu rejestracji aplikacjamożesz nadal uzyskać dostęp do innych właściwości aplikacjai edytować je tylko.
  6. Kliknij Kontynuuj Edytowanie , aby skonfigurować swoją aplikacja, która jest opisana w następnych sekcjach.

Konfiguracja ogólnych informacji

Po rejestracji swojej aplikacjanależy skonfigurować jej ogólną informację, w tym:

  • opis, który jest widoczny dla wszystkich w społeczności Roblox.
  • Zdjęcie miniaturki dla twojej aplikacja. Wymaganym rozmiarem pliku jest co najmniej 150x150 pikseli.
  • Link Wejściowy jako wejście do swojego aplikacja, takie jak strona główna aplikacja.
  • A Privacy Terms URL i A Terms of Service URL dla użytkowników końcowych, aby przeczytać przed upoważnieniem swojej aplikacja. Każdy URL musi być HTTPS i nie więcej niż 256 znaków.

Dodawanie uprawnień

Aby zapewnić właściwą kontrolę dostępu i bezpieczeństwo w swojej aplikacja, musisz dodać Zakresy upoważnień . Istnieją dwa rodzaje zakresów upoważnień dostępnych:

  • Zakresy tożsamości dla uwierzytelnienia, takie jak openid dla ID użytkowników i profile dla pełnych profili. Jeśli wybierzesz zakres 0> profile0>, musisz również wybrać 3> openid 3>.
  • API-specific permission scopes , takie jak asset:read dla pozwolenia na czytanie zasobów. Wybierz tylko minimum liczby zakresów, które są niezbędne dla twojego aplikacja.

Dodawanie URLów Przekierowania

Przekierowania URL są punktami wtórego wejścia do aplikacji, do których użytkownicy są przekierowani po zakończeniu autoryzacji aplikacja. Upewnij się, że twoje przekierowania URL spełniają następujące wymagania:

  • Wszystkie przekierowane URL muszą być w jednej z następujących form:
    • Standardowy HTTPS, na przykład: https://www.example.com .
    • Drogi na lokalnym hostingu z HTTP lub HTTPS (certyfikat podpisany elektronicznie) do celów lokalnego debugowania, na przykład:
      • http://localhost:80
      • https://localhost:80
    • Niestandardowe schemy dla konkretnych zastosowań lub celów, na przykład:
      • my-app-scheme:/
      • my-app-scheme://foo/bar/...
      • my-app://action?param1=value1&param2=value2
  • Maksymalna długość przekierowania URL wynosi 256 znaków.
  • Możesz dodać do 10 URLów przekierunkowych. Z mnóstwem URLów przekierunkowych możesz mieć środowiska testowe i pozwolić użytkownikom na migrację między dwoma witrynami bez przerwy.

Składanie recenzji

Aby zmniejszyć szanse na uszkodzenie społeczności przez niechciane aplikacje, rejestracja aplikacji nie czyni jej publicznie dostępną. Zamiast tego pozostaje w trybie prywatnym z ograniczeniem 100 autoryzowanych użytkowników. Ten tryb jest pomocny do testowania i debugowania w swojej drużynie.

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

  1. Idź do strony OAuth 2.0 Apps.
  2. Kliknij przycisk Edytuj i opublikuj dla aplikacji, którą chcesz opublikować.
  3. Wypełnij wszystkie wymagane informacje i kliknij przycisk Przegląd i publikacja . Wyświetli się wiadomość z ograniczeniami na Twojej zgody aplikacji podczas okresu przeglądania.
  4. Kliknij Składać recenzji .

Podczas gdy Twoja recenzja aplikacji jest oczekujące, nie możesz edytować lub wysyłać innego wniosku, dopóki bieżący wniosek recenzji nie zostanie zaakceptowany lub odrzucony. Twoja aplikacja pozostaje w trybie prywatnym podczas recenzować, przyglądać się. Gdy aplikacja jest zaakceptowana, przechodzi do trybu publicznego i nie możesz go odwrócić do trybu prywatnego.

Niezależnie od tego, czy aplikacja jest zaakceptowana lub odrzucona, otrzymujesz powiadomienie e-mail o wyniku, gdy recenzja zostanie zakończona.

Edytowanie i usuwanie aplikacji

Możesz edytować lub usunąć aplikację z następującymi krokami, jeśli nie jest ona poddana pod recenzować, przyglądać się:

  1. Idź do strony OAuth 2.0 Apps.

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

    • Jeśli wybrałeś edytor aplikacja, postępuj zgodnie ze wskazanymi krokami i wymaganiami dotyczącymi rejestracji.
    • Jeśli wybrałeś usunięcie aplikacja, kliknij Tak, usuń , aby potwierdzić usunięcie. Po usunięciu aplikacjanie możesz go odzyskać.

Modyfikowanie ogólnych informacji o aplikacji lub zmienianie URLów przekierowań nie wymaga od użytkowników ponownego autorzenia aplikacji. Jeśli jednak dodasz lub zmienisz zakresy uprawnień, musisz uzyskać zgody użytkowników na nowe uprawnienia z Twoich użytkowników i uzyskać nowy zestaw tokenów. Jeśli nie uzyskasz zgody na nowe zakresy, aplikacja może nadal używać istnie

Dla aplikacji w trybie prywatnym system automatycznie aktualizuje twoje edytowanie z użytkownikami. Dla aplikacji w trybie publicznym musisz zatwierdzić aplikację dla recenzji ponownie, aby odzwierciedlić te zmiany. W przeciwnym razie system zapisuje nieopublikowane zmiany dla ciebie bez ich wypuszczenia do społeczności.