Obter credenciais para acessar a API dos Serviços de Mídia

Logotipo dos Serviços de Mídia v3


Site do AMS | Documentação dos Serviços de Mídia v2 | Exemplos de código | Guia de solução de problemas

Ao usar a autenticação do Azure AD para acessar a API dos Serviços de Mídia do Azure, você tem duas opções de autenticação:

  • Autenticação de entidade de serviço

    Autentica um serviço. Os aplicativos que geralmente usam esse método de autenticação são aplicativos que executam serviços de daemon, serviços de camada intermediária ou trabalhos agendados: aplicativos Web, aplicativos de funções, aplicativos lógicos, APIs ou um microsserviço.

  • Autenticação de usuário

    Autentica uma pessoa que está usando o aplicativo para interagir com os recursos dos Serviços de Mídia. O aplicativo interativo deve primeiro solicitar ao usuário as credenciais. Um exemplo é um aplicativo de console de gerenciamento usado por usuários autorizados para monitorar trabalhos de codificação ou uma transmissão ao vivo.

Este artigo descreve as etapas para obter credenciais para acessar a API dos Serviços de Mídia. Escolha entre as seguintes guias.

Pré-requisitos

Acesso à API

A página acesso à API permite selecionar o método de autenticação que você deseja usar para se conectar à API. A página também fornece os valores necessários para se conectar à API.

  1. No Portal do Azure, selecione sua conta dos Serviços de Mídia.
  2. Selecione a folha Acesso à API na barra de navegação à esquerda.
  3. Em Conectar à API dos Serviços de Mídia, selecione a versão da API dos Serviços de Mídia à qual você deseja se conectar (v3 é a versão mais recente do serviço).

Autenticação de entidade de serviço

Autentica um serviço usando um aplicativo e segredo do Azure Active Directory (Azure AD).

Gerenciar seu aplicativo e segredo do Azure AD

A seção Gerenciar seu aplicativo e segredo do ADD permite selecionar ou criar um novo aplicativo do Azure AD e gerar um segredo. Por motivos de segurança, o segredo não pode ser mostrado depois que a folha é fechada. O aplicativo usa a ID e o segredo do aplicativo para autenticação para obter um token válido para serviços de mídia.

Verifique se você tem permissões suficientes para registrar um aplicativo com o seu locatário do Azure AD e para atribuir o aplicativo a uma função na sua assinatura do Azure. Para obter mais informações, consulte Permissões necessárias.

Conecte-se à API de Serviços de Mídia

O Conecte-se à API de Serviços de Mídia fornece valores que você usa para conectar seu aplicativo de entidade de serviço. É possível obter valores de texto ou copiar os blocos JSON ou XML.

Autenticação de usuário

Essa opção pode ser usada para autenticar um funcionário ou membro de um Azure Active Directory que está usando um aplicativo para interagir com os recursos de Serviços de Mídia. O aplicativo interativo deve primeiro solicitar ao usuário as credenciais do usuário. Este método de autenticação deve ser usado apenas para aplicativos de gerenciamento.

Conecte-se à API de Serviços de Mídia

Copie as credenciais para conectar seu aplicativo de usuário na seção Conecte-se à API de Serviços de Mídia. É possível obter valores de texto ou copiar os blocos JSON ou XML.