README

SSO client package for Laravel receiver applications for Cámara de Comercio de Valledupar.

Requisitos

• PHP 8.2+ (Laravel 13 requiere PHP 8.3+)
• Laravel 11, 12 o 13
• Acceso a la base de datos compartida de usuarios de Cámara de Comercio de Valledupar (conexión configurada en la receptora)

Instalación

composer require camara-de-comercio-de-valledupar/laravel-sso-client

# Opcional — publicar config para sobrescribir valores por defecto:
php artisan vendor:publish --tag=sso-config

El Service Provider se registra automáticamente vía package auto-discovery.

Variables de entorno requeridas

Las variables SSO_TOKEN_PARAM (default: token) y SSO_USER_ID_FIELD (default: sub) ya tienen los valores correctos para trabajar con el lanzador. Solo sobreescribir si se cambia la configuración en el lanzador.

Lo que el paquete registra automáticamente

• Ruta GET /sso/callback (named sso.callback)
• Ruta POST /sso/logout (named sso.logout) — invalida sesión y cierra la pestaña o redirige al lanzador
• Ruta POST /sso/verify-secret (named sso.verify-secret) — sin CSRF, llamada server-to-server desde el lanzador
• Middleware alias sso.token → ValidateSsoToken
• Config sso.* (publicable con tag sso-config)
• No hay migraciones — la base de datos de usuarios ya es compartida entre el lanzador y las receptoras

Flujo completo

Usuario hace clic en el lanzador
↓
Lanzador genera token (TTL: 60s)
payload: { sub: 42, app: "slug", iat: ..., exp: ... }
↓
Redirect → https://receptora.com/sso/callback?token=xxx
↓
Middleware ValidateSsoToken → valida firma HMAC-SHA256 y expiración
↓
SsoController → User::find(42) en DB compartida
↓
Auth::login($user) → redirect a SSO_REDIRECT_AFTER_LOGIN

Formato del token: base64(json(payload)).hmac_sha256(base64(json(payload)), secret) Son dos partes separadas por punto — no es JWT estándar de tres partes.

Errores comunes