Consola de Licencias

La sección de Licencias de la Consola de Administración te permite crear políticas, emitir y gestionar claves, configurar automatización y monitorear el uso — todo sin escribir código.

Accede desde la barra lateral: Licensing → Policies | Keys | Usage | Automation.

Políticas

Las políticas definen las reglas de una licencia: qué funcionalidades incluye, cuántos puestos/dispositivos se permiten, cuándo expira y cómo funciona la validación.

Crear una Política

1. Ve a Licensing → Policies y haz clic en New Policy
2. Paso 1 — Ingresa un nombre (ej. “Pro Plan”) y un slug (ej. pro-plan)
3. Paso 2 — Configura las dimensiones:
   • Key Format — Personaliza el prefijo, charset, cantidad/longitud de segmentos y separador. Una vista previa en vivo muestra el formato generado (ej. VIG-XXXX-XXXX-XXXX-XXXX)
   • Seats — Habilita para limitar usuarios concurrentes. Establece un máximo por defecto
   • Devices — Habilita para limitar dispositivos activados. Establece un máximo por defecto
   • Features — Habilita para definir un conjunto de flags de funcionalidades (ej. analytics, export, api-access)
   • Expiry — Habilita para establecer una expiración por defecto en días
4. Paso 3 — Elige el modo de validación:
   • Online — Cada validación consulta la API (ideal para SaaS)
   • Hybrid — Online primero, respaldo JWT offline (ideal para escritorio)
   • Offline — Solo JWT, sin red necesaria (ideal para entornos aislados)

Editar una Política

Desde la lista de políticas, haz clic en el menú … → Edit. Puedes cambiar el nombre, modo de validación, dimensiones, período de gracia offline y TTL de revocación.

Ver Detalles de la Política

Haz clic en … → View para ver la página de detalle completa de la política, incluyendo:

• Estado, modo de validación y resumen de dimensiones
• Configuración de la política (gracia offline, TTL de revocación, puestos/dispositivos/expiración por defecto)
• Vista previa del formato de clave
• Todas las claves emitidas bajo esta política

Claves

Emitir una Clave

1. Ve a Licensing → Keys y haz clic en Issue Key
2. Selecciona una política
3. Elige el tipo de licenciatario (USER, ORG, DEVICE)
4. Opcionalmente ingresa un ID de licenciatario y notas
5. Haz clic en Issue Key

La clave se genera usando el formato definido en la política (ej. VIG-A8BC-D3EF-G4HJ-K5LM).

Funcionalidades de la Lista de Claves

• Búsqueda — Filtra por cadena de clave o ID de licenciatario
• Filtro de estado — Muestra solo claves Activas, Suspendidas, Expiradas o Revocadas
• Avisos de expiración — Las claves que expiran en 7 días muestran un badge ámbar “Expiring soon”
• Exportar CSV — Descarga la lista completa de claves como CSV
• Paginación — Navega por conjuntos grandes de claves

Acciones de Claves

Desde el menú … de cada clave:

Página de Detalle de la Clave

Haz clic en View para ver la página de detalle completa de la clave con tres pestañas:

• Entitlements — Información del licenciatario, funcionalidades, expiración, puestos, política, fecha de creación
• Seats — Ver usuarios asignados, asignar nuevos puestos, liberar puestos
• Devices — Ver dispositivos activados, eliminar dispositivos

Probador de Validación

Haz clic en Validate Key en la página de claves para abrir el probador de validación. Pega cualquier clave para probarla contra la API — verifica si es válida y consulta sus funcionalidades, estado y expiración.

Uso

La página Licensing → Usage muestra estadísticas agregadas:

• Tarjetas KPI: Total de políticas, total de claves, activas, revocadas, suspendidas, expiradas
• Distribución por política: Cuántas claves se emitieron por política
• Claves recientes: Las últimas claves emitidas con badges de estado

Automatización

Las reglas de automatización conectan eventos de pago con acciones de licencia. Cuando un cliente paga, se emite una clave automáticamente.

Crear una Regla

1. Ve a Licensing → Automation y haz clic en New Rule
2. Ingresa un nombre para la regla
3. Elige el proveedor (Stripe, PayPal o Manual)
4. Selecciona el evento de activación (ej. Checkout Completed)
5. Selecciona la acción (ej. Issue Key)
6. Opcionalmente vincula una política (requerida para la acción Issue Key)

Proveedores y Eventos Soportados

Configuración de Webhooks

Para que la automatización funcione, necesitas configurar webhooks en tu proveedor de pagos:

Stripe:

1. Ve al Dashboard de Stripe → Developers → Webhooks
2. Agrega el endpoint: https://your-auris-domain/api/licensing/webhooks/stripe
3. Selecciona eventos: checkout.session.completed, invoice.paid
4. Copia el secreto de firma en STRIPE_LICENSING_WEBHOOK_SECRET

PayPal:

1. Ve al Dashboard de Desarrollador de PayPal → Webhooks
2. Agrega el endpoint: https://your-auris-domain/api/licensing/webhooks/paypal
3. Configura PAYPAL_LICENSING_WEBHOOK_SECRET y PAYPAL_LICENSING_WEBHOOK_ID