Guía para integradores: qué hace el cliente del juego con cada plataforma, qué envía al Game Panel, y qué debe configurar un admin en Edit Game → Platform Configurations.

---

Flujo general

Juego → Plataforma (login nativo) → user_id + token

Juego → POST /api/v1/auth/third-party/login → Panel valida con IDC/Steam/Epic

Panel → access_token + refresh_token (sesión del Game Panel)

El panel no sustituye el login de la plataforma: el juego obtiene credenciales en IDC/Steam/Epic y el panel solo valida y crea o enlaza un game_user.

---

Endpoint común del Game Panel


URL	`POST https://gamepanel.idcgames.com/api/v1/auth/third-party/login`
Content-Type	`application/json`
Auth previa	Ninguna (usa `gamepanel_secret_token` en el body)

Campos comunes del JSON

Campo	Obligatorio	Descripción
`platform`	Sí	`idc`, `steam` o `epic`
`token`	Sí	Token que valida la plataforma (ver tabla por plataforma)
`user_id`	Sí	ID de cuenta en esa plataforma (string)
`game_id`	Sí	ID del juego en el Game Panel
`gamepanel_secret_token`	Sí	Secreto del juego en el panel (Edit Game). No es el Client Secret de Epic ni la Steam Web API Key
`username`	No	Nombre mostrado; fallback si no hay perfil remoto
`profile`	No	Objeto libre que se guarda en el perfil del jugador
`details`	No	`none`, `basic` o `extended` (respuesta enriquecida)

Respuesta exitosa (resumen)

success: true

access_token / refresh_token — sesión OAuth del panel para el resto de APIs (Authorization: Bearer …)

user — id, username, platform, platform_user_id, game_id, progreso, etc.

Errores frecuentes HTTP

Código	Causa habitual
401 `Authentication failed`	Token de plataforma inválido o plataforma mal configurada
401 `Invalid GamePanel secret token`	`gamepanel_secret_token` incorrecto
403	Plataforma no Enabled en el juego
422	JSON incompleto o `platform` inválido

Secreto del juego (`gamepanel_secret_token`)

Se genera/gestiona en Games → Edit Game (campo secreto del panel).

Lo embebe el cliente del juego (binario/build) o un backend de confianza; no debe ir en repositorios públicos.

Sirve para el login inicial y otras APIs server-to-server del mismo juego (stats batch, compras externas, etc.) según configuración del proyecto.

gamepanel_secret_token

IDC Games

1. Cliente del juego (IDC)

auth.idcgames.com

Tipos de token

Origen	Token en `token`	Validación en auth.idcgames.com
Launcher / IDCLib	`tokenUserGameId` (MD5, ~1 min)	`GET /api/launcher/check-user-game-token?userId=&gameId=&tokenUserGameId=`
Web / legacy	JWT o token empaquetado	`POST /api/web/verify-token` + cabecera `X-Internal-Key`

user_id en el login del panel = useridc (ID numérico IDC del jugador).

gameId en el check de launcher = id_game de IDC, no el game_id del panel.

Recomendación

idc_game_id o alias platform_game_id

IDC → app_id

coincidir

{

  "platform": "idc",

  "token": "",

  "user_id": "37264",

  "game_id": 1,

  "gamepanel_secret_token": "gp_…",

  "idc_game_id": 1599,

  "username": "PlayerName",

  "details": "extended"

}

primero

app_id

verify-token

3. Configuración en el panel

Edit Game → Platform Configurations → IDC

Campo	Uso
Enabled	Activar login IDC
app_id	`id_game` en auth.idcgames.com (launcher check)
secret_key	`INTERNAL_API_KEY` por juego (fallback web verify-token)

.env del Game Panel

IDC_AUTH_BASE_URL=https://auth.idcgames.com

IDC_INTERNAL_API_KEY=

IDC_GAME_ID

IDC_GAME_SECRET

IDC_PANEL_GAME_ID

php artisan idc:sync-local-game-config

docs/IDC_AUTH_VERIFICATION.md

Steam

1. Cliente del juego (Steam)

1. Steamworks inicia sesión y obtienes el Steam ID (64 bits) del jugador.

2. Genera un session ticket para tu App ID, p. ej. ISteamUser::GetAuthTicketForWebApi con identidad coherente con el panel (por defecto el panel usa gamepanel si no configuras otra).

hex

base64

{

  "platform": "steam",

  "token": "",

  "user_id": "76561198000000000",

  "game_id": 1,

  "gamepanel_secret_token": "gp_…",

  "username": "SteamPlayer",

  "steam_app_id": 1525710,

  "steam_identity": "gamepanel",

  "details": "extended"

}

Campo extra	Descripción
`steam_app_id` / `app_id`	App ID Steam; si el juego lo envía y el panel tiene otro en config, rechaza (anti-spoof)
`steam_identity`	Debe coincidir con el usado al generar el ticket (`GetAuthTicketForWebApi`)

ISteamUserAuth/AuthenticateUserTicket/v1/

steamid

user_id

GetPlayerSummaries

username

3. Configuración en el panel

Edit Game → Platform Configurations → Steam

Campo	Uso
Enabled	Activar login Steam
app_id	Steam App ID del juego
secret_key	Steam Web API Key (Partner)
webapi_identity	Identidad del ticket (default interno: `gamepanel`)

Ticket for other app (102) — App ID del ticket ≠ App ID configurado.

Invalid ticket encoding — ticket corrupto o mal codificado.

php scripts/test-steam-ticket.php

Epic Games (EOS)

1. Cliente del juego (Epic)

Epic Online Services (EOS) Auth

Id Token

Unreal/C++: EOS_Auth_CopyIdToken

El JWT lleva en el payload "t": "id_token" (también se acepta access token "t": "epic_id").

Epic Account ID → user_id (claim sub, 32 hex)

Id Token JWT completo → token (sin recortar)

invalid_token

{

  "platform": "epic",

  "token": "",

  "user_id": "612ac3aa1cfb4ad3923ce6e239b4cd61",

  "game_id": 1,

  "gamepanel_secret_token": "gp_…",

  "username": "Ewi1992",

  "details": "extended"

}

1. Offline: firma JWT con https://api.epicgames.dev/epic/oauth/v2/.well-known/jwks.json, aud = Client ID del juego, sub = user_id, issuer https://api.epicgames.dev…

2. Online (fallback): POST https://api.epicgames.dev/epic/oauth/v2/tokenInfo body token=

id_token

epic_id

dn

username

3. Configuración en el panel

Edit Game → Platform Configurations → Epic

Campo	Uso
Enabled	Activar login Epic
client_id	Client ID EOS (debe igualar `aud` del JWT)
client_secret	Client Secret EOS (token servidor / perfil v2; no sustituye la validación JWT del Id Token)
deployment_id	Deployment ID EOS (`pfdid` en el token). Opcional en verify; recomendado si quieres exigir deployment o usar `client_credentials`
api_url	Por defecto `https://api.epicgames.dev`

Qué NO hace falta en el JSON del cliente

Client Secret de Epic (solo en el panel)

Deployment ID (ya va dentro del JWT como pfdid; en panel es opcional para validación extra)

Errores Epic habituales

Síntoma	Causa
401 tras Id Token válido en cliente	Código antiguo del panel (solo `epic_id`, o `v1/introspect`) — desplegar versión actual
Firma inválida en Epic	Token truncado, expirado o no es Id Token real
`client_id_mismatch`	Client ID del panel ≠ `aud` del JWT
`deployment_id_mismatch`	Deployment en panel ≠ `pfdid` del token (solo si configuraste deployment)

php scripts/test-epic-login-once.php ""

Configuración resumida en el panel

1. Games → Edit Game — anota game_id y gamepanel_secret_token.

2. Platform Configurations — activa IDC / Steam / Epic y rellena credenciales de la tabla de cada sección.

3. Guarda y prueba con Postman o scripts antes de integrar en el build del juego.

Checklist del desarrollador

[ ] game_id y gamepanel_secret_token correctos en el build

[ ] Plataforma Enabled en el juego del panel

[ ] IDC: idc_game_id alineado con app_id IDC en panel

[ ] Steam: mismo App ID y steam_identity al generar el ticket

[ ] Epic: EOS_Auth_CopyIdToken → JWT completo en token, Account ID en user_id

[ ] Tras login, usar access_token del panel en el resto de APIs

Referencias

Epic Auth Web APIs: https://dev.epicgames.com/docs/web-api-ref/authentication

Steam AuthenticateUserTicket: https://partner.steamgames.com/doc/webapi/ISteamUserAuth

API general del panel: Developer → API Documentation (API_COMPLETE_REFERENCE_EN.md)

Integración de login de plataformas

Login de plataformas: IDC Games, Steam y Epic

Flujo general

Endpoint común del Game Panel

Campos comunes del JSON

Respuesta exitosa (resumen)

Errores frecuentes HTTP

Secreto del juego (gamepanel_secret_token)

IDC Games

1. Cliente del juego (IDC)

Tipos de token

Recomendación

2. Login contra el Game Panel (IDC)

3. Configuración en el panel

Steam

1. Cliente del juego (Steam)

2. Login contra el Game Panel (Steam)

3. Configuración en el panel

Epic Games (EOS)

1. Cliente del juego (Epic)

2. Login contra el Game Panel (Epic)

3. Configuración en el panel

Qué NO hace falta en el JSON del cliente

Errores Epic habituales

Configuración resumida en el panel

Checklist del desarrollador

Referencias

Secreto del juego (`gamepanel_secret_token`)