Saiba como registrar um aplicativo no Azure AD (Azure Active Directory) para uso com a inserção de conteúdo do Power BI.

Registre seu aplicativo com o Azure AD para permitir que seu aplicativo acesse as APIs 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.

Importante:

Antes de registrar um aplicativo do Power BI, é necessário um locatário do Azure Active Directory e um usuário da organização. Se você ainda não se inscreveu no Power BI com um usuário em seu locatário, o registro do aplicativo não será concluído com êxito.

Há duas maneiras de registrar seu aplicativo. A primeira é com a Ferramenta de Registro de Aplicativo do Power BI ou é possível fazê-lo diretamente no Portal 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ê desejar fazer alterações ao seu aplicativo, isso poderá ser feito por meio do Portal do Azure.

Registrar um aplicativo com a Ferramenta de Registro de Aplicativo do Power BI

É necessário registrar seu aplicativo no Azure Active Directory para estabelecer uma identidade para o seu aplicativo e especificar permissões para os recursos REST do Power BI. Quando você registra um aplicativo, como um aplicativo de console ou um site da Web, você recebe um identificador usado pelo aplicativo para se identificar aos usuários dos quais eles estão solicitando permissões.

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

  1. Acesse dev.powerbi.com/apps.

  2. Selecione Entre com sua conta existente.

  3. Forneça um Nome do Aplicativo.

  4. A seleção do tipo de aplicativo dependerá do tipo de aplicativo que você estiver usando.

    • Use Aplicativo Web do servidor para aplicativos Web ou APIs da Web.
    • Use Aplicativo nativo para aplicativos executados em dispositivos cliente. Você também deverá escolher Aplicativo nativo se estiver inserindo o conteúdo para usuários que não são do Power BI, independentemente de qual é o aplicativo real.
  5. Insira um valor para URL de redirecionamento e URL da Home Page. Qualquer URL válida funcionará.

    Observação:

    A URL da Home Page só estará disponível se você escolher Aplicativo Web do servidor para o tipo de aplicativo.

  6. Escolha as APIs às quais esse aplicativo terá acesso. Para obter mais informações sobre as permissões de acesso do Power BI, veja Permissões do Power BI.

  7. Selecione Registrar aplicativo.

    Em seguida, você receberá uma ID do cliente. Se você selecionou Aplicativo Web do servidor, você também receberá um Segredo do cliente. Eles podem ser recuperados no portal do Azure, mais tarde, se necessário.

Agora é possível usar o aplicativo registrado como parte do seu aplicativo personalizado para interagir com o serviço do Power BI.

Registrar com o portal do Azure

Sua outra opção para registrar seu aplicativo é fazer isso diretamente no portal do Azure. Para registrar seu aplicativo, siga estas etapas.

  1. Aceite os Termos da API do Microsoft Power BI.

  2. Entre no Portal do Azure.

  3. Escolha seu locatário do Azure AD selecionando a sua conta no canto superior direito da página.

  4. No painel de navegação esquerdo, escolha Mais serviços, selecione Registros de aplicativo e selecione Novo registro de aplicativo.

  5. Siga os prompts e crie um novo aplicativo.

    • Para aplicativos Web, forneça a URL de Logon, que é a URL base do seu aplicativo, na qual os usuários possam entrar, por ex., http://localhost:12345.
    • Para aplicativos nativos, forneça um URI de redirecionamento, que usa o Azure AD para retornar respostas de token. Insira um valor específico para seu aplicativo, por exemplo, http://MyFirstAADApp

Para obter mais informações sobre como registrar aplicativos no Azure Active Directory, consulte Integrando aplicativos ao Azure Active Directory

Como obter a ID do cliente

Ao registrar um aplicativo, 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 no Portal do Azure.

  2. Escolha seu locatário do Azure AD selecionando a sua conta no canto superior direito da página.

  3. No painel de navegação esquerdo, escolha Mais serviços e selecione Registros de aplicativo.

  4. Selecione o aplicativo para o qual você deseja recuperar a ID do cliente.

  5. Você verá a ID do aplicativo listada com um GUID. Esta é a ID do cliente para o aplicativo.

Próximas etapas

Inserindo com o Power BI
Como inserir seus dashboards, relatórios e blocos do Power BI
Permissões do Power BI
Criar um locatário do Azure Active Directory

Mais perguntas? Experimente perguntar à Comunidade do Power BI