Skip to content
← Todas las publicaciones
· Delta1 Labs LicensingKeyright

Derechos de licencia frente a feature flags

Un feature flag es un interruptor operativo que tú controlas; un derecho de licencia es una concesión comercial firmada por la que el cliente pagó. Si los confundes, un cliente activa un flag y desbloquea lo que nunca compró. Este artículo traza la línea, muestra los fallos de usar la herramienta equivocada, ofrece una tabla de decisión y conecta la arquitectura combinada de Keyright: los derechos como la barrera dura y los feature flags por encima para el despliegue dentro de lo que el cliente tiene derecho.

Usa un sistema de feature flags para controlar una función de pago y el código parece correcto el primer día. flags.IsEnabled("advanced-reports") envuelve el botón de exportar, el interruptor está apagado para los usuarios gratuitos y encendido para los de pago, y la demo funciona. Luego un cliente abre el almacén de flags que le entregaste, activa el interruptor y obtiene una función que nunca compró; o tu servicio de despliegue tiene una mala tarde, el cliente recurre a su valor por defecto y cada instalación desbloquea de más o de menos a la vez. Nada fue hackeado. La herramienta simplemente era la equivocada: un feature flag es un interruptor operativo y lo usaste para trazar una frontera comercial.

Este artículo traza la línea entre ambos, muestra qué se rompe cuando la cruzas y luego los conecta de la forma correcta en una aplicación .NET licenciada con Keyright: los derechos como la barrera dura y los flags por encima para el despliegue dentro de aquello a lo que el cliente tiene derecho.

Dos herramientas que se parecen y no lo son

Ambas responden una pregunta de sí/no sobre si una capacidad debe ejecutarse, así que es fácil confundirlas. La diferencia está en quién controla la respuesta y en si esa respuesta es fiable.

Un feature flag es un interruptor mutable que tú controlas. Tú lo pones, lo cambias, lo despliegas al 5% de las cuentas y luego a todas, lo retiras cuando termina un experimento. Es un mecanismo de operaciones y entrega. No tiene integridad criptográfica porque no la necesita: quien lee el flag (tu aplicación) y quien lo pone (tú) están del mismo lado.

Un derecho de licencia es una concesión firmada y a prueba de manipulaciones ligada a lo que el cliente pagó. El cliente tiene la licencia; tú tienes la clave privada que la firmó. La aplicación verifica la firma contra una clave pública embebida, de modo que el conjunto de derechos no puede ser falsificado ni editado por la parte a la que restringe. Es una frontera comercial, y todo su valor está en que la persona al otro lado no puede activarla por sí misma.

firmadomutableoperativocomercialFirmado + operativosobredimensionado: reemitirpara ajustar un despliegueDerecho de licencialo que el cliente pagó;verificable, sin conexiónFeature flagtu interruptor de despliegue;cambia en segundosMutable + comercialla fuga de ingresos: el clienteactiva el interruptor y lo abre

Fallo 1 — flags para licenciar

Controla una capacidad de pago con un flag y heredas tres problemas a la vez.

Se evade trivialmente. Sea lo que sea que almacena el flag —un archivo de configuración, una base de datos local, una caché que el SDK escribe en disco— está al alcance del cliente. No hay firma sobre él, así que editarlo no tiene consecuencia detectable. La «frontera» es un booleano que la parte restringida puede poner en true.

No hay historia sin conexión. Un servicio de flags alojado responde por la red; cuando no se puede alcanzar, el cliente sirve un valor por defecto. Un valor por defecto es una buena respuesta a «¿debería estar activo este experimento?» y una respuesta pésima a «¿compró esto el cliente?». Acabas eligiendo entre fallar abierto (regalar funciones de pago durante una caída) y fallar cerrado (romper funciones que tu cliente pagó legítimamente porque tu servicio parpadeó).

No hay integridad, así que no hay auditoría. Cuando surge una disputa sobre a qué tenía derecho un cliente, una licencia firmada es prueba: dice qué se concedió, por quién, hasta cuándo, y la firma demuestra que no se alteró. El valor de un flag es solo una fila que alguien pudo haber escrito.

Fallo 2 — derechos para un despliegue por fases

El error inverso es más sutil. Supón que lanzas un nuevo motor de informes y quieres activarlo para el 5% de los clientes con derecho el lunes, el 50% el miércoles y todos el viernes: un despliegue clásico. Si lo modelas con el derecho, cada ajuste del dial es una reemisión: una nueva licencia firmada, un viaje por tu canalización comercial, una reactivación del lado del cliente. Los derechos son deliberadamente caros de cambiar porque representan dinero; ese coste es justo el equivocado para una perilla operativa que quieres girar tres veces por semana. Además estarías acuñando concesiones comerciales para una decisión que no tiene nada que ver con lo que nadie pagó, contaminando aquello cuyo único valor es reflejar solo la compra.

La tabla de decisión

DimensiónFeature flagDerecho de licencia
IntegridadNinguna: un valor mutable, sin firmaFirmado criptográficamente, a prueba de manipulaciones
Quién lo controlaTú (proveedor), en tiempo de ejecuciónConcedido por ti, en manos del cliente, verificado por la app
Comportamiento sin conexiónRecurre a un valor por defecto; suele necesitar la redValidado localmente con la clave pública embebida; falla cerrado
Latencia de cambioSegundos: lo activas y está en vivoUna reemisión: nueva firma, reactivación
AudienciaUna cohorte que eliges (porcentaje, anillo, cuenta)El cliente concreto y lo que compró
Trabajo adecuadoDespliegue, experimentos, interruptores de corte, perillas operativasFronteras comerciales: ediciones, topes de asientos, capacidades de pago

Lee la tabla como una sola regla: si la respuesta debe sobrevivir a que el cliente sea adversario y a que la red esté caída, es un derecho; si necesitas cambiarla rápido y deberías ser el único que pueda, es un flag.

Derechos en Keyright

Un derecho de Keyright se lee de una licencia validada localmente. Inicializas el cliente una vez con tu nombre de producto y tu clave pública de solo verificación, y luego validas, sin conexión, contra la clave embebida.

using Keyright;

static readonly KeyrightClient License = KeyrightClient.Initialize(new KeyrightOptions
{
    Product         = "acme-analytics",
    PublicKeyBase64 = "MIIBIjANBgkq...",                 // verify-only; ships in the binary
    ServiceUrl      = "https://keyright.example.com",    // only needed to activate online
});

// Local, no network: verifies signature, expiry, node-lock and the entitlement set.
// Never throws for license state; fails closed to Community Edition.
LicenseInfo info = await License.ValidateAsync();

bool canExport = info.Entitlements.IsEnabled("advanced-reports");

info.Entitlements es el conjunto firmado por el que el cliente pagó. IsEnabled es una lectura local pura —sin llamada de red— y, como la validación falla cerrado, una licencia ausente, caducada o manipulada se resuelve a Community Edition con el derecho leyendo false. Esa es la barrera dura: la capacidad no está disponible salvo que la concesión firmada diga lo contrario, y nada que el cliente pueda editar cambia esa respuesta.

Componer un flag con un derecho

Ahora la arquitectura real: las dos herramientas en capas, no sustituidas. El derecho decide si este cliente puede tener alguna vez la capacidad; el flag decide si ya la hemos activado para él. El orden no es negociable: el derecho hace de barrera, el flag solo estrecha.

public sealed class ReportService
{
    private readonly IFeatureFlags _flags;   // your rollout system (OpenFeature, homegrown…)

    public ReportService(IFeatureFlags flags) => _flags = flags;

    public async Task<IActionResult> RunAdvancedReport(ReportRequest req)
    {
        LicenseInfo info = await License.ValidateAsync();

        // 1. Hard gate: did the customer PAY for this capability? Signed, offline, fail-closed.
        if (!info.Entitlements.IsEnabled("advanced-reports"))
            return Forbid("advanced-reports is not part of your plan");

        // 2. Rollout narrowing: is the new engine turned on for this account yet?
        //    This can only withhold a paid feature during rollout — never grant an unpaid one.
        if (!_flags.IsEnabled("advanced-reports-v2-rollout"))
            return await RunLegacyReport(req);

        return await RunReportV2(req);
    }
}

Lee las dos comprobaciones. La del derecho es portante: elimínala y cualquier cuenta alcanza la función. La del flag es estrechante: elimínala y los clientes con derecho simplemente reciben todos v2 a la vez, una decisión de despliegue, nunca de seguridad. Como el flag está dentro de la rama de éxito del derecho, es estructuralmente imposible que un flag desbloquee una capacidad no pagada. Lo peor que puede hacer un flag mal configurado es mantener un rato a un cliente que paga en la ruta heredada.

La misma composición expresa un despliegue por fases de una capacidad de pago totalmente nueva. Dale el derecho en cuanto se venda, y luego protege el encendido real tras un flag de porcentaje para controlar el radio de impacto, sin dejar jamás que el flag se convierta en lo que decide si el cliente la compró.

if (info.Entitlements.IsEnabled("live-collaboration")
    && _flags.IsEnabled("collab-ga-rollout"))
{
    EnableCollaboration();
}

El && se lee de izquierda a derecha y ese es todo el diseño: primero el derecho porque es la verdad comercial, segundo el flag porque es la perilla operativa. Invierte los operandos y habrás reconstruido el Fallo 1.

Dónde encajan los límites numéricos

El mismo reparto aplica a las fronteras cuantitativas. Un tope de asientos es comercial —está en la licencia firmada— así que pertenece al lado del derecho:

long maxSeats = info.Entitlements.GetLimit("max-seats", defaultValue: 1);
if (activeSeats >= maxSeats)
    return Forbid("seat limit reached for your plan");

Un flag podría entonces controlar cómo fuerzas una situación de exceso durante un despliegue —bloqueo duro frente a aviso de gracia— pero el número en sí, lo ligado al dinero, se queda en el derecho donde está firmado y es verificable sin conexión.

La regla, en una línea

Controla lo que el cliente pagó con un derecho de Keyright: firmado, a prueba de manipulaciones, verificado sin conexión, cambiado solo por una reemisión deliberada. Controla cómo y cuándo lo despliegas con un feature flag: rápido, tuyo, desechable. Mantén el flag estrictamente dentro del sí del derecho y los dos se refuerzan en lugar de que uno deshaga al otro en silencio.

Prueba Nebula.NET

Endurece tu código .NET en minutos — empieza con la edición gratuita.