Este artigo mostra como registrar um aplicativo Web do Power BI no Active Directory do Azure (AD do Azure). Para permitir que o aplicativo tenha acesso à API REST do Power BI, você precisa registrar o aplicativo no Active Directory do Azure. Isso permitirá que você estabeleça uma identidade para seu aplicativo e especifique permissões para recursos REST do Power BI. Para obter uma lista de permissões do Power BI, veja Permissões do Power BI.

Importante Antes de registrar um aplicativo do Power BI, você precisa de um Azure Active Directory e um usuário da organização, além de uma conta de serviço do Power BI.

Há duas maneiras de registrar seu aplicativo Web: com a Ferramenta de Registro de Aplicativo do Power BI ou no Portal de Gerenciamento. A Ferramenta de Registro de Aplicativo do Power BI é a opção mais fácil, pois há apenas alguns campos para preencher. Se você deseja fazer alterações ao seu aplicativo, isso pode ser feito por meio do Portal de Gerenciamento do Azure.

Registrar um aplicativo Web na Ferramenta de Registro do Aplicativo do Power BI

Você precisa registrar o aplicativo Web no Active Directory do Azure para estabelecer uma identidade para o seu aplicativo e especificar permissões para recursos REST do Power BI. Ao registrar um aplicativo Web, você receberá uma ID do Cliente e uma Chave Secreta do Cliente. A ID do Cliente é usada pelo aplicativo para se identificar aos usuários dos quais ele está solicitando permissões. A Chave secreta do cliente é usada pelo aplicativo Web para se identificar ao Serviço do Power BI.

Veja aqui como registrar seu aplicativo Web com a Ferramenta de Registro de Aplicativo do Power BI:

  1. Vá para dev.powerbi.com/apps.
  2. Na Ferramenta de Registro do Aplicativo do Power BI, siga essas quatro etapas:

Etapa 1 - Escolha Logon em para fazer logon na sua conta do AD do Azure. Você verá seu nome na linha de Boas-vindas.

Etapa 2 – Insira informações sobre o seu aplicativo.

  • Nome do Aplicativo: o nome do seu aplicativo.
  • Tipo de Aplicativo: escolha aplicativo Nativo.
  • URI de Redirecionamento: para um aplicativo Web, um URI de redirecionamento fornece ao AAD mais detalhes do aplicativo específico que ele autenticará. Um URI de Redirecionamento de exemplo tem esta aparência: http://localhost/redirect.
  • Home Page: a home page ou a página de entrada do seu aplicativo Web.

Etapa 3 – Escolha as APIs que serão acessadas. Para obter mais informações sobre as permissões de acesso do Power BI, veja Permissões do Power BI.

Etapa 4 – Para registrar seu aplicativo, clique em Registrar Aplicativo. Depois que o aplicativo é registrado no AD do Azure, você obterá uma ID do Cliente e uma chave Secreta do Cliente . Certifique-se de copiar a ID do Cliente e a chave Secreta do Cliente. Você pode obter a ID do Cliente ou a chave Secreta do Cliente posteriormente no Portal de Gerenciamento do Azure. Veja Como obter uma ID do cliente no Portal de Gerenciamento do Azure e Como obter uma chave secreta do cliente.

Agora você pode usar sua ID do Cliente e o Segredo do Cliente para seu aplicativo. A próxima seção mostra como registrar um aplicativo Web no Portal de Gerenciamento do Azure.

Registrar um aplicativo Web com o Portal de Gerenciamento do Azure

Ao registrar um aplicativo Web, você receberá uma ID do cliente e uma Chavesecreta do cliente. A ID do Cliente é usada pelo aplicativo para se identificar aos usuários dos quais ele está solicitando permissões. A chave de segredo do cliente é usada pelo aplicativo Web para se identificar ao serviço do Power BI.

Para saber como autenticar um aplicativo Web usando a ID do Cliente do Azure AD e a Chave secreta do cliente, veja Autenticar um aplicativo Web.

Eis como registrar um aplicativo cliente:

  1. Aceite os Termos da API do Microsoft Power BI.
  2. Entre em sua assinatura do Microsoft Azure em https://manage.windowsazure.com.
  3. No painel de serviços à esquerda, escolha ACTIVE DIRECTORY.
  4. Clique em qualquer Active Directory.

  5. Clique em APLICATIVOS.

  6. Clique em ADICIONAR.

  7. Em Conte-nos sobre o seu aplicativo, insira um NOMEe escolha APLICATIVO WEB E/OU API WEB para o tipo e, em seguida, clique no ícone Avançar .

  8. Em Propriedades do aplicativo, insira uma URL DE LOGON e URI DA ID DO APLICATIVO. A URL DE LOGON é a URL do seu aplicativo Web, como https://localhost:44307. O URI DA ID DO APLICATIVO é o URI do Locatário do Azure seguido pelo nome do aplicativo. Por exemplo, https://yourtenant.onmicrosoft.com/YourWebApp.

  9. Clique no ícone Concluir.

  10. Na página do aplicativo, escolha CONFIGURAR. A página CONFIGURAR tem uma ID do cliente e uma Chave para seu aplicativo.

    Etapa 10

  11. Para um aplicativo Web, você precisa de uma Chavesecreta do cliente. Na seção Chaves , selecione uma duração. A chave é exibida depois de salvá-la . Não deixe de copiar a chave, caso contrário, ela não estará disponível em navegação futura na página de configuração.

  12. Na página CONFIGURAÇÃO , clique em Adicionar Aplicativo.

  13. Em Permissões para outros aplicativos, escolha Serviço do Power BI.

    Importante Caso você não veja o Serviço do Power BI na lista Permissões para outros aplicativos, será necessário se inscrever no Serviço do Power BI. Para se inscrever no serviço do Power BI, você precisa de pelo menos um usuário da organização no seu locatário do AAD (Active Directory do Azure). Se você não tiver um locatário do AAD (Azure Active Directory), veja Criar um locatário do Azure Active Directory para criar um locatário do Azure AD e um usuário da organização em seu locatário do Azure AD.

  14. Clique no ícone Concluir, que está localizado no canto inferior direito da página.

  15. No grupo permissões para outros aplicativos, vá para a lista suspensa
    Permissões Delegadas e escolha as operações que seu aplicativo tem permissão de chamar. Para obter mais informações sobre as permissões do Power BI, veja Permissões do Power BI.

  16. Clique em Salvar.

    ** Importante ** Em aplicativos Web, é preciso uma Chave de segredo do cliente. A Chave secreta do cliente é exibida depois de você salvá-la . Não deixe de copiar a chave, caso contrário, ela não estará disponível em navegação futura na página de configuração.

Como obter uma ID do aplicativo cliente

Ao registrar um aplicativo Web, você receberá uma ID do Cliente. A ID do Cliente é usada pelo aplicativo para se identificar aos usuários dos quais ele está solicitando permissões.

Eis como obter uma ID do aplicativo cliente:

  1. Entre em sua assinatura do Microsoft Azure em https://manage.windowsazure.com.
  2. No painel de serviços à esquerda, escolha ACTIVE DIRECTORY.
  3. Escolha qualquer Active Directory.
  4. Clique em APLICATIVOS.
  5. Escolha um aplicativo.
  6. Na página do aplicativo, escolha CONFIGURAR.
  7. Na página CONFIGURAR , copie a ID DO CLIENTE.

    etapa 1.3

Como obter um segredo do cliente

Para um aplicativo Web, você precisa de uma Chavesecreta do cliente. Ao registrar um aplicativo Web, o AD do Azure gera uma chave (consulte a etapa 11 acima). Na seção Chaves , selecione uma duração. A chave é exibida depois de salvá-la. Não deixe de copiar a chave, caso contrário, ela não estará disponível em navegação futura na página de configuração.

Consulte também

Permissões do Power BI
Locatário do Azure Active Directory e um usuário organizacional
Conta de serviço do Power BI
Autenticar um aplicativo Web
Visão geral da API REST do Power BI
Mais perguntas? Experimente a Comunidade do Power BI