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 ContentKeyAuthorizationPolicy
eklersiniz.
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 ContentKeyAuthorizationPolicy
nası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>"
}
]
}