Content Key Policies

Media Services logo v3


Warning

Azure Media Services will be retired June 30th, 2024. For more information, see the AMS Retirement Guide.

Note

Google Widevine content protection services are currently unavailable in the Microsoft Azure regions operated by 21Vianet.

With Media Services, you can deliver your live and on-demand content encrypted dynamically with Advanced Encryption Standard (AES-128) or any of the two major digital rights management (DRM) systems: Microsoft PlayReady, and Apple FairPlay. Media Services also provides a service for delivering AES keys and DRM (PlayReady and FairPlay) licenses to authorized clients. FairPlay Streaming is an Apple technology that is only available for video transferred over HTTP Live Streaming (HLS) on iOS devices, in Apple TV, and in Safari on macOS.

To specify encryption options on your stream, you need to create a Streaming Policy and associate it with your Streaming Locator. You create the Content Key Policy to configure how the content key (that provides secure access to your Assets) is delivered to end clients. You need to set the requirements (restrictions) on the Content Key Policy that must be met in order for keys with the specified configuration to be delivered to clients. The content key policy is not needed for clear streaming or downloading.

In most cases, the content key policy is associated with a Streaming Locator. When creating a custom streaming policy for advanced scenarios, you can specify the content key policy inside of a Streaming Policy.

Best practices and considerations

Important

Please review the following recommendations.

  • You should design a limited set of policies for your Media Service account and reuse them for streaming locators whenever the same options are needed. For more information, see Quotas and limits.

  • Content key policies are updatable. It can take up to 15 minutes for the key delivery caches to update.

  • Don't create a new content key policy for each asset. The main benefits of sharing the same content key policy between assets that need the same policy options are:

    • It's easier to manage a small number of policies.
    • If you need to make updates to the content key policy, the changes go into effect on all new license requests almost right away.
  • If you do need to create a new policy, you have to create a new streaming locator for the asset.

  • It's recommended to let Media Services autogenerate the content key.

    Typically, you would use a long-lived key and check for the existence of the content key policy with Get. To get the key, call a separate action method to get secrets or credentials.

Filtering, ordering, paging

See Filtering, ordering, paging of Media Services entities.