VIDIZMO seamlessly integrates with Azure Active Directory (Azure AD) to provide secure sign-in and authorization for its services. To integrate an application or service with Azure AD, VIDIZMO must first be registered with an Azure AD tenant to enable it to access web APIs and other resources. This registration process involves giving Azure AD details about VIDIZMO, such as the URL where it’s located, the URL to send replies after a user is authenticated, the URL that identifies VIDIZMO application, and so on.


VIDIZMO either uses its Setup Wizard to automatically configure AMS encoding or provides an option to manually run a script containing the Azure AD Application details provided by the user.


This is a step-by-step guide to help users manually configure AMS for themselves and provide the required information from AMS to configure AMS as the storage and encoding provider in VIDIZMO. 


Intended for those users who already have AMS configured previously, this article does not cover the steps required to set up AMS for the first time.



Steps



1. Prerequisites:


The following information is required in VIDIZMO and the steps below will help you locate that information in AMS:

  1. Azure AD Tenant Domain:
  2. Application Rest API Endpoint:
  3. Application Name:
  4. Application Id:
  5. Client Key:
  6. Media Service Name: [Name of Media Service]



2. Go to the Azure Portal

i. Enter your email address and password

ii. Click on Sign in to continue.




3. It will look for your account. Once done:

i. Enter your password.

ii. Click on Sign in.





4. After a successful sign in, the Microsoft Azure Portal's Dashboard will be displayed. 

i. Select All Resources from the left Menu or use the Search to locate it.




5. On the All Resources screen, filter the resources on Media Services column and check the Media services as shown below:




6. On the Media Services screen, select your specific Media Service and copy this name against Item #6 in the list in Step 1 - Prerequisites.

i.e. Media Service Name: [Name of Media Service]

Then click on the Media Service to expand its properties and locate API access





7. Next, click on the API access to expand the API access properties and select “Connect to Azure Media Services API with service principal”:

 



8. From the properties screen of “Connect to Azure Media Services API with service principal


i. Copy the “Azure Active Directory tenant domain” value and paste it against Item #1 - Azure AD Tenant Domain under Step 1 - Prerequisites.
ii. Similarly, copy the “REST API Endpoint” value and paste it against Item #2 - Application Rest API Endpoint.




9. Next, create a new Azure AD Application using the "Create New" button. 

In the “Create App” textbox, enter an “Application Name” for Media Service AD App and then press the Save button to create application. An application gets created.





10. After the Application gets, created, click on the “Manage application” button. This will open a blade on the right-hand side with the title “Registered app”.

From the information on this blade:


i. Copy the “Display Name” from this blade and paste it in front of “Item# 3 - Application Nameunder Step 1 - Prerequisites.

ii. Copy the “Application ID” and paste it in front of “Item# 4 - Application Idunder Step 1 - Prerequisites.




11. From the same screen, click on “Settings” at the top of “Registered app” blade. This will open another blade on right side with title “Settings”.

Select the “Keys” option in this blade.



12. The Keys blade provides the following information:

i. Description: Enter a description.

ii. Expires: Set value to "Never Expires", otherwise encoding for media service will stop after a defined period and you will need to recreate the “Key”.

iii. Value: This will be generated when you press the Save button.





13. After saving, a “Client Key” will appear in under “Value”. Copy this key and paste it in front of “Item# 5 - Client Keyunder Step 1 - Prerequisites.


Note: This key only appears once and if you leave this blade and did not copy it, the key will be lost.




If you have multiple Media Services to configure with VIDIZMO application you can fill following table against the information mentioned in Step 1.

Azure AD Tenant Domain
Application Rest API Endpoint
Application Name
Application Id
Client Key
Media Service Name















14. Use the information obtained as per the table in Step # 13 to complete the following JSON query:


JSON Query{"AzureADTenantDomain":"[Azure AD Tenant Domain]","AzureEnvironment":"login.microsoftonline.com","AzureADEndPoint":"https://login.microsoftonline.com/","ApplicationRestAPIEndPoint":"[Application Rest API Endpoint]","ApplicationName":"[Application Name]","ApplicationId":"[Application Id]","ClientKey":"[Client Key]","KeyId":"","KeyExpiry":"KeyExpiryDateTime"}
Note:
KeyExpiryDateTime field is optional
Update Query for EncodingProvider table
update EncodingProvider set AccountName = '[Media Service Name]', EncodingProviderDetail = '[Above JSON query with filled values]' where TenantId = [TenantId]

If needed to update ECDN, then first add an ECDN from VIDIZMO Application and then run the following Update Query for StreamingServerConfiguration table

Update StreamingServerConfiguration set IP = '[Media Service Name]', LoginId = '[Application Id]', [Password] = '[Client Key]', APIServerAddress = '[Application Rest API Endpoint]', AzureADTenantDomain = '[Azure AD Tenant Domain]', AzureEnvironment = 'login.microsoftonline.com' where Id = [Streaming Server Configuration Id]




15. Running the queries will setup AMS as the storage and encoding provider in VIDIZMO. If you have any questions, please contact VIDIZMO Support




Permissions 


Subject: Account


Action: Update


Roles


Administrator, Manager