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 ID cliente unico e un segreto che puoi utilizzare per ottenere l'autorizzazione dagli utenti ad accedere alle loro informazioni e risorse Roblox.

Registra la tua applicazione

Per registrare un'applicazione:

1. Nella Dashboard del creatore, vai alla pagina app OAuth 2.0.
2. Fai clic sul pulsante Crea app OAuth 2.0 .
3. Inserisci un nome di applicazione valido e globalmente unico Nome dell'applicazione .
4. Leggi e accetta i Termini di servizio di Roblox e clicca Crea .
5. Copia e conserva il ID Cliente e il Segreto in un Postosicuro.Dopo aver chiuso la pagina, non hai più accesso al segreto e puoi generare solo uno nuovo.Dopo aver completato la registrazione di un'applicazione, puoi ancora accedere e modificare le altre proprietà dell'applicazione.
6. Fai clic su Continua a modificare per configurare la tua applicazione, descritta nelle seguenti sezioni.

Configura le informazioni generali

Una volta che hai registrato la tua applicazione, dovresti configurare le sue informazioni generali, tra cui:

• Una Descrizione, che è visibile a tutti nella comunità Roblox.
• Un'immagine thumbnail per la tua applicazione. La dimensione del file consigliata è almeno 150x150 pixel.
• Un Link di ingresso come punto di ingresso della tua applicazione, come la home page del sito web dell'applicazione.
• Un URL Termini di privacy e un URL Termini di servizio per i destinatari finali da leggere prima di autorizzare la tua applicazione.Ogni URL deve essere HTTPS e non più di 256 caratteri.

Aggiungi permessi

Per garantire un'adeguata protezione e controllo dell'accesso all'interno della tua applicazione, devi aggiungere ambiti di autorizzazione .Sono disponibili due tipi di scopi di autorizzazione:

• Ambiti 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 .
• Ambiti di autorizzazione specifici per API , come asset:read per il permesso di lettura delle risorse.Seleziona solo il numero minimo di scope di cui hai bisogno per la tua applicazione.

Aggiungi URL di redirect

Ridireziona gli URL sono i punti di ritorno della tua app a cui gli utenti vengono reindirizzati quando finiscono di autorizzare la tua applicazione.Assicurati che le tue URL di reindirizzamento soddisfino i seguenti requisiti:

• Tutti gli URL di reindirizzamento devono essere in uno dei seguenti formati:

  • HTTPS semplice, ad esempio: https://www.example.com .
  • Percorsi sul 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 prova e consentire agli utenti di migrare tra due siti senza interruzioni.

Invia per la Revisionare

Per ridurre le possibilità che le app malevole danneggino la comunità, registrare un'app non la rende ampiamente accessibile.Invece, rimane in modo privato con un limite di 10 utenti unici.Questa modalità è utile per test e debugging all'interno della tua team.

Se vuoi estendere la base utenti per la tua applicazione, devi pubblicarla in modalità pubblica inviandola per la Revisionare:

1. Vai alla pagina app OAuth 2.0.
2. Fai clic sul pulsante Modifica e pubblica per l'app che vuoi Pubblicare.
3. Compila tutte le informazioni richieste e clicca il pulsante Anteprima e Pubblica .Appare un messaggio con limiti sulle autorizzazioni della tua app durante il periodo di revisione in sospeso.
4. Fai clic su Invia per la revisione .

Mentre la tua recensione dell'app è in attesa, non puoi modificare o inviare un'altra richiesta fino a quando la richiesta di revisione attuale non viene approvata o rifiutata.La tua app rimane in modalità privata durante la Revisionare.Quando la tua app viene approvata, passa al modo pubblico e non puoi ripristinarla al modo privato.

Indipendentemente dal fatto che la tua app sia approvata o rifiutata, ricevi una notifica via e-mail del risultato quando la revisione è completata.

Modifica e elimina la tua applicazione

Puoi modificare o eliminare la tua app con i seguenti passaggi se non è in fase di Revisionare:

1. Vai alla pagina app OAuth 2.0.

2. Fai clic su Modifica o Elimina per l'applicazionedesiderata.

   • Se scegli di modificare un'applicazione, segui gli stessi passaggi e requisiti della registrazione registrazione.
   • Se scegli di eliminare un'applicazione, fai clic su Sì, Elimina per confermare l'eliminazione. Dopo aver eliminato un'applicazione, non puoi recuperarla.

La modifica delle informazioni generali o degli URL di reindirizzamento della tua applicazionenon richiede che gli utenti riautorizzino l'applicazione.Tuttavia, se aggiungi o modifichi le scadenze di autorizzazione, devi ottenere l'autorizzazione per le nuove autorizzazioni dai tuoi utenti e acquisire un nuovo set di token.Se non ottieni l'autorizzazione per le nuove scoperte, la tua app può continuare a utilizzare i token esistenti, ma è limitata alle scoperte precedenti.

Per le app in modalità privata, il sistema aggiorna automaticamente le modifiche con i tuoi utenti.Per le app in modalità pubblica, devi inviare nuovamente l'app per la revisione per riflettere questi cambiamenti.Altrimenti, il sistema salva le modifiche non pubblicate per te senza rilasciarle alla comunità.