Share via


ContentKeyAuthorizationPolicyOption

Media Services, anahtar isteğinde bulunan kullanıcıların kimlik doğrulamasını yapmanın birden çok yöntemini destekler. Anahtarın istemciye teslimi için, içerik anahtarı yetkilendirme ilkesinin tarafınızdan yapılandırılması ve istemci (oynatıcı) tarafından karşılanması gerekir. İçerik anahtarı yetkilendirme ilkesinde bir veya daha fazla yetkilendirme kısıtlaması olabilir: açık, belirteç kısıtlaması veya IP kısıtlaması. Yetkilendirme seçeneklerini belirtmek için kullanırsınız ContentKeyAuthorizationPolicyOption . Ardından, oluşturulan seçenekleri öğesine ContentKeyAuthorizationPolicyeklersiniz.

Anahtar Teslim hizmetinin ve ilgili nesnelerini (ilke seçenekleri ve kısıtlamaları) 15 dakika boyunca önbelleğe ContentKeyAuthorizationPolicy aldığına dikkat edin. Bir "Belirteç" kısıtlaması kullanmak üzere bir ContentKeyAuthorizationPolicy ve oluşturur ve belirtirseniz, bunu test eder ve ilkeyi "Aç" kısıtlaması olarak güncelleştirirseniz, ilkenin ilkenin "Aç" sürümüne geçmesi yaklaşık 15 dakika sürer.

Bu konuda bu varlığın ContentKeyAuthorizationPolicyOption nasıl kullanılacağı açıklanır ve gösterilir. ile ContentKeyAuthorizationPolicynasıl ilişkilendirildiğini ContentKeyAuthorizationPolicyOption gösteren daha eksiksiz bir örnek için bkz. ContentKeyAuthorizationPolicy.

Önemli

Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'a Bağlanma.

ContentKeyAuthorizationPolicyOption Varlık Özellikleri

Özellik Tür Description
Id

Salt okunur. Media Services tarafından ayarlanır.
Edm.String Benzersiz tanımlayıcı.
Name Edm.String Yetkilendirme ilkesinin kolay adı.
KeyDeliveryType

Gereklidir.
Edm. Int32 İçerik anahtarının istemciye teslim yöntemi.

KeyDeliveryType aşağıdakilerden biri olabilir: None = 0, PlayReadyLicense = 1, BaselineHttp = 2).
KeyDeliveryConfiguration Edm.String Anahtarın istemciye nasıl teslimileceğini tanımlayan anahtar teslim türüne özgü xml verileri.
Restrictions

Gereklidir.
ContentKeyAuthorizationPolicyRestriction ComplexType Özelliklerikoleksiyonu. Anahtar teslim verilerini kullanarak anahtarı teslim etmek için her kısıtlamada tanımlanan gereksinimler karşılanmalıdır.

ContentKeyAuthorizationPolicyRestriction ComplexType Özellikleri

Özellik Tür Description
Name Edm.String Kısıtlamanın kolay adı.
KeyRestrictionType

Gereklidir.
Edm. Int32 Kısıtlamanın türü.

KeyRestrictionType aşağıdakilerden biri olabilir: Open = 0, TokenRestricted = 1, IPRestricted = 2.
Requirements Edm. Dize Kısıtlama gereksinimleri.

ContentKeyAuthorizationPolicyOption Oluşturma

Aşağıdaki örnek, aşağıdaki değerler ayarlanmış bir ContentKeyAuthorizationPolicyOption oluşturur: Open yetkilendirme kısıtlaması ("KeyRestrictionType":0) ve TemelHttp (MPEG temel HTTP anahtar protokolü) anahtar teslim yöntemi ("KeyDeliveryType":2). Örneği Fiddler'ın Oluşturucu sekmesinde deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/ContentKeyAuthorizationPolicyOptions HTTP/1.1  
  
Content-Type: application/json  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json  
Accept-Charset: UTF-8  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
x-ms-version: 2.19  

İstek gövdesi:

  
{    
   "Name":"policy",  
   "KeyDeliveryType":2,  
   "KeyDeliveryConfiguration":"",  
   "Restrictions":[    
      {    
         "Name":"HLS Open Authorization Policy",  
         "KeyRestrictionType":0,  
         "Requirements":null  
      }  
   ]  
}  

Başarılı olursa, http /1.1 201 Oluşturuldu durum kodu ve yanıt gövdesinde oluşturulan varlığın gösterimi döndürülür.

Aşağıdaki örnek, aşağıdaki değerler ayarlanmış bir ContentKeyAuthorizationPolicyOption oluşturur: Token yetkilendirme kısıtlaması ("KeyRestrictionType":1) ve TemelHttp (MPEG temel HTTP anahtar protokolü) anahtar teslim yöntemi ("KeyDeliveryType":2).

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https:/testrest.cloudapp.net/api/ContentKeyAuthorizationPolicyOptions HTTP/1.1  
  
Content-Type: application/json  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json  
Accept-Charset: UTF-8  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
  

İstek gövdesi:

{    
   "Name":"Token option for HLS",  
   "KeyDeliveryType":2,  
   "KeyDeliveryConfiguration":null,  
   "Restrictions":[    
      {    
         "Name":"Token Authorization Policy",  
         "KeyRestrictionType":1,  
         "Requirements":"<TokenRestrictionTemplate xmlns:i=\"https://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.microsoft.com/Azure/MediaServices/KeyDelivery/TokenRestrictionTemplate/v1\"><AlternateVerificationKeys><TokenVerificationKey i:type=\"SymmetricVerificationKey\"><KeyValue>dliLr1QQJrATxNuoss2Btvk1KxcDJDHvTgu7fII5LEMGAt1p6J1YAD7I0EVd6D69nEkNUlkSDXfgaJ3cswrf8g==</KeyValue></TokenVerificationKey></AlternateVerificationKeys><Audience>urn:test</Audience><Issuer>http://testacs.com/</Issuer><PrimaryVerificationKey i:type=\"SymmetricVerificationKey\"><KeyValue>tqdCrSPGDZYJ4l3YyWR1NH7OdTvucBm7bU/ZQKPszV/hR54saMgyJK9bA9bay996NtNpcA0OruHETvy885g46A==</KeyValue></PrimaryVerificationKey><RequiredClaims><TokenClaim><ClaimType>urn:microsoft:azure:mediaservices:contentkeyidentifier</ClaimType><ClaimValue i:nil=\"true\" /></TokenClaim></RequiredClaims><TokenType>JWT</TokenType></TokenRestrictionTemplate>"  
      }  
   ]  
}