Este artigo mostra como registrar um aplicativo cliente do Power BI no AD do Azure (Active Directory do Azure). Você pode registrar o aplicativo cliente com o AD do Azure para permitir que seu aplicativo acesse a API REST do Power BI. 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 locatário do 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 do Azure. 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.

Neste artigo

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

Você precisa registrar o aplicativo cliente no Active Directory do Azure para estabelecer uma identidade para seu aplicativo e especificar permissões para recursos REST do Power BI. Ao registrar um aplicativo cliente, como um aplicativo de console, você recebe uma ID do cliente. A ID do Cliente é usada pelo aplicativo para se identificar aos usuários dos quais ele está solicitando permissões. Veja aqui como registrar seu aplicativo cliente 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 cliente nativo, um URI de redirecionamento fornece ao AAD mais detalhes do aplicativo específico que ele autenticará. Qualquer URI válido funcionará como https://login.live.com/oauth20_desktop.srf.

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. Certifique-se de copiar a ID do Cliente. Você pode obter a ID do Cliente posteriormente no Portal de Gerenciamento do Azure. Veja Como obter uma ID do cliente no Portal de Gerenciamento do Azure.

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

Registrar um aplicativo cliente com o Portal de Gerenciamento do Azure

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

Para saber como autenticar um aplicativo cliente usando uma ID do Cliente do Azure AD, veja Autenticar um aplicativo cliente.

Registrar um aplicativo cliente

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 no Active Directory ao qual você pertence.

  1. Clique em APLICATIVOS.

  2. Clique em ADICIONAR.

  3. Em Conte-nos sobre o seu aplicativo, insira um NOME, escolha APLICATIVO CLIENTE NATIVO para o tipo e clique no ícone Avançar .

  4. Em Informações do aplicativo, insira um URI DE REDIRECIONAMENTO. Para um aplicativo cliente, um URI de redirecionamento fornece ao AAD mais detalhes do aplicativo específico que será autenticado. Para um aplicativo cliente, é possível usar qualquer URI válido como https://login.live.com/oauth20_desktop.srf.

  5. Clique no ícone Concluir.

  6. Na página do aplicativo, escolha CONFIGURAR. Você verá a sua ID DO CLIENTE.

  7. Na página CONFIGURAÇÃO , em permissões para outros aplicativos, clique em Adicionar Aplicativo.

  8. 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.

  9. Clique no ícone Concluir.

  10. No grupo permissões para outros aplicativos, escolha todas as Permissões Delegadas e então escolha uma ou mais permissões. Para obter mais informações sobre as permissões do Power BI, veja Permissões do Power BI.

  11. Clique em Salvar.

Como obter uma ID do aplicativo cliente

Ao registrar um aplicativo cliente, como um aplicativo de console, você recebe 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 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. Clique no Active Directory ao qual você pertence.
  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.

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 cliente
Visão geral da API REST do Power BI
Mais perguntas? Experimente a Comunidade do Power BI