Registrazione dell'app OAuth 2.0

Registrare la tua app OAuth 2.0 consente di accedere alle risorse Roblox. Dopo la registrazione, Roblox assegna all'app un client ID e un segreto unici che puoi utilizzare per ottenere l'autorizzazione dagli utenti per accedere alle loro informazioni e risorse Roblox.

Registra la tua app

Per registrare un'app:

1. Nella Creator Dashboard, vai alla pagina OAuth 2.0 Apps.
2. Clicca sul pulsante Crea App.
3. Inserisci un Nome Applicazione valido e globalmente unico.
4. Leggi e accetta i Termini di Servizio di Roblox e clicca su Crea.
5. Copia e conserva il Client ID e il Segreto in un luogo sicuro. Dopo aver chiuso la pagina, non avrai più accesso al segreto e potrai solo generarne uno nuovo. Dopo aver terminato la registrazione di un'app, puoi comunque accedere ed editare le altre proprietà dell'app.
6. Clicca su Continua a Modificare per configurare la tua app, come descritto nelle sezioni seguenti.

Configura informazioni generali

Una volta che hai registrato la tua app, dovresti configurare le sue informazioni generali, incluse:

• Una descrizione, visibile a tutti nella comunità Roblox.
• Un'immagine in miniatura per la tua app. La dimensione del file consigliata è di almeno 150x150 pixel.
• Un Link di Accesso come punto d'accesso della tua app, come la homepage del sito web dell'app.
• Un URL dei Termini di Privacy e un URL dei Termini di Servizio per gli utenti finali da leggere prima di autorizzare la tua app. Ogni URL deve essere HTTPS e non più lungo di 256 caratteri.

Aggiungi permessi

Per garantire un corretto controllo degli accessi e sicurezza all'interno della tua app, devi aggiungere Scope dei Permessi. Ci sono due tipi di scope di permesso disponibili:

• Scope di identità per l'autenticazione, come openid per gli ID utente e profile per i profili completi. Se selezioni lo scope profile, devi anche selezionare openid.
• Scope di permessi specifici delle API, come asset:read per il permesso di lettura degli asset. Seleziona solo il numero minimo di scope di cui hai bisogno per la tua app.

Aggiungi URL di reindirizzamento

URL di reindirizzamento sono i punti di accesso della tua app a cui gli utenti vengono reindirizzati quando terminano di autorizzare la tua app. Assicurati che i tuoi URL di reindirizzamento rispettino i seguenti requisiti:

• Tutti gli URL di reindirizzamento devono essere in una delle seguenti forme:

  • HTTPS semplice, ad esempio: https://www.example.com.`
  • Percorsi su localhost con HTTP o HTTPS (certificato autofirmato) per scopi di debug locale, ad esempio:

    • `http://localhost:80``
    • `https://localhost:80``
  • Schemi personalizzati per applicazioni o scopi specifici, ad esempio:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• La lunghezza massima di un URL di reindirizzamento è di 256 caratteri.
• Puoi aggiungere fino a 10 URL di reindirizzamento. Con più URL di reindirizzamento, puoi avere ambienti di test e consentire agli utenti di migrare tra due siti senza interruzione.

Invia per revisione

Per ridurre al minimo le possibilità che app malevole danneggino la comunità, la registrazione di un'app non la rende ampiamente accessibile. Invece, rimane in modalità privata con un limite di 10 utenti unici. Questa modalità è utile per test e debug all'interno del tuo team.

Se desideri estendere il numero di utenti della tua app, devi pubblicarla in modalità pubblica inviandola per revisione:

1. Vai alla pagina OAuth 2.0 apps.
2. Clicca sul pulsante Modifica e Pubblica per l'app che desideri pubblicare.
3. Compila tutte le informazioni richieste e clicca sul pulsante Revisione e Pubblica. Apparirà un messaggio con aliquote sui permessi della tua app durante il periodo di revisione in sospeso.
4. Clicca su Invia per Revisione.

Durante la revisione della tua app, non puoi modificare o inviare un'altra richiesta fino a quando l'attuale richiesta di revisione non viene approvata o rifiutata. La tua app rimane in modalità privata durante la revisione. Quando la tua app viene approvata, passa a modalità pubblica, e non puoi riportarla in modalità privata.

Indipendentemente dal fatto che la tua app venga approvata o rifiutata, ricevi una notifica via email del risultato quando la revisione è completata.

Modifica e elimina la tua app

Puoi modificare o eliminare la tua app seguendo questi passaggi se non è in revisione:

1. Vai alla pagina OAuth 2.0 apps.

2. Clicca su Modifica o Elimina per l'app desiderata.

   • Se hai scelto di modificare un'app, segui gli stessi passaggi e requisiti di registrazione.
   • Se hai scelto di eliminare un'app, clicca su Sì, Elimina per confermare l'eliminazione. Dopo aver eliminato un'app, non puoi recuperarla.

Modificare le informazioni generali della tua app o gli URL di reindirizzamento non richiede che gli utenti ri-autorizzino l'app. Tuttavia, se aggiungi o modifichi gli scope di permesso, devi ottenere l'autorizzazione per i nuovi permessi dai tuoi utenti e acquisire un nuovo set di token. Se non ottieni l'autorizzazione per i nuovi scope, la tua app può continuare a utilizzare i token esistenti, ma è limitata ai precedenti scope.

Per le app in modalità privata, il sistema aggiorna automaticamente le tue modifiche con i tuoi utenti. Per le app in modalità pubblica, devi invio l'app per revisione di nuovo per riflettere queste modifiche. In caso contrario, il sistema salva le modifiche non pubblicate per te senza rilasciarle alla comunità.