Skip to content

Empezar aquí

Visión general

Qué es Keyright, en qué se diferencian Keyright Cloud y el autoalojado, y un mapa de este manual — un servicio de emisión más SDK nativos para archivos de licencia offline y activación en línea.

Keyright es infraestructura de licenciamiento para proveedores de software: un servicio de emisión más SDK nativos para .NET, Node.js, Python y Java que tu aplicación integra para verificar licencias — o, para cualquier otro lenguaje, una pequeña API HTTP que invocas directamente. Emite archivos de licencia offline firmados y leases de activación en línea, aplica bloqueo por equipo y puestos, lleva derechos/niveles, y es multi-tenant con claves de firma RSA por tenant. Cada SDK verifica el mismo formato firmado idéntico, de modo que una línea de productos en varios lenguajes comparte un tenant y una clave pública. Es compatible a nivel de protocolo con el licenciamiento de Nebula.NET.

El servicio de emisión incluye un panel web — así es como se ve tu espacio de trabajo una vez que has creado un producto y emitido unas cuantas licencias:

El Home del panel de Keyright: una barra lateral izquierda (Home, Licenses, Customers, Products, Releases & coverage, Usage & credits, Resellers, Developers, Activity, Settings) con una insignia Self-hosted junto al nombre del espacio de trabajo, cuatro tarjetas de resumen — Active licenses 4 de 6, Active devices 4, Expiring in 30 days 1, Revoked 1 — una lista de verificación 'Finish setting up', un gráfico de licencias emitidas en seis meses, una tabla de próximas renovaciones y un feed de actividad reciente con activaciones de dispositivos y eventos de créditos.
El Home del panel de Keyright — tu espacio de trabajo de un vistazo: totales, una lista de verificación de configuración, próximas renovaciones y la actividad de activación reciente.

Keyright Cloud frente a autoalojado

Keyright se ejecuta en uno de dos modos de despliegue, y este manual cubre ambos en paralelo.

Keyright CloudAutoalojado
Nosotros alojamos el servicio de emisión en keyright.delta1labs.com. Regístrate, crea un espacio de trabajo y empieza a emitir claves — nada que desplegar ni operar.Tú ejecutas el servicio de emisión en tu propia infraestructura (incluso totalmente aislada de la red). Eres dueño de los datos y de la disponibilidad, y el material de licencia nunca sale de tu red.

La parte contra la que construyes es idéntica en ambos casos: el SDK que integras, el formato firmado de licencia y lease, y la clave pública que distribuyes no cambian. Solo difieren dos cosas — la URL del servicio a la que apunta tu aplicación y la credencial de administración que usas para gestionar el espacio de trabajo. A lo largo de la documentación, $BASE es la URL de tu servicio de emisión y $TOKEN es tu credencial de administración (enviada en la cabecera X-Admin-Token).

Cómo usar este manual

A continuación, los mismos destinos agrupados según lo que estés intentando hacer.

Integrar el licenciamiento en tu aplicación

  1. Primeros pasos — la ruta de extremo a extremo: obtén una clave de firma, emite tu primera licencia, verifícala en tu aplicación (offline + en línea) y una lista de comprobación para salir a producción.
  2. Elige tu SDK — un recorrido completo del cliente por lenguaje: .NET, Node.js, Python, Java. ¿No hay SDK para tu lenguaje? Usa la API HTTP directamente (Go, Rust, C++, PHP…) — incluyendo cómo verificar tú mismo la firma de un lease.
  3. Pruebas gratuitas de autoservicio — habilita pruebas por producto, deja que los clientes obtengan por sí mismos una clave de prueba desde tu propio sitio y reparte archivos de prueba offline para evaluadores aislados.

Entender el modelo

  1. Activación y desactivación — cada ruta de activación y desactivación para licencias de prueba, anuales (por plazo) y perpetuas: en línea, offline/aisladas y del lado del proveedor — y exactamente qué ve tu aplicación en cada caso.
  2. Seguridad y el modelo de leases — la explicación honesta de cómo se protegen las claves y los leases, por qué una licencia de un solo puesto no puede ejecutarse en dos máquinas ni siquiera offline, qué significa realmente “a prueba de manipulación” y cómo se renueva y se comporta offline el lease de corta duración.

Operar y administrar

  1. Referencia rápida del panel — un índice breve del panel web en /dashboard: cómo iniciar sesión, las vistas Básico / Intermedio / Avanzado y una tabla de tarea → dónde hacerla.
  2. Referencia de la API HTTP — un mapa legible de cada endpoint (Runtime /v1/*, Admin /admin/*, Platform /platform/*, Auth /auth/*, Plans, Webhooks) con método, ruta y autenticación.

Conceptos clave en un párrafo

Un tenant es un espacio de trabajo de proveedor aislado con su propia clave de firma (RSA; la clave privada se guarda cifrada en reposo y nunca sale del servicio — tu aplicación solo integra la clave pública). Un tenant define productos, cada uno con niveles (número de puestos + plantillas de derechos). Una licencia se emite para un producto/nivel a un licenciatario, con un número de puestos y un vencimiento opcional. Tu aplicación o bien se distribuye con un archivo de licencia offline firmado, o bien realiza activación en línea: hace POST de la clave de licencia + un id de máquina estable a /v1/activate y recibe de vuelta un lease firmado de corta duración vinculado a esa máquina; el SDK verifica el lease contra la clave pública integrada y reactiva antes del vencimiento. Los planes (Free/Starter/Growth/Scale/Enterprise) delimitan las cuotas de un tenant (licencias activas, productos).