DRM-X 6.0 paloma y rama de olivo logotipoDRM-X 6.0Documentación
◎ Español

Plantillas predefinidas y políticas personalizadas

Elija una DRM-X política de licencia que coincida con el paquete publicado, incluyendo duraciónes, protección de salida, y niveles de calidad.

Ver MarkdownEjemplos en funcionamientoActualizado el 2026-10-26

Elige una política para tu contenido

La política debe coincidir con el modelo de claves usado para cifrar el vídeo.

  1. Single Key Protection

    Usa una misma política para todas las pistas: single-software, single-hdcp o single-hardware.

  2. Multi-key Quality Tiered

    Usa multi-tier-standard para aplicar distintas reglas de seguridad al audio, SD, HD y UHD.

Elija una política que coincida con el modelo clave del paquete. Single-key utiliza una regla uniforme; los paquetes empatados usan reglas de pista separadas.
Política de licencia

Usar una plantilla de política llamada lado servidor #

Protección con una única clave de vídeo

Todas las versiones de vídeo comparten una clave de vídeo. El audio cifrado utiliza una clave de audio independiente. El contenido solo de audio utiliza una clave de audio.

Una clave identifica el contenido cifrado; una regla de política define sus requisitos de acceso. En Single Video Key Protection, una regla ALL aplica los mismos requisitos a la clave de vídeo y a cualquier clave de audio cifrado. Esto no significa que el audio y el vídeo compartan una clave. Los paquetes Multi-key Quality Tiered utilizan reglas AUDIO y de calidad de vídeo independientes.

Las plantillas nombradas eliminan la mayoría de la política JSON del código de aplicación. DRM-X amplía el nombre seleccionado a una política canónica v2, lo valida contra el paquete real, y firma el resultado en el DRM License Token.

Elige una política para tu contenido

La política debe coincidir con el modelo de claves usado para cifrar el vídeo.

  1. Single Key Protection

    Usa una misma política para todas las pistas: single-software, single-hdcp o single-hardware.

  2. Multi-key Quality Tiered

    Usa multi-tier-standard para aplicar distintas reglas de seguridad al audio, SD, HD y UHD.

Utilice la plantilla que coincida con el modelo clave seleccionado cuando el contenido fue empaquetado.
NombreModelo de paqueteComportamiento
single-softwareUna sola claveCompatibilidad amplia, software DRM, no HDCP mínimo.
single-hdcpUna sola claveSoftware DRM con HDCP protección de salida de clase 1.x.
single-hardwareUna sola claveHardware-secure DRM con HDCP 2.2-clase protección de salida.
multi-tier-standardMulti-keySoftware de audio/SD, HD software + HDCP, UHD1 hardware + HDCP 2.2.
{
  "contentId": "course-12-lesson-4",
  "contentType": "vod",
  "drmSystem": "widevine",
  "subject": "customer-user-1001",
  "playbackMode": "streaming",
  "licensePolicyTemplate": "multi-tier-standard",
  "useEnvironmentDefaults": true,
  "maximumQualityTier": "auto"
}

Con useEnvironmentDefaults: true, la plantilla proporciona seguridad mientras que la configuración del entorno guardado control DRM License Token validez, flujos concurrentes y renovación. Establece a false cuando desea los valores operativos exactos de la plantilla.

Las aplicaciones pueden descubrir los actuales incorporados a través de GET /api/v1/playback/license-policy-templates. Los nombres de plantilla son insensibles en la entrada y canonicalizados en la solicitud.

Política de licencia

Enviar una política de tiempo de solicitud personalizada #

Utilice licensePolicy cuando una plantilla no expresa su regla de negocio. No enviar licensePolicyTemplate en la misma solicitud.

{
  "policy_version": 2,
  "playback_policy": {
    "persistent": false,
    "license_duration": 14400,
    "rental_duration": 0,
    "playback_duration": 7200,
    "renewal_duration": 300,
    "allowed_track_types": "ALL",
    "max_stream_per_user": 2
  },
  "security_policy": [{
    "track_type": "ALL",
    "widevine": {
      "security_level": 1,
      "required_hdcp_version": "HDCP_V1",
      "disable_analog_output": true
    },
    "playready": {
      "security_level": 2000,
      "digital_video_protection_level": 250,
      "analog_video_protection_level": 150,
      "digital_audio_protection_level": 100
    },
    "fairplay": {
      "hdcp_enforcement": 0,
      "allow_airplay": true,
      "allow_av_adapter": false
    },
    "wiseplay": {
      "security_level": 1,
      "output_control": 1
    }
  }]
}

Reglas que no se cierran

  • La política JSON se limita a 16 KiB, debe utilizar policy_version: 2, y puede contener en la mayoría de las siete reglas únicas de pista.
  • El contenido de una sola tecla requiere una regla ALL, allowed_track_types: ALL, y un techo de calidad automática.
  • Las reglas multi-key pueden apuntar AUDIO, SD, HD, UHD1, UHD2Los tigres omitidos no reciben llave.
  • max_stream_per_user: 0 deshabilitaciones DRM-X límite de corriente concurrente para ese token.
  • expiresInSeconds es DRM License Token validez (60-7200 segundos). Está separado de DRM licencia y duración de reproducción.
La personalización pertenece a su servidorPlanes de suscripción de confianza en mapa, ventanas de alquiler, clasificaciones de contenido o clases de dispositivos para objetos de política aprobados. Nunca reenvíe una política recibida de navegador o entrada móvil.