Please follow below steps to setup and configure your Media Engine.
1. Check Installation
Ensure you have installed the Media Engine successfully
2. Configure App Registration
2.1 Create a new Microsoft Entra Id (formerly Azure AD) App Registration
- Go to the Azure portal, then find the Microsoft Entra Id service
- Click on "App registrations" and then "New registration"
- Fill in the name and select 'Single Tenant' for the Supported Account Type option"
- Click on "Register"
2.2 Assign Contributor role to the App against the resource group where the Media Engine was installed
- Go to the resource group where the Media Engine was installed
- Click on "Access control (IAM)" and then "Add"
- Fill in the role of Contributor and select the newly registered App
- Click on "Save"
2.3 Create secret for the newly registered App
- Click on the newly registered App
- Click on "Certificates & secrets" and then "New client secret"
- Fill in the description and select the expiration date
- Click on "Add"
- Copy the secret value and keep it in a safe place
- Copy the Application (client) id of the App
2.4 Configure Media Enginee API Server with the secret
- Go to the Media Engine API Server (the azure function app with name prefix of "bme-api-app")
- Click on "Environment variables"
- Find the 'ClientId' setting and fill in the value of Application (client) id you copied in last step
- Find the 'ClientSecret' setting and fill in the value of secret you copied in last step
- Click on "Save"
3. Configure Custom Domain and SSL for API Server and Stream Server
You can configure a custom domain and SSL for BME Stream Server (name starts with "bme-stream-app") and BME API Server (name starts with "bme-api-app"). If you use Azure China, as per China's policy, you must configure a custom domain and SSL certificate, otherwise the application will be blocked. Refer to this link to set up a custom domain.
And then you need to update configurations of BME API Server (name starts with "bme-api-app") to use the custom domain of the Stream Server: find BME API Server in Azure Portal and go to "Environment variables" and update the value of 'StreamEndPointUrl' to the custom domain in the App Settings.
4. Configure CORS for Stream Server
You need to configure CORS for the BME stream server (name starts with "bme-stream-app"). Go to the stream server in Azure Portal, then go to CORS and add the domain of your website (where your media player is hosted) to the allowed origins.
5. Register Resource Provider
You need to register the resource provider "Microsoft.App" in your subscription, if this is not registered. You can do this by going to the Azure portal, then find the "Subscriptions" service, click on the subscription you used to deploy the Media Engine, then click on "Resource providers" and search for "Microsoft.App" and click on "Register".
If not resgistred, you may fail to encode your video and get an error of "The subscription is not registered to use namespace 'Microsoft.App" in the errorMessage output of the encoding job.
6. Configure the license
In Azure Portal, find the BME Storage (the Azure Storage Account name starts with “bmestorage”), in the Containers of data storage, create a new container named “secure”, configure its Anonymous access level as “Private(no anonymous access)”. Upload the license file, that's all! (Contact us to get your license file)
7. Use Azure (Global) CDN to accelerate streaming playback (optional).
8. Configure Auto-Scaling for Streaming Server (Optional)
If you haven't set up a CDN and there is a large number of users on your audience end, you might need to configure auto-scaling for the streaming server.