Registro de aplicaciones de OAuth 2.0

Registrar tu aplicación OAuth 2.0 le permite acceder a los recursos de Roblox.Después de la inscripción, Roblox asigna a la aplicación una ID de cliente única y secreta que puedes usar para obtener la autorización de los usuarios para acceder a su información y recursos de Roblox.

Registra tu aplicación (app)

Para registrar una aplicación (app):

1. En el tablero de control del creador, vaya a la página aplicaciones de OAuth 2.0.
2. Haga clic en el botón Crear aplicación OAuth 2.0 .
3. Ingrese un nombre de aplicación válido y globalmente único Nombre de aplicación .
4. Lee y acepta los términos de servicio de Roblox y haz clic en Crear .
5. Copia y almacena el ID de cliente y el secreto en un lugar seguro.Después de cerrar la página, ya no tienes acceso al secreto y solo puedes generar uno nuevo.Después de terminar de registrar una aplicación (app), aún puedes acceder y editar las otras propiedades de la aplicación (app).
6. Haga clic en Continuar para editar para configurar su aplicación (app), que se describe en las siguientes secciones.

Configurar información general

Una vez que haya registrado su aplicación (app), debe configurar su información general, incluida:

• Una descripción, que es visible para todos en la comunidad de Roblox.
• Una imagen de miniatura para tu aplicación (app). El tamaño de archivo recomendado es de al menos 150x150 píxeles.
• Un Enlace de entrada como punto de entrada de tu aplicación (app), como la página de inicio del sitio web de la aplicación (app).
• Una URL de términos de privacidad y una URL de términos de servicio para que los usuarios finales lean antes de autorizar tu aplicación (app).Cada URL debe ser HTTPS y no más de 256 caracteres.

Añadir permisos

Para garantizar un control de acceso y seguridad adecuados dentro de tu aplicación (app), debes agregar escopos de permisos .Hay dos tipos de alcances de permiso disponibles:

• Ámbitos de identidad para la autenticación, como openid para los ID de usuario y profile para los perfiles completos.Si selecciona el alcance profile , también debe seleccionar openid .
• Ámbitos de permiso específicos de la API , como asset:read para el permiso de lectura de recursos.Seleccione solo el número mínimo de alcances que necesita para su aplicación (app).

Añadir URLs de redirección

Redireccionar URLs son los puntos de reentrada de tu app a los que se redirigen los usuarios cuando terminan de autorizar tu aplicación (app).Asegúrese de que sus URL de redirección cumplan con los siguientes requisitos:

• Todos los enlaces de redirección deben estar en uno de los siguientes formatos:

  • HTTPS simple, por ejemplo: https://www.example.com .
  • Caminos en localhost con HTTP o HTTPS (certificado autofirmado) con fines de depuración local, por ejemplo:

    • http://localhost:80
    • https://localhost:80
  • Esquemas personalizados para aplicaciones o fines específicos, por ejemplo:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• La longitud máxima de una URL de redirección es de 256 caracteres.
• Puedes agregar hasta 10 URL de redirección.Con múltiples URL de redirección, puedes tener entornos de prueba y permitir que los usuarios migren entre dos sitios sin tiempo de inactividad.

Presentar para revisar

Para minimizar las posibilidades de que las aplicaciones maliciosas dañen a la comunidad, registrar una aplicación no la hace accesible ampliamente.En cambio, se queda en modo privado con un límite de 10 usuarios únicos.Este modo es útil para probar y depurar dentro de tu equipo.

Si quieres extender la base de usuarios para tu aplicación (app), debes publicarla en modo público al enviarla para revisar:

1. Ve a la página de aplicaciones de OAuth 2.0.
2. Haga clic en el botón Editar y publicar para la aplicación que desea publicar.
3. Rellena toda la información requerida y haz clic en el botón Revisión y publicación .Aparece un mensaje con limitaciones en las permisos de tu aplicación durante el período de revisión pendiente.
4. Haga clic en Presentar para revisión .

Mientras la revisión de tu app está pendiente, no puedes editar o enviar otra solicitud hasta que la solicitud de revisión actual sea aprobada o rechazada.Tu aplicación se mantiene en modo privado durante la revisar.Cuando tu aplicación se aprueba, pasa al modo público y no puedes volver a ella al modo privado.

Independientemente de si tu aplicación es aprobada o rechazada, recibes una notificación por correo electrónico del resultado cuando se completa la revisión.

Edita y elimina tu aplicación (app)

Puedes editar o eliminar tu aplicación con los siguientes pasos si no está en revisar:

1. Ve a la página de aplicaciones de OAuth 2.0.

2. Haga clic en Editar o Eliminar para la aplicación (app)deseada.

   • Si eliges editar una aplicación (app), sigue los mismos pasos y requisitos de registro.
   • Si eliges eliminar una aplicación (app), haz clic en Sí, eliminar para confirmar la eliminación. Después de eliminar una aplicación (app), no puedes recuperarla.

Modificar la información general de tu aplicación (app)o las URL de redirección no requiere que los usuarios vuelvan a autorizar la aplicación (app).Sin embargo, si agregas o modificas los alcances de permisos, debes obtener la autorización de los nuevos permisos de tus usuarios y adquirir un nuevo conjunto de tokens.Si no obtienes la autorización para los nuevos alcances, tu aplicación puede continuar usando las fichas existentes, pero está limitada a los alcances anteriores.

Para las aplicaciones en modo privado, el sistema actualiza automáticamente tus ediciones con tus usuarios.Para las aplicaciones en modo público, debes enviar la aplicación para revisión nuevamente para reflejar estos cambios.De lo contrario, el sistema guarda los cambios no publicados para ti sin liberarlo a la comunidad.