Proteger un Live stream con multi-DRM

Available in: UI · API

Usa este how-to cuando un Live stream deba llegar a clientes web, Windows y Apple con DRM aplicado en todas las plataformas. El modelo de integración es el mismo en cualquier superficie: registra un DRM provider una vez y asócialo a cada Destination protegido.

Cuándo usar esto

Cuando un Destination DASH, CMAF o HLS / TS sobre un Live stream deba cifrar segmentos y llevar las URLs de licencia en el manifest. Para la referencia conceptual consulta DRM.

Prerrequisitos

• El rol System Administrator. El CRUD de DRM providers está reservado a ese rol; los Operators no pueden registrar, validar, editar ni borrar proveedores.
• Una cuenta con un proveedor multi-DRM. El catálogo publica hoy AXINOM y EZDRM. El proveedor te facilita un endpoint SPEKE, las credenciales que espera la marca y — para las marcas que lo requieran — un tenant id.
• Un Destination DASH, CMAF o HLS / TS en el Live stream que llevará la salida protegida.

Via UI

Navegación: Integrations → DRM → Providers.

Via API

CRUD del DRM provider:

El bloque DRM de un Destination se asigna mediante addPublishing / updatePublishing:

# 1. Registra el proveedor
curl -X POST "https://<tu-host>/c21apiv2/settings/integrations/drmproviders" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyDRMProvider",
    "provider_type": "AXINOM",
    "speke_url": "https://drm-axinom.example/speke/v2",
    "tenant_id": "<tenant>",
    "credentials": { "...": "..." },
    "enabled": true
  }'

# 2. Valida
curl -X POST "https://<tu-host>/c21apiv2/settings/integrations/drmproviders/<providerId>/validate" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

# 3. Asocia a un Publishing DASH/CMAF/HLS existente
curl -X PUT "https://<tu-host>/c21apiv2/publishings/<publishingId>" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "drm": {
      "active": true,
      "provider_id": <providerId>,
      "contentid": "<content id del proveedor>",
      "systems": ["Widevine", "PlayReady"],
      "encryption_mode": "cenc"
    }
  }'

validation_status lleva UNKNOWN (recién registrado), VALID (validación correcta) o INVALID (validación fallida). Patrones habituales:

Verificar

• La fila del proveedor muestra Validation status: VALID.
• GET /c21apiv2/publishings/{publishingId} devuelve el bloque drm con active: true y los systems / encryption_mode esperados.
• Reproductores de cada ecosistema descifran y reproducen correctamente la salida protegida:

El dashboard del proveedor upstream registra una emisión de licencia por sesión y ecosistema.

FAQ