DRM-X 6.0 logo de la colombe et de la branche d'oliveDRM-X 6.0Documentation
◎ Français

Modèles prédéfinis et politiques personnalisées

Choisissez une politique de licence DRM-X qui correspond au paquet publié, y compris les durées, la protection des sorties et les niveaux de qualité.

Voir le MarkdownExemples en ligneMis à jour le 2026-10-26

Choisissez une politique pour votre contenu

La politique doit correspondre au modèle de clés utilisé pour chiffrer la vidéo.

  1. Single Key Protection

    Appliquez une même politique à toutes les pistes : single-software, single-hdcp ou single-hardware.

  2. Multi-key Quality Tiered

    Utilisez multi-tier-standard pour appliquer des règles de sécurité distinctes à l’audio, à la SD, à la HD et à l’UHD.

Choisissez une politique correspondant au modèle de clé de paquet. Single-key utilise une règle uniforme; les paquets triés utilisent des règles de piste distinctes.
Politique de licence

Utiliser un modèle de politique nommé côté serveur#

Protection par clé vidéo unique

Toutes les variantes vidéo partagent une clé vidéo. Le son chiffré utilise une clé audio distincte. Les contenus uniquement audio utilisent une clé audio.

Une clé identifie le contenu chiffré ; une règle de politique définit ses conditions d’accès. Avec Single Video Key Protection, une règle ALL applique les mêmes conditions à la clé vidéo et à toute clé audio chiffrée. Cela ne signifie pas que l’audio et la vidéo partagent une clé. Les paquets Multi-key Quality Tiered utilisent des règles AUDIO et de qualité vidéo distinctes.

Les modèles nommés suppriment la plupart des polices JSON du code d'application. DRM-X élargit le nom sélectionné à une politique canonique v2, la valide contre le paquet réel et signe le résultat dans le DRM License Token.

Choisissez une politique pour votre contenu

La politique doit correspondre au modèle de clés utilisé pour chiffrer la vidéo.

  1. Single Key Protection

    Appliquez une même politique à toutes les pistes : single-software, single-hdcp ou single-hardware.

  2. Multi-key Quality Tiered

    Utilisez multi-tier-standard pour appliquer des règles de sécurité distinctes à l’audio, à la SD, à la HD et à l’UHD.

Utilisez le modèle qui correspond au modèle clé sélectionné lorsque le contenu a été emballé.
DénominationModèle d'emballageComportement
single-softwareClé uniqueCompatibilité étendue, logiciel DRM, pas de minimum HDCP.
single-hdcpClé uniqueLogiciels DRM avec HDCP Protection de sortie 1.x-class.
single-hardwareClé uniqueSécurité matérielle DRM avec protection de sortie HDCP de la classe 2.2.
multi-tier-standardMulti-clésLogiciel audio/SD, logiciel HD + HDCP, matériel UHD1 + 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"
}

Avec useEnvironmentDefaults: true, le modèle fournit la sécurité pendant que les paramètres d'environnement sauvegardés contrôlent DRM License Token la validité, les flux simultanés et le renouvellement. false lorsque vous voulez que le modèle corresponde à des valeurs opérationnelles précises.

Les applications peuvent découvrir les intégrés actuels via GET /api/v1/playback/license-policy-templates. Les noms de modèles sont insensibles aux cas sur l'entrée et canonicisés dans la demande.

Politique de licence

Envoyer une politique complète sur l'heure des requêtes personnalisée#

Utilisez licensePolicy lorsqu'un modèle nommé n'exprime pas la règle de votre entreprise. N'envoyez pas licensePolicyTemplate dans la même requête.

{
  "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
    }
  }]
}

Règles qui échouent closes

  • La politique JSON est limitée à 16 KiB, doit utiliser policy_version: 2 et peut contenir au plus sept règles de piste uniques.
  • Le contenu à clé unique nécessite une règle ALL, allowed_track_types: ALL, et un plafond de qualité automatique.
  • Les règles à clés multiples peuvent cibler AUDIO, SD, HD, UHD1 ou UHD2.
  • max_stream_per_user: 0 désactive DRM-X limite la circulation simultanée pour ce jeton.
  • expiresInSeconds est DRM License Token validité (60-7200 secondes). Il est séparé de DRM durées de licence et de lecture.
La personnalisation appartient à votre serveurCarter des plans d'abonnement de confiance, des fenêtres de location, des cotes de contenu, ou des classes d'appareils à des objets de politique approuvés. Jamais faire suivre une politique reçue du navigateur ou de l'entrée mobile.