Skip to content

Referencia

Panel de administración

Un recorrido práctico del panel web en /dashboard: inicio de sesión, el resumen de Inicio, Products, Licenses, Team, Integration y Settings.

El servicio emisor sirve un panel web en /dashboard (p. ej. https://keyright.delta1labs.com/dashboard). Es una interfaz con marca y sin dependencias sobre la API /admin/* — la forma del día a día en que un proveedor gestiona el licenciamiento sin tocar curl. Todo lo que hay aquí también está disponible en la API (consulta Referencia de la API HTTP); esto es un recorrido práctico de las pantallas.

Iniciar sesión

El panel admite estas rutas de inicio de sesión:

  • Email + contraseña + TOTP. Introduce el email y la contraseña de tu equipo (POST /auth/login), luego un código de 6 dígitos de tu aplicación de autenticación (POST /auth/mfa). El MFA es obligatorio y se autoinscribe en el primer inicio de sesión — el primer acceso muestra un código QR para añadir a tu autenticador, luego pide un código para confirmar. Un owner aprovisiona la contraseña inicial de un miembro desde Team → set password.
  • Google / GitHub. Pulsa el botón del proveedor para iniciar sesión mediante OAuth. El callback de OAuth se ejecuta en tu propio dominio, de modo que la pantalla de consentimiento del proveedor muestra tu marca, no un host de autenticación de terceros. Tu cuenta se empareja por email verificado.
  • Token de administrador (bootstrap autoalojado). Una instancia autoalojada recién creada aún no tiene usuario del panel, así que inicia sesión con tu credencial raíz: expande “Advanced: use an access token” y pega tu KEYRIGHT_ADMIN_TOKEN. Úsalo para entrar inicialmente; luego aprovisiona inicios de sesión por persona mediante Team (email/contraseña) o configura SSO si lo deseas.

Un inicio de sesión correcto acuña un token de sesión de vida corta que autoriza el resto del panel. El inicio de sesión es por tenant; en el servicio alojado tu espacio de trabajo se resuelve a partir de tu email.

Inicio

La vista de aterrizaje es el resumen del espacio de trabajo (GET /admin/overview):

  • Resumen de suscripción — tu plan, estado y la próxima fecha de renovación.
  • Recuentos destacados — productos, licencias totales/activas, revocadas, caducadas, que caducan pronto, activaciones.
  • Gráficos — licencias emitidas por mes (últimos 6 meses) y un desglose por producto de licencias y activaciones.
  • Renovaciones próximas — las siguientes licencias en caducar, para que puedas contactar antes de que venzan.
Inicio del panel de Keyright: resumen de suscripción, recuentos destacados (productos, licencias activas, máquinas activadas, renovaciones pendientes), un gráfico de licencias emitidas, un donut de estado de licencias y un desglose por producto.
El resumen de Inicio — resumen del plan, recuentos destacados, gráficos y renovaciones próximas.

Products

Lista tus productos (GET /admin/products), cada uno mostrando sus niveles como insignias (con recuentos de puestos y derechos) y recuentos de licencias.

  • Add product — nombre + slug; el slug es lo que el SDK de tu aplicación envía como Product.
  • Tiers — añade o edita un nivel por producto (puestos + una plantilla de derechos aplicada a las nuevas licencias de ese nivel).
  • Enable trials — define una duración de prueba, nivel y puestos para activar las pruebas gratuitas de autoservicio del producto. Consulta Pruebas gratuitas de autoservicio para el flujo de cara al cliente.
Pestaña Products del panel de Keyright: una tabla de productos con su slug, fecha de creación, insignias de nivel y recuentos de licencias, más un botón Add product y un enlace Manage por fila.
La pestaña Products — cada producto con sus niveles y recuentos de licencias.

Licenses

La tabla de licencias (GET /admin/licenses), filtrable por producto.

  • Issue — elige un producto y nivel, define titular, puestos, caducidad y email de contacto; la clave se genera por ti. Las acciones por fila cubren revoke, renew, transfer, deactivate por máquina y la generación de un offline lease para una máquina aislada (air-gapped).
  • Al profundizar en una licencia se muestran sus activaciones — las máquinas en las que está activa, con metadatos del dispositivo y ubicación aproximada — para que puedas ver dónde están en uso los puestos y liberar uno si un dispositivo ha desaparecido.
Tabla Licenses del panel de Keyright: clave de licencia, titular, producto, nivel, puestos, puestos usados, caducidad (perpetua o una fecha), insignias de estado incluida Trial, y acciones Machines y Renew por fila, con filtros de producto/estado/tiempo y un cuadro de búsqueda.
La tabla Licenses — filtra, emite y actúa por fila. Las licencias perpetuas, por plazo y de prueba (Trial) se marcan en línea, con puestos usados frente al total.

Team

Gestiona quién puede acceder al espacio de trabajo (/admin/team, solo owner). Roles:

RolPuede hacer
ownerTodo, incluida la gestión del equipo, el espacio de trabajo, la facturación y el secreto del webhook.
adminEmitir/revocar/gestionar licencias, productos, niveles, revendedores.
supportAsistir a clientes: liberar puestos, desactivar máquinas.
billingAcceso relacionado con facturación/plan.
viewerSolo lectura.

Invitar a un miembro le envía por email un token de un solo uso (cuando SMTP está configurado); el panel también muestra el token una vez para que puedas compartirlo manualmente si el email no está configurado.

Pestaña Team del panel de Keyright: una tabla de miembros con nombre, email, rol (admin, support, billing), una insignia de estado Enabled y una acción Disable por fila, más un botón Add member.
La pestaña Team — miembros y sus roles, cada uno habilitado o deshabilitado de forma independiente.

Integration

La pestaña de entrega al desarrollador (GET /admin/account), todo lo que pegas en el SDK de tu aplicación y en tu proveedor de pagos:

  • Endpoints — la URL base de tu servicio más las URLs activate / validate.
  • Signing public key — la clave base64 para embeber en tu compilación distribuida (la validación se hace contra esta; la clave privada nunca sale del servidor).
  • Webhook — la URL y el secreto del webhook de fulfillment por tenant (rótalo aquí); conecta tu tienda a él para que los pedidos pagados emitan claves automáticamente.
Pestaña Integration del panel de Keyright: un resumen For developers, una tabla de endpoints de la API (slug del espacio de trabajo, URLs de validate/activate/webhook de fulfillment), el paso de instalar el SDK y el cuadro Embed your public key mostrando la clave pública de firma en base64.
La pestaña Integration — endpoints, el paso de instalación del SDK y la clave pública a embeber (la clave privada nunca sale del servidor).

Consulta Primeros pasos y las guías de integración de los SDK para saber qué hacer con esto.

Settings

Ajustes a nivel de espacio de trabajo (owner):

  • Nombre y logo del espacio de trabajo — el nombre visible y el logo de la empresa mostrados en todo el panel (POST /admin/workspace). Esto es una comodidad por espacio de trabajo y es independiente del white-labeling completo en una instancia autoalojada, que se configura mediante las variables de entorno KEYRIGHT_BRAND_* (una característica Enterprise que cubre el panel, el portal y los emails) — consulta Autoalojamiento → Configuración.
  • Plan y mejora — tu plan y cuotas actuales; Upgrade abre un checkout de Lemon Squeezy (POST /admin/billing/checkout), y tu plan cambia automáticamente una vez que arranca la suscripción.
Settings del panel de Keyright: un campo Workspace name, un campo de carga/URL de logo de empresa con un botón Save, y una tarjeta Plan & billing mostrando el plan actual.
Settings — nombre del espacio de trabajo, logo de la empresa y plan.

Véase también