Ir al contenido
For Sellers

Claves de licencia y activación por dominio para el código que vendes

Qué puede y qué no puede hacer un sistema de claves de licencia de software cuando vendes código fuente legible, cómo funciona la activación por dominio y cómo añadir a tu instalador una comprobación de licencia única mediante una API de verificación de licencias, con un plan de pruebas.

• Nov 17, 2026 • 13 min de lectura
Claves de licencia y activación por dominio para el código que vendes

Un sistema de claves de licencia de software para código fuente cumple tres funciones: demuestra que un comprador ha adquirido el producto, registra dónde está instalado el producto y permite que tu código adapte su comportamiento a la edición que posee el comprador. No hace imposible copiar código fuente legible, y tratar de conseguirlo suele perjudicar más a los compradores honrados que a los piratas. El enfoque que mejor funciona para la mayoría de los vendedores es sencillo: pide la clave una vez en el instalador, verifícala en el servidor contra una API de licencias, vincúlala al dominio de la instalación y después no estorbes.

Esta guía explica cómo funciona y cómo añadirlo a tu producto. Forma parte de nuestra guía más amplia sobre cómo vender el código fuente de tu aplicación web o SaaS. En AppTrovo, cada venta emite automáticamente una clave de licencia, con activación por dominio y una API de verificación de licencias, así que no tienes que construir el servidor de licencias tú mismo, solo la pequeña comprobación del lado del cliente en tu instalador.

Si solo quieres la referencia de la API, ve directamente a la guía de integración de licencias. Sigue leyendo para conocer el razonamiento, las ventajas e inconvenientes y un plan de pruebas.

¿Qué puede proteger realmente una clave de licencia?

Cuando vendes código fuente legible, una persona decidida siempre puede eliminar una comprobación de licencia. Ser honesto al respecto te ayuda a diseñar algo útil en lugar de algo molesto.

Un sistema de claves de licencia puedeUn sistema de claves de licencia no puede
Confirmar que un comprador tiene una compra válida antes de la instalaciónImpedir que alguien borre la comprobación en un código legible
Registrar en qué dominios está activada una licenciaEvitar que un comprador comparta un archivo ZIP
Indicar a tu código qué edición posee el compradorSustituir a un acuerdo de licencia claro
Mostrar si el soporte y las actualizaciones están activosGarantizar el pago en todos los casos
Darte un registro limpio al gestionar soporte o disputasCompensar un producto en el que los compradores no confían

Piensa en la clave de licencia como un recibo con una dirección, no como un candado. La mayoría de los compradores de software empresarial son honrados y quieren cumplir la licencia, sobre todo cuando las actualizaciones y el soporte dependen de ello. La clave hace que el camino honrado sea el fácil.

¿Deberías ofuscar o codificar tu código?

Algunos vendedores intentan proteger sus scripts PHP codificándolos u ofuscándolos. En un marketplace de código fuente, eso suele ser un error:

  • Los compradores pagan por el código fuente. La razón por la que eligen una aplicación autoalojada es poder leerla, auditarla y modificarla. Los archivos codificados eliminan ese valor.
  • Los codificadores añaden requisitos de alojamiento, como cargadores especiales, que provocan fallos de instalación y tickets.
  • La ofuscación también te oculta los errores a ti y hace imposible que el comprador realice una revisión de seguridad.
  • Rara vez frena la piratería. Las copias piratas de productos codificados circulan de todos modos.

Dedica el esfuerzo a lo que hace que pagar merezca la pena: actualizaciones, soporte, documentación y funciones de la edición Comercial. Eso es lo que una copia pirata nunca obtiene.

Cómo funciona la activación por dominio

La activación por dominio vincula una clave de licencia a los lugares donde está instalado el producto. El flujo en AppTrovo es el siguiente:

  1. El comprador adquiere el producto y recibe una clave de licencia única (un UUID).
  2. Durante la instalación, tu instalador envía desde el servidor la clave y el dominio de la instalación a la API de verificación de licencias.
  3. Si la clave es válida y hay un hueco de activación libre, el dominio queda registrado en la licencia y la respuesta lo confirma.
  4. Volver a ejecutar el instalador en el mismo dominio no consume otro hueco.
  5. Si el comprador se traslada a un nuevo servidor o dominio, desactiva el dominio antiguo desde su panel y activa el nuevo. Consulta gestionar las activaciones de dominio.

Cada licencia tiene un número limitado de huecos de activación, y la respuesta de verificación te indica cuántos están usados (activations_used) y disponibles (activations_limit). Ese límite permite a un comprador tener un sitio en producción y una copia de staging sin consultarte, y a la vez desincentiva las instalaciones en decenas de dominios sin relación. Lo que la licencia permite legalmente lo definen los términos de la licencia, no el número de huecos.

¿Verificar una vez o llamar a casa?

Hay tres estrategias habituales para decidir cuándo comprueba tu código la licencia. Esta elección importa más que cualquier otra decisión sobre licencias, porque determina si las licencias pueden romper el sitio en producción de un comprador.

EstrategiaCómo funcionaRiesgo para los compradoresRecomendación
Verificar una vez al instalarEl instalador comprueba la clave; después la aplicación funciona con normalidadMuy bajo; un problema de red solo afecta al instaladorOpción recomendada por defecto
Recomprobación periódicaUna tarea programada verifica la clave cada día o cada semanaMedio; las caídas, los cortafuegos o los límites de peticiones pueden provocar falsos fallosEvítala salvo que tengas un motivo de peso
Comprobar en cada peticiónCada carga de página llama al servidor de licenciasAlto; ralentiza todas las páginas y convierte tu servidor en un punto único de falloNo la uses

La guía de integración de AppTrovo recomienda verificar una vez: cuando el instalador termina correctamente, el producto escribe una marca de «instalado» y no vuelve a llamar a la API nunca más. La aplicación en producción de un comprador nunca debería dejar de funcionar porque no se pudo acceder a un servidor de licencias durante un problema de red.

Cómo añadir una comprobación de licencia a tu instalador

La API de verificación es una única petición GET a /api/v1/licenses/verify con el license_key y, opcionalmente, tu product_slug y el domain de la instalación. Se recomienda enviar el slug del producto, porque garantiza que la clave pertenece a tu producto y no a otro. Este es el flujo del instalador paso a paso:

  1. Pide la clave. Añade a tu instalador web un paso de licencia con un único campo. El comprador no debería tener que escribir el nombre de un producto ni editar archivos de configuración; define el slug de tu producto en tu propia configuración antes de empaquetar el ZIP.
  2. Verifica en el servidor. Llama a la API desde tu backend con un tiempo de espera corto y la verificación SSL activada. Nunca verifiques desde JavaScript en el navegador y nunca pongas secretos en código del lado del cliente.
  3. Envía el dominio. Pasa el host de la instalación para que la activación quede registrada con él.
  4. Gestiona la respuesta. Si valid es verdadero, guarda localmente lo que necesites: la edición a partir de license_type, el nombre del licenciatario y las fechas de soporte si tu área de administración las muestra. Si es falso, muestra el failure_reason en un lenguaje claro y deja que el comprador lo intente de nuevo.
  5. Marca la instalación como completada. Escribe la marca de instalado y continúa con los pasos de la base de datos y del usuario administrador. La función version_compare() de PHP también resulta útil más adelante si tu área de administración compara la versión instalada con la última publicada. A partir de aquí, no se ejecuta ningún código de licencias.

Para productos Laravel hay un SDK de instalador listo para usar, con un controlador de instalación ya preparado y un pequeño middleware que solo comprueba la marca de instalado. La lista completa de parámetros, los campos de la respuesta y los motivos de fallo están en el artículo sobre la API de verificación de licencias y en la guía de integración. La API tiene un límite de peticiones (120 por minuto por IP en el momento de escribir esto), otro motivo más para no comprobar en cada petición.

Guarda el resultado de forma segura

Trata la clave de licencia como cualquier otra credencial: mantenla fuera de los directorios públicos, de los registros y del frontend. La OWASP Secrets Management Cheat Sheet ofrece pautas generales sobre cómo manejar claves y tokens en las aplicaciones.

Limita funciones por edición, no por dominio

Los productos de AppTrovo vienen exactamente en dos ediciones: una edición Community gratuita y con funciones limitadas (los compradores pueden usarla en producción, sin soporte del autor) y una Licencia Comercial de pago que desbloquea todas las funciones. No existe un tercer nivel. La respuesta de verificación te indica cuál tiene el comprador en license_type (community o commercial, además de developer para tus propias claves de prueba).

  • Limita según license_type, no según el slug del objeto de edición. El slug interno de la edición Comercial es un identificador permanente que no dice «commercial», así que license_type es el campo pensado para limitar funciones.
  • Guarda la edición durante la instalación en tu tabla de ajustes y léela localmente en tiempo de ejecución.
  • Decide con claridad qué incluye cada edición y dilo en la ficha del producto. Los límites ocultos que aparecen después de la instalación parecen una trampa.

La respuesta también incluye product.retired. Si alguna vez retiras un producto, las licencias existentes siguen verificándose y tu área de administración puede mostrar un aviso discreto de que no hay más actualizaciones previstas.

Gestiona el desarrollo, el staging y los cambios de servidor

Un sistema de licencias que ignora los flujos de trabajo reales genera tickets. Prevé estos casos:

  • Desarrollo local. Los compradores instalan primero en localhost o en un dominio .test. Decide si tu instalador lo cuenta como una activación; muchos vendedores omiten el dominio en los hosts locales.
  • Copias de staging. Los huecos de activación existen para que un sitio de staging no necesite una segunda licencia. Menciónalo en tu documentación.
  • Migraciones de servidor. Documenta los pasos: desactiva el dominio antiguo en el panel, mueve los archivos y vuelve a ejecutar el paso de licencia o el instalador en el nuevo dominio.
  • Agencias que instalan para clientes. Explica qué dominio debe activarse y quién debe conservar la clave. Remite a los términos de la licencia para el uso con clientes.

Prueba tu integración antes de enviarla

No tienes una licencia de pago de tu propio producto, así que AppTrovo permite a todos los autores generar una licencia de prueba para desarrolladores gratuita desde la página de edición del producto. Solo se activa en dominios locales como localhost, 127.0.0.1 o hosts que terminen en .test o .local, caduca a los 30 días y se puede prorrogar. Los autores nuevos que todavía no tienen un producto pueden usar una licencia sandbox para probar el flujo. Ejecuta estos escenarios:

EscenarioCómo provocarloResultado esperado
Clave válida, dominio nuevoInstalación limpia en localhostEl instalador continúa y guarda la edición
Clave válida, mismo dominio otra vezVuelve a ejecutar el instalador en el mismo hostEl instalador continúa; no se consume ninguna activación adicional
Sin huecos libresActiva el número máximo de dominios locales y luego uno másMensaje claro que explica cómo desactivar un dominio
Clave no válidaIntroduce un UUID aleatorioError claro; el instalador permanece en el paso de licencia
Clave caducadaUsa una clave de prueba caducadaMensaje claro de «la licencia ha caducado»
Fallo de redBloquea el host de la API en tu equipoError amable con un botón para reintentar, no una página en blanco

Antes de empaquetar, elimina cualquier indicador de omisión para desarrollo que hayas añadido durante las pruebas y asegúrate de que la URL base de la API apunta a producción.

Redacta el paso de licencia pensando en personas

La pantalla de licencia suele ser lo primero que ve un comprador después de subir tus archivos. Unos cuantos detalles la hacen amable:

  • Indica a los compradores dónde encontrar su clave (para los compradores de AppTrovo, la sección Licencias de su panel).
  • Acepta la clave con o sin espacios alrededor, y recórtalos.
  • Convierte los motivos de fallo de la API en pasos siguientes: «Esta clave no tiene huecos de activación libres. Desactiva en tu panel un dominio que ya no uses y vuelve a intentarlo.»
  • Enlaza a tu página de resolución de problemas para los errores de licencia. Nuestra guía sobre documentación que reduce los tickets de soporte muestra cómo redactar esas entradas.

Preguntas frecuentes

¿Necesito construir mi propio servidor de licencias para vender código?

No en AppTrovo. Cada venta emite una clave de licencia, los compradores gestionan las activaciones de dominio desde su panel y tú verificas las claves mediante la API de verificación de licencias. Tu trabajo se limita a un pequeño paso de licencia en tu instalador. Si también vendes en tu propio sitio, necesitarás una solución de licencias aparte para esas ventas.

¿Puede una clave de licencia frenar la piratería de scripts PHP?

Ninguna comprobación de licencia puede impedir del todo que alguien edite código fuente legible. Lo que sí hace es confirmar las compras, registrar las instalaciones y conectar a los compradores con las actualizaciones y el soporte. La mejor respuesta a la mayor parte de la piratería es hacer que el producto de pago sea claramente más valioso, mediante actualizaciones, soporte y funciones de la edición Comercial.

¿Qué ocurre si el servidor de licencias está caído durante la instalación?

Con el patrón de verificar una vez, solo se ve afectado el instalador. Muestra un error amable con una opción para reintentar y conserva lo que haya introducido el comprador. Una vez instalada, la aplicación nunca depende del servidor de licencias, así que una caída posterior no puede afectarla.

¿Cómo traslada un comprador su licencia a un nuevo dominio?

Desactiva el dominio antiguo desde su panel, lo que libera el hueco de activación, y luego ejecuta el paso de licencia en el nuevo dominio. Documéntalo en tu guía de instalación o de migración para que los compradores no tengan que contactarte.

¿Debería la edición Community requerir una clave de licencia?

Las licencias Community también tienen claves, y la respuesta de verificación las indica como community. Usar el mismo flujo de instalación para ambas ediciones mantiene tu código más sencillo y te permite habilitar las funciones de la edición Comercial cuando un comprador adquiere más adelante la Licencia Comercial e introduce la nueva clave.