Ir al contenido
Descargar
Plugins

Autenticación

Los jugadores inician sesión con Google, Supabase, Firebase, Auth0 o cualquier otro servicio, y el juego tiene su token: para llamar a la API del servicio (sus partidas guardadas, sus puntuaciones, su perfil) o para entrar en un juego en red, cuyo servidor lo comprueba.

Es un plugin: solo lo tiene el proyecto que lo quiere, y nada de él está en Gobu ni en los juegos que no lo usan. En Edit > Plugins, Install en Authentication: se baja al proyecto como plugins/authentication (su plugin.json y sus bibliotecas) y se activa, como cualquier plugin (ahí se puede desactivar). Gobu carga su biblioteca solo entonces, y un juego exportado la lleva consigo. Mientras no se añade, no hay Authentication ni Project Settings > Authentication.

Sus bibliotecas son para Windows, la web (juegos exportados sin Thread Support, lo predeterminado) y Android (dispositivos de 64 bits); las demás plataformas vendrán después.

Project Settings > Authentication tiene un apartado para cada servicio. Basta con rellenar uno: Authentication.sign_in_with() inicia sesión con él, y un servidor acepta sus tokens (varios servicios a la vez, cada uno con sus claves). Cada apartado tiene lo que el servicio comparte (su proyecto, sus direcciones) y un bloque por plataforma para lo que cambia, el cliente propio de cada plataforma: Desktop (Windows, Linux, macOS), Web, Android, iOS. El juego lee el bloque de su plataforma; un servidor acepta los tokens de todas, así que los jugadores de cada plataforma son las mismas cuentas.

ApartadoCompartidoPor plataformaUn servidor comprueba los tokens con
GoogleDesktop: Client Id, Client Secret, Redirect Uri (un cliente “Desktop app”). Web: Client Id, Redirect Uri (un cliente “Web application”; Android inicia sesión para este). iOS: Client IdLas claves de Google, para cualquiera de estos Client ID
SupabaseUrl, Anon KeyDesktop: Port, Redirect Uri. Web: Redirect UriLas claves del proyecto (/auth/v1/.well-known/jwks.json), para authenticated
FirebaseProject IdLas claves de Firebase, para este proyecto
Auth0DomainDesktop: Client Id, Port, Redirect Uri. Web: Client Id, Redirect Uri. Android, iOS: Client Id (una aplicación cada una)Las claves del tenant, para cualquiera de estos Client ID
ItchDesktop: Client Id, Redirect Uri. Web: Client Id, Redirect Uri (una aplicación OAuth de itch.io cada una)La API de itch.io: el perfil del jugador, con el token
CustomPara comprobar: Keys URL, Issuer, Audience (el cliente de cada plataforma, separados por comas), Account Claim. Para iniciar sesión: Authorize URL, Token URL, ScopeDesktop: Client Id, Client Secret, Port, Redirect Uri. Web: Client Id, Redirect UriCualquier otro servicio (Clerk, Cognito, Keycloak, tu propio servidor): su JWKS
  • La cuenta es el servicio y el id del usuario: supabase:4bade…, google:1102…, así dos servicios nunca se mezclan. Authentication.get_account() da la de este juego.
  • Discord, GitHub, Apple, Twitch…: a través de un proyecto de Supabase (sus proveedores), o Custom.
  • Los tokens firmados con un par de claves (RS256, ES256) solo necesitan las claves públicas del servicio, que un servidor lee solo. Un servicio que firma con un secreto (HS256: un proyecto de Supabase con el JWT secret antiguo, Nakama) se lo da al servidor en la variable de entorno GOBU_AUTH_SECRET, nunca en el proyecto: el proyecto va con el juego.
  • Iniciar sesión en móviles llegará más adelante; sus bloques ya están, así que un servidor acepta sus tokens.

Authentication.sign_in_with() abre la página del servicio en el navegador del jugador. El jugador inicia sesión allí (con la cuenta que ya usa en ese navegador es un clic) y el navegador vuelve al juego, que recibe el token:

module Login
use actor::Google as google : Button
use actor::Error as error : Label
on google.pressed() {
Authentication.sign_in_with("google")
}
on Authentication.signed_in(token: String, data: Dictionary) {
SceneManager.load("mundo")
}
on Authentication.sign_in_failed(motivo: String) {
error.text = motivo
}
Authentication.sign_in_with(...)Inicia sesión con
"google"Google
"supabase", {"provider": "google"}Un proveedor del proyecto de Supabase: "google", "discord", "github", "apple"…
"auth0"Auth0
"oauth"El servicio Custom

Las opciones que se dan en código ganan al apartado (Authentication.sign_in_with("google", {"client_id": ...})).

  • Google: en la consola de Google Cloud, APIs & Services > Credentials > Create OAuth client ID, un cliente por plataforma. Para ordenadores, de tipo Desktop app: da el Client ID y un Client Secret (Google también se lo pide a los juegos, donde no puede ser secreto: lo que protege el inicio de sesión es la comprobación PKCE), y acepta cualquier puerto local. Para la web, uno Web application; para Android, uno Android (su paquete y su SHA-1, solo registrado: inicia sesión para el Web); para iOS, uno iOS. Configura también la pantalla de consentimiento (mientras está en pruebas, solo entran sus usuarios de prueba).
  • Supabase y Auth0 quieren registrada la dirección de vuelta: http://127.0.0.1:43210/ (con el Port del bloque, 43210) en Authentication > URL Configuration > Redirect URLs de Supabase, o en Allowed Callback URLs de Auth0. Los clientes “Desktop app” de Google aceptan cualquier puerto.
  • Un servicio que tiene registrada otra dirección de vuelta: esa, tal cual, en el Redirect Uri del bloque (en un ordenador, una dirección de este ordenador con su puerto; con localhost el juego también espera por IPv6).
  • El navegador muestra “Signed in: you can close this tab” y el juego pasa al frente. El jugador tiene 5 minutos; Authentication.cancel_sign_in() deja de esperar. data es la respuesta entera del servicio (refresh_token, expires_in…).

El mismo Authentication.sign_in_with(), con el bloque Web: la página del servicio se abre en una ventana propia y vuelve a <página>.sign_in.html, que el export web escribe junto al juego (index.sign_in.html para index.html). Esa página avisa al juego y se cierra.

  • Registra esa dirección como la de vuelta: en las Authorized redirect URIs del cliente Web application de Google (https://mijuego.example/index.sign_in.html; http://localhost:8060/index.sign_in.html para probarlo), en las Redirect URLs de Supabase, en las Allowed Callback URLs de Auth0 (y el origen de la página en sus Allowed Web Origins). El Redirect Uri del bloque Web la cambia.
  • Llámalo cuando el jugador pulse un botón: los navegadores bloquean una ventana que se abre sola.
  • Ningún secreto viaja al navegador: Google devuelve su ID token directamente (con un nonce), y los demás un código con PKCE que el juego cambia.

Un juego web en Poki (con el plugin de Poki) inicia sesión con las cuentas de Poki: Authentication.sign_in_with("poki"), sin nada en Project Settings. La primera vez se abre el inicio de sesión de Poki y la página vuelve a cargar con el jugador dentro; llámalo otra vez entonces (responde enseguida). El token es "poki:<token de Poki>" y signed_in trae username y avatar_url.

  • El token de Poki dura un minuto: inicia sesión justo antes de entrar en línea.
  • El servidor lo comprueba con Poki con la clave del equipo del juego (te la da tu gestor de cuenta de Poki): ponla en la variable de entorno GOBU_POKI_TEAM_KEY del servidor, nunca en el proyecto (va con el juego). La cuenta es poki:<user_id>, la misma para este juego siempre. Un servidor sin la clave rechaza los inicios de sesión de Poki.

Authentication.sign_in_with("itch") inicia sesión con la cuenta de itch.io del jugador: en un ordenador en su navegador, en un juego web en una ventana propia, como los demás servicios. Crea una aplicación OAuth en itch.io > Settings > OAuth applications (no tiene secreto) y pon su Client Id y su Redirect Uri, exactamente como la tiene la aplicación, en Project Settings > Authentication > Itch (http://127.0.0.1:43210/ en un ordenador, https://<host>/<juego>.sign_in.html en la web).

  • El token es "itch:<token de itch.io>" y signed_in trae username, display_name, avatar_url e id. La cuenta es itch:<id>.
  • Los tokens de itch.io no caducan, y un servidor los comprueba pidiendo a itch.io el perfil del jugador. No dicen para qué juego son, a diferencia de los de Google o CrazyGames: un servidor solo los acepta si su sección Itch está rellena.

Un juego web en CrazyGames (con el plugin de CrazyGames) inicia sesión con las cuentas de CrazyGames: Authentication.sign_in_with("crazygames"). Si el jugador aún no la tiene iniciada, se abre el inicio de sesión de CrazyGames. El token es "crazygames:<token de CrazyGames>" (dura una hora) y signed_in trae username y avatar_url.

  • Project Settings > Authentication > CrazyGames > Game Id: el id del juego en CrazyGames. Un servidor comprueba los tokens con las claves públicas de CrazyGames y solo acepta los de este juego. La cuenta es crazygames:<userId>.

Authentication.get_token() es el token de la sesión: la API del servicio lo acepta como Authorization: Bearer <token>. Con Supabase, las filas de una tabla del jugador:

use actor::Http as http : HTTPRequest
SUPABASE_URL :: "https://<proyecto>.supabase.co"
SUPABASE_KEY :: "<anon key>"
fn cargar_puntos() void {
http.request(SUPABASE_URL + "/rest/v1/puntos?select=*", ["apikey: " + SUPABASE_KEY, "Authorization: Bearer " + Authentication.get_token()])
}
  • Un juego en red no necesita nada más: cuando su servidor pide login (Project Settings > Online > Login > Check: Services), el token va a Online.login() solo y el servidor lo comprueba con este mismo plugin. Mira Juegos en red.
  • Authentication.sign_out() olvida la sesión.
  • Un servidor propio (otra red que no es la de Online) comprueba un token con Authentication.check_token(token, callback): el callback recibe la cuenta (google:1102…, vacía si no vale) y el motivo.
FunciónDa
sign_in_with(servicio, opciones)Inicia sesión en el navegador; después signed_in(token, data) o sign_in_failed(motivo)
cancel_sign_in() / is_signing_in()Deja de esperar / si está esperando
get_token() / get_session()El token de la sesión / la respuesta entera del servicio
get_account()La cuenta de este juego: google:1102…
sign_out()Olvida la sesión (signed_out)
check_token(token, callback)(Un servidor) si un token vale para este juego, y su cuenta