Stage handler settings for MS Azure

This article contains an overview of the different stage handler settings for an MS Azure stage handler:

In the "General Configuration" section of the Stage Handler Configuration, you can select one of the XML files that was configured as explained in the Customer Knowledge Base. If you created only one of these files, only that file will show up in the "Configuration File" drop-down field.

Additionally, you can decide if you want to update all Assets in the sync scope regardless if they were changed or not with the checkbox "Force update".

Storage Service Configuration

In the "Storage Service Configuration" section, you need to paste your MS Azure Storage Service account name and access key. Besides that, you need to select the "Blob Name Resolver" and the "Container Name Resolver" from the drop-down fields.

Selecting the "Azure Blob File Name plus Extension Resolver" as Blob Name Resolver requires setting additional configuration options in custom.properties for each mapped download format that is not the Original Download Format, e.g.

azure.downloadFormatMapping.8=PNG

where "8" is the numeric download format ID and "PNG" is the file extension that is delivered by the download format.

If you do not have any custom resolver, only the Default Resolver will show up in this list.

Information about how you can implement custom resolvers is provided in the "Custom Resolver" chapter in the Customer Knowledge Base.

Media Service Configuration

In the "Media Service Configuration" section, you can decide if you want to use the MS Azure Media Service in addition to the Storage Service with the checkbox "Enable". If you check the checkbox, the following other fields become editable in the section:

Tenant Domain: Your MS Azure Media Service Active Directory Tenant Domain.
Client ID: Your MS Azure Media Service auto-generated client ID.
Client Secret: Your MS Azure Media Service auto-generated client secret.

To find out how you can generate a client ID and client secret, go to the official MS Azure documentation: https://docs.microsoft.com/en-us/azure/media-services/media-services-portal-get-started-with-aad
REST API Endpoint: Your MS Azure Media Service REST Endpoint.
Media Encoder: Select which Media Encoder you want to use for this Stage. The available values depend on the encoders that were configured in the chosen Configuration File.
Media Name Resolver: Select which Media Name Resolver you want to use for this Stage. If you do not have any custom resolver, only the Default Media Filename Resolver will show up in this list.

You can find more information about custom resolvers in the "Custom Resolver" chapter in the Customer Knowledge Base.

If you disable the Media Service after a successful synchronization, you will receive an error message on the next sync because of missing credentials. However, the videos still remain on the Media Service. In this case we recommend that you manually remove the Assets from the Media Service.

Please see chapter "Functionality Notes" in the Customer Knowledge Base for more information.