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.
Los servicios
Sección titulada «Los servicios»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.
| Apartado | Compartido | Por plataforma | Un servidor comprueba los tokens con |
|---|---|---|---|
| Desktop: 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 Id | Las claves de Google, para cualquiera de estos Client ID | ||
| Supabase | Url, Anon Key | Desktop: Port, Redirect Uri. Web: Redirect Uri | Las claves del proyecto (/auth/v1/.well-known/jwks.json), para authenticated |
| Firebase | Project Id | Las claves de Firebase, para este proyecto | |
| Auth0 | Domain | Desktop: 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 |
| Itch | Desktop: 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 | |
| Custom | Para comprobar: Keys URL, Issuer, Audience (el cliente de cada plataforma, separados por comas), Account Claim. Para iniciar sesión: Authorize URL, Token URL, Scope | Desktop: Client Id, Client Secret, Port, Redirect Uri. Web: Client Id, Redirect Uri | Cualquier 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.
Iniciar sesión en el navegador
Sección titulada «Iniciar sesión en el navegador»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 : Buttonuse 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" | |
"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
localhostel 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.dataes la respuesta entera del servicio (refresh_token,expires_in…).
En un juego web
Sección titulada «En un juego web»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.htmlpara 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_KEYdel servidor, nunca en el proyecto (va con el juego). La cuenta espoki:<user_id>, la misma para este juego siempre. Un servidor sin la clave rechaza los inicios de sesión de Poki.
itch.io
Sección titulada «itch.io»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>"ysigned_intraeusername,display_name,avatar_urleid. La cuenta esitch:<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.
CrazyGames
Sección titulada «CrazyGames»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>.
Usar el token
Sección titulada «Usar el token»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.
Lo que puedes preguntar a Authentication
Sección titulada «Lo que puedes preguntar a Authentication»| Función | Da |
|---|---|
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 |