Content Key Policies - Get
Obtenir une stratégie de clé de contenu
Obtenir les détails d’une stratégie de clé de contenu dans le compte Media Services
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte Media Services. |
content
|
path | True |
string |
Nom de la stratégie de clé de contenu. |
resource
|
path | True |
string |
Nom du groupe de ressources au sein de l’abonnement Azure. |
subscription
|
path | True |
string |
Identificateur unique d’un abonnement Microsoft Azure. |
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande cliente. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
|
Other Status Codes |
Informations détaillées sur les erreurs. |
Exemples
Get a Content Key Policy by name
Exemple de requête
Exemple de réponse
{
"name": "PolicyWithMultipleOptions",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/contentKeyPolicies/PolicyWithMultipleOptions",
"type": "Microsoft.Media/mediaservices/contentKeyPolicies",
"properties": {
"policyId": "ed7f3d1b-cfa7-4181-b966-e0b3027eec3a",
"created": "2015-12-01T00:00:00Z",
"lastModified": "2016-12-02T00:00:00Z",
"description": "A policy with multiple options.",
"options": [
{
"policyOptionId": "caf1e28c-8288-4301-8c46-c0f9312c512f",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyTokenRestriction",
"issuer": "http://testacs",
"audience": "urn:test",
"primaryVerificationKey": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicySymmetricTokenKey",
"keyValue": ""
},
"alternateVerificationKeys": [],
"requiredClaims": [
{
"claimType": "urn:microsoft:azure:mediaservices:contentkeyidentifier"
},
{
"claimType": "DRM",
"claimValue": "Widevine"
}
],
"restrictionTokenType": "Jwt"
}
},
{
"policyOptionId": "da346259-0cd6-4609-89dc-15ac131bd92f",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyWidevineConfiguration",
"widevineTemplate": "{\"allowed_track_types\":\"SD_HD\",\"content_key_specs\":[{\"track_type\":\"SD\",\"security_level\":1,\"required_output_protection\":{\"hdcp\":\"HDCP_V2\"}}],\"policy_overrides\":{\"can_play\":true,\"can_persist\":true,\"can_renew\":false}}"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyOpenRestriction"
}
}
]
}
}
Définitions
Nom | Description |
---|---|
Content |
Une ressource de stratégie de clé de contenu. |
Content |
Représente une configuration pour les clés non DRM. |
Content |
Spécifie une configuration pour les licences FairPlay. |
Content |
|
Content |
Type de clé de location et de bail. |
Content |
Représente une restriction ouverte. La licence ou la clé sera remise à chaque demande. |
Content |
Représente une option de stratégie. |
Content |
Spécifie une configuration pour les licences PlayReady. |
Content |
Spécifie que l’ID de clé de contenu se trouve dans l’en-tête PlayReady. |
Content |
Spécifie que l’ID de clé de contenu est spécifié dans la configuration PlayReady. |
Content |
Type de contenu PlayReady. |
Content |
Configure les bits de contrôle De restriction de sortie de la télévision analogique explicite. Pour plus d’informations, consultez les règles de conformité PlayReady. |
Content |
La licence PlayReady |
Content |
Type de licence. |
Content |
Configure l’option Lire à droite dans la licence PlayReady. |
Content |
Configure les paramètres de gestion des sorties inconnues de la licence. |
Content |
Type de jeton. |
Content |
Spécifie une clé RSA pour la validation des jetons |
Content |
Spécifie une clé symétrique pour la validation des jetons. |
Content |
Représente une revendication de jeton. |
Content |
Représente une restriction de jeton. Le jeton fourni doit correspondre à ces exigences pour une licence ou une remise de clé réussie. |
Content |
Représente un ContentKeyPolicyConfiguration qui n’est pas disponible dans la version actuelle de l’API. |
Content |
Représente un ContentKeyPolicyRestriction qui n’est pas disponible dans la version actuelle de l’API. |
Content |
Spécifie une configuration pour les licences Widevine. |
Content |
Spécifie un certificat pour la validation de jeton. |
created |
Type d’identité qui a créé la ressource. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Security |
Niveau de sécurité. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
ContentKeyPolicy
Une ressource de stratégie de clé de contenu.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nom de la ressource. |
properties.created |
string |
Date de création de la stratégie. |
properties.description |
string |
Description de la stratégie. |
properties.lastModified |
string |
Date de la dernière modification de la stratégie. |
properties.options |
Options de la stratégie de clé. |
|
properties.policyId |
string |
ID de stratégie hérité. |
systemData |
Métadonnées système relatives à cette ressource. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
ContentKeyPolicyClearKeyConfiguration
Représente une configuration pour les clés non DRM.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
ContentKeyPolicyFairPlayConfiguration
Spécifie une configuration pour les licences FairPlay.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
ask |
string |
Clé qui doit être utilisée comme clé secrète d’application FairPlay. Cela doit être encodé en base64. |
fairPlayPfx |
string |
Représentation Base64 du certificat FairPlay au format PKCS 12 (pfx) (clé privée comprise). |
fairPlayPfxPassword |
string |
Mot de passe de chiffrement du certificat FairPlay au format PKCS 12 (pfx). |
offlineRentalConfiguration |
Stratégie de location hors connexion |
|
rentalAndLeaseKeyType |
Type de clé de location et de bail. |
|
rentalDuration |
integer |
Durée de location. Doit être supérieur ou égal à 0. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Nom | Type | Description |
---|---|---|
playbackDurationSeconds |
integer |
Durée de lecture |
storageDurationSeconds |
integer |
Durée de stockage |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
Type de clé de location et de bail.
Nom | Type | Description |
---|---|---|
DualExpiry |
string |
Double expiration pour la location hors connexion. |
PersistentLimited |
string |
La clé de contenu peut être conservée et la durée valide est limitée par la valeur Durée de location |
PersistentUnlimited |
string |
La clé de contenu peut être conservée avec une durée illimitée |
Undefined |
string |
La durée de la clé n’est pas spécifiée. |
Unknown |
string |
Représente un ContentKeyPolicyFairPlayRentalAndLeaseKeyType qui n’est pas disponible dans la version actuelle de l’API. |
ContentKeyPolicyOpenRestriction
Représente une restriction ouverte. La licence ou la clé sera remise à chaque demande.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
ContentKeyPolicyOption
Représente une option de stratégie.
Nom | Type | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
Configuration de remise de clés. |
name |
string |
Description de l’option de stratégie. |
policyOptionId |
string |
ID d’option de stratégie hérité. |
restriction | ContentKeyPolicyRestriction: |
Conditions requises pour fournir des clés avec cette configuration |
ContentKeyPolicyPlayReadyConfiguration
Spécifie une configuration pour les licences PlayReady.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
licenses |
Licences PlayReady. |
|
responseCustomData |
string |
Données de réponse personnalisées. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
Spécifie que l’ID de clé de contenu se trouve dans l’en-tête PlayReady.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
Spécifie que l’ID de clé de contenu est spécifié dans la configuration PlayReady.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
keyId |
string |
ID de clé de contenu. |
ContentKeyPolicyPlayReadyContentType
Type de contenu PlayReady.
Nom | Type | Description |
---|---|---|
UltraVioletDownload |
string |
Type de contenu de téléchargement ultraviolet. |
UltraVioletStreaming |
string |
Type de contenu de streaming ultraviolet. |
Unknown |
string |
Représente un ContentKeyPolicyPlayReadyContentType qui n’est pas disponible dans la version actuelle de l’API. |
Unspecified |
string |
Type de contenu non spécifié. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
Configure les bits de contrôle De restriction de sortie de la télévision analogique explicite. Pour plus d’informations, consultez les règles de conformité PlayReady.
Nom | Type | Description |
---|---|---|
bestEffort |
boolean |
Indique si cette restriction est appliquée sur la base du meilleur effort. |
configurationData |
integer |
Configure les bits de contrôle de restriction. Doit être compris entre 0 et 3 inclus. |
ContentKeyPolicyPlayReadyLicense
La licence PlayReady
Nom | Type | Description |
---|---|---|
allowTestDevices |
boolean |
Indicateur indiquant si les appareils de test peuvent utiliser la licence. |
beginDate |
string |
Date de début de la licence |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
Emplacement de la clé de contenu. |
contentType |
Type de contenu PlayReady. |
|
expirationDate |
string |
Date d’expiration de la licence. |
gracePeriod |
string |
Période de grâce de la licence. |
licenseType |
Type de licence. |
|
playRight |
La licence PlayRight |
|
relativeBeginDate |
string |
Date de début relative de la licence. |
relativeExpirationDate |
string |
Date d’expiration relative de la licence. |
securityLevel |
Niveau de sécurité. |
ContentKeyPolicyPlayReadyLicenseType
Type de licence.
Nom | Type | Description |
---|---|---|
NonPersistent |
string |
Licence non persistante. |
Persistent |
string |
Licence persistante. Autorise la lecture hors connexion. |
Unknown |
string |
Représente un ContentKeyPolicyPlayReadyLicenseType qui n’est pas disponible dans la version actuelle de l’API. |
ContentKeyPolicyPlayReadyPlayRight
Configure l’option Lire à droite dans la licence PlayReady.
Nom | Type | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
Configure le contrôle de gain automatique (AGC) et la bande de couleur dans la licence. Doit être compris entre 0 et 3 inclus. |
allowPassingVideoContentToUnknownOutput |
Configure les paramètres de gestion des sorties inconnues de la licence. |
|
analogVideoOpl |
integer |
Spécifie le niveau de protection de sortie pour l’audio numérique compressé. |
compressedDigitalAudioOpl |
integer |
Spécifie le niveau de protection de sortie pour l’audio numérique compressé. |
compressedDigitalVideoOpl |
integer |
Spécifie le niveau de protection de sortie pour la vidéo numérique compressée. |
digitalVideoOnlyContentRestriction |
boolean |
Active la contrainte image pour la restriction vidéo de composant analogique dans la licence. |
explicitAnalogTelevisionOutputRestriction |
Content |
Configure la restriction de sortie de télévision analogique explicite dans la licence. Les données de configuration doivent être comprises entre 0 et 3 inclus. |
firstPlayExpiration |
string |
Durée de validité de la licence après la première utilisation de la licence pour lire du contenu. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
Active la contrainte image pour la restriction vidéo de composant analogique dans la licence. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
Active la contrainte image pour la restriction vidéo de composant analogique dans la licence. |
scmsRestriction |
integer |
Configure le système de gestion de copie série (SCMS) dans la licence. Doit être compris entre 0 et 3 inclus. |
uncompressedDigitalAudioOpl |
integer |
Spécifie le niveau de protection de sortie pour l’audio numérique non compressé. |
uncompressedDigitalVideoOpl |
integer |
Spécifie le niveau de protection de sortie pour la vidéo numérique non compressée. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
Configure les paramètres de gestion des sorties inconnues de la licence.
Nom | Type | Description |
---|---|---|
Allowed |
string |
Le passage de la partie vidéo du contenu protégé à une sortie inconnue est autorisé. |
AllowedWithVideoConstriction |
string |
Le passage de la partie vidéo du contenu protégé à une sortie inconnue est autorisé, mais avec une résolution limitée. |
NotAllowed |
string |
La transmission de la partie vidéo du contenu protégé à une sortie inconnue n’est pas autorisée. |
Unknown |
string |
Représente un ContentKeyPolicyPlayReadyUnknownOutputPassingOption qui n’est pas disponible dans la version actuelle de l’API. |
ContentKeyPolicyRestrictionTokenType
Type de jeton.
Nom | Type | Description |
---|---|---|
Jwt |
string |
Jeton web JSON. |
Swt |
string |
Jeton web simple. |
Unknown |
string |
Représente un ContentKeyPolicyRestrictionTokenType qui n’est pas disponible dans la version actuelle de l’API. |
ContentKeyPolicyRsaTokenKey
Spécifie une clé RSA pour la validation des jetons
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
exponent |
string |
Exposant de paramètre RSA |
modulus |
string |
Module du paramètre RSA |
ContentKeyPolicySymmetricTokenKey
Spécifie une clé symétrique pour la validation des jetons.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
keyValue |
string |
Valeur de clé de la clé |
ContentKeyPolicyTokenClaim
Représente une revendication de jeton.
Nom | Type | Description |
---|---|---|
claimType |
string |
Type de revendication de jeton. |
claimValue |
string |
Valeur de revendication de jeton. |
ContentKeyPolicyTokenRestriction
Représente une restriction de jeton. Le jeton fourni doit correspondre à ces exigences pour une licence ou une remise de clé réussie.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
Liste des clés de vérification alternatives. |
audience |
string |
Audience du jeton. |
issuer |
string |
Émetteur de jeton. |
openIdConnectDiscoveryDocument |
string |
Document de découverte de connexion OpenID. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
Clé de vérification primaire. |
requiredClaims |
Liste des revendications de jeton requises. |
|
restrictionTokenType |
Type de jeton. |
ContentKeyPolicyUnknownConfiguration
Représente un ContentKeyPolicyConfiguration qui n’est pas disponible dans la version actuelle de l’API.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
ContentKeyPolicyUnknownRestriction
Représente un ContentKeyPolicyRestriction qui n’est pas disponible dans la version actuelle de l’API.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
ContentKeyPolicyWidevineConfiguration
Spécifie une configuration pour les licences Widevine.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
widevineTemplate |
string |
Modèle Widevine. |
ContentKeyPolicyX509CertificateTokenKey
Spécifie un certificat pour la validation de jeton.
Nom | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminateur pour les types dérivés. |
rawBody |
string |
Champ de données brutes d’un certificat au format PKCS 12 (X509Certificate2 dans .NET) |
createdByType
Type d’identité qui a créé la ressource.
Nom | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires |
type |
string |
Type d’informations supplémentaires. |
ErrorDetail
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d'erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
SecurityLevel
Niveau de sécurité.
Nom | Type | Description |
---|---|---|
SL150 |
string |
Pour les clients en cours de développement ou de test. Aucune protection contre une utilisation non autorisée. |
SL2000 |
string |
Pour les appareils renforcés et les applications qui consomment du contenu commercial. Protection logicielle ou matérielle. |
SL3000 |
string |
Pour les appareils renforcés uniquement. Protection matérielle. |
Unknown |
string |
Représente un SecurityLevel qui n’est pas disponible dans la version actuelle de l’API. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string |
Horodatage de la dernière modification de la ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la dernière ressource. |
lastModifiedByType |
Type d’identité qui a modifié la dernière ressource. |