Aracılığıyla paylaş

İçerik koruma senaryo tabanlı geçiş kılavuzu

  • Makale

geçiş kılavuzu logosu

geçiş adımları 2

Önemli

V2 API'sinin kullanımdan kaldırılması, Azure Media Services'ın kullanımdan kaldırılmasıyla uyumlu hale gelecek şekilde Azure Media Service v2'den v3'e geçiş yapmak artık gerekli değildir. Daha fazla bilgi için lütfen Azure Media Services kullanımdan kaldırma kılavuzuna bakın.

Bu makalede, içerik koruma kullanım örneklerinin v2 API'sinden yeni Azure Media Services v3 API'sine geçişine ilişkin ayrıntılar ve yönergeler sağlanır.

v3 API'de içeriği koruma

Belirli adımlar için bu makalenin sonundaki içerik koruma kavramlarına, öğreticilere ve nasıl yapılır kılavuzlarına bakın.

Not

Bu makalenin geri kalanında v2 içerik korumanızı .NET ile v3'e nasıl geçirebileceğiniz açıklanır. Farklı bir dil veya yöntem için yönergelere veya örnek koda ihtiyacınız varsa lütfen bu sayfa için bir GitHub sorunu oluşturun.

AMS'nin tek başına lisans teslim sunucusu (karma şirket içi modu) olarak kullanımdan kaldırılması

v3 API artık anahtar teslim hizmetlerinin içerik koruması için tek başına bir özellik olarak kullanılmasını desteklememektedir. Burada anahtar teslim hizmeti, diğer üçüncü taraf kaynak sunucuları aracılığıyla akışa alınan veya teslim edilen içeriğin lisansını teslim etmek için kullanılabilir. Bu, AMS'nin artık V3 API'de yalnızca anahtar teslimi senaryolarını desteklemediğini ve v3 ile teslim sırasında dinamik paketleme ve şifreleme kullanarak AMS kaynak hizmetlerinden akış yapmanızı gerektirdiği anlamına gelir.

v2 API ile şifrelenen ve bir "karma" modelde teslim edilen mevcut içerik çalışmaya devam edecektir (anahtarlar veri düzleminde alınabilir olmaya devam edecektir, ancak bu anahtarların (güncelleştirmeler ve düzenlemeler) v2 yönetim düzlemi veya v3 yönetim düzlemi üzerinden yönetimi 29 Şubat 2024'den sonra çalışmayacaktır.

Not

v3 kullanılarak teslim edilen tüm yeni içerik yalnızca AMS'den içerik koruma ve akış desteği sunar ve artık "karma" modu desteklemez. Veri düzlemi, v2'de oluşturulan mevcut anahtarları ve lisansları teslim etmeye devam eder, ancak artık v2 veya v3 API aracılığıyla yönetim veya güncelleştirmeleri desteklemez.

v2 Varlıklarının, StreamingLocator'ların ve özelliklerin v3 görünürlüğü

v2 API'sinde, AssetsStreamingLocators, ve ContentKeys akış içeriğinizi korumak için kullanıldı. v3 API'sine geçiş yaparken, v2 API Assets'niz , StreamingLocatorsve ContentKeys tüm api'niz v3 API'sinde otomatik olarak kullanıma sunulur ve bu API'lerdeki tüm veriler erişebilirsiniz.

Ancak, v2'de oluşturulan v3 API'si aracılığıyla v2 varlıklarındaki özellikleri güncelleştiremezsiniz .

v2 varlıklarında depolanan içeriği güncelleştirmeniz, değiştirmeniz veya değiştirmeniz gerekiyorsa, bunları v2 API'si ile güncelleştirin veya geçirmek için yeni v3 API varlıkları oluşturun.

Varlık tanımlayıcısı farklılıkları

Geçiş yapmak için v2 Varlıklarınızdan özelliklere veya içerik anahtarlarına erişmeniz gerekir. v2 API'sinin birincil kimlik anahtarı olarak öğesini AssetId kullandığını, ancak yeni v3 API'sinin birincil tanımlayıcı olarak varlığın Azure Kaynak Yönetimi adını kullandığını anlamak önemlidir. (v2 Asset.Name özelliği benzersiz tanımlayıcı olarak kullanılmaz.) v3 API'siyle, v2 Varlık adınız artık olarak Asset.Descriptiongörünür.

Örneğin, daha önce kimliğine nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8sahip bir v2 Varlığınız varsa, tanımlayıcı artık GUID'nin 8cb39104-122c-496e-9ac5-7f9e2c2547b8sonundadır. v2 varlıklarınızı v3 API'sini kullanarak listelerken bunu görürsünüz.

v2 API'si kullanılarak oluşturulan ve yayımlanan tüm Varlıklar, üzerinde varsayılan içerik anahtarı ilkesi yerine v3 API'sinde hem a ContentKeyPolicyContentKey hem de a değerlerine StreamingPolicysahip olur.

Daha fazla bilgi için İçerik anahtarı ilkesi belgelerine ve Akış İlkesi belgelerine bakın.

Azure Media Services Gezgini (AMSE) v2 ve AMSE v3 araçlarını yan yana kullanma

v2 API'leri aracılığıyla oluşturulan ve yayımlanan bir Varlığın verilerini yan yana karşılaştırmak için v2 Azure Media Services Gezgini aracını v3 Azure Media Services Gezgini aracıyla birlikte kullanın. Özelliklerin tümü görünür, ancak farklı konumlarda olmalıdır.

.NET içerik koruma geçiş örneğini kullanma

Media Services kod örneklerinde ContentProtection altında v2tov3MigrationSample kullanarak Varlık tanımlayıcılarındaki farkları karşılaştırmak için bir kod örneği bulabilirsiniz.

Akış Bulucularını Listeleme

Varlık varlığındaki StreamingLocators yeni v3 listStreamingLocators yöntemini kullanarak v2 API'sinde oluşturulan Varlıklarla ilişkili sorgulayabilirsiniz. Ayrıca ListStreamingLocatorsAsync'in .NET istemci SDK sürümüne de başvurun

yönteminin ListStreamingLocators sonuçları, Name ile birlikte bulucunun ve'sini StreamingLocatorIdStreamingPolicyNamesağlar.

İçerik anahtarlarını bulma

ile StreamingLocatorskullanılan öğesini ContentKeys bulmak için StreamingLocator.ListContentKeysAsync yöntemini çağırabilirsiniz.

v3 API'sindeki içerik koruması hakkında daha fazla bilgi için Media Services dinamik şifrelemesi ile içeriğinizi koruma makalesine bakın.

Aynı ContentKey'i koruyarak v2 ContentKeyPolicy'yi değiştirme

Önce v2 SDK'sı aracılığıyla Varlık üzerindeki yayından kaldırmalısınız (tüm Akış Bulucularını kaldırmalısınız). Aşağıdaki adımları uygulayın:

  1. Bulucuyu silin.
  2. bağlantısını kaldırın ContentKeyAuthorizationPolicy.
  3. bağlantısını kaldırın AssetDeliveryPolicy.
  4. bağlantısını kaldırın ContentKey.
  5. öğesini ContentKeysilin.
  6. v3 ve kullanarak v3'te, belirli içerik anahtarı tanımlayıcısını ve gereken anahtar değerini belirterek yeni StreamingLocator bir StreamingPolicyContentKeyPolicyoluşturun.

Not

v3 API'sini kullanarak v2 bulucusunu silmek mümkündür, ancak bu işlem, v2 API'sinde oluşturulduysa içerik anahtarını veya içerik anahtarı ilkesini kaldırmaz.

İçerik koruma kavramları, öğreticiler ve nasıl yapılır kılavuzları

Kavramlar

Öğreticiler

Hızlı Başlangıç: İçeriği şifrelemek için portalı kullanma

Nasıl yapılır kılavuzları

Araçlar

Yardım ve destek alma

Aşağıdaki yöntemlerden birini kullanarak Media Services ile iletişime geçebilir veya güncelleştirmelerimizi izleyebilirsiniz: