Excel e Power BI usando OAuth 2.0

Este artigo explica como extrair dados ao vivo do Fluid para o Microsoft Excel e o Power BI usando o login seguro com OAuth 2.0 e Microsoft Entra ID (anteriormente Azure AD). Cada pessoa faz login com sua própria conta Microsoft corporativa ("Conta organizacional") – não há tokens de API para copiar ou armazenar.

As etapas abaixo usam o Excel, mas as etapas de conexão e login são idênticas no Power BI Desktop – basta usar Obter Dados no lugar de Da Web.

Quando você conecta o Excel ou o Power BI a uma URL de dados do Fluid, o Fluid responde "por favor, faça login" e informa à sua ferramenta onde fazer isso. O Excel/Power BI abre uma janela de login da Microsoft, você faz login com sua conta corporativa e a Microsoft devolve um token de acesso seguro para o seu site Fluid. O Excel/Power BI então usa esse token para carregar seus dados. O token é atualizado automaticamente, portanto a conexão continua funcionando sem que você precise inserir nada novamente.

Como você faz login como você mesmo, você só verá os dados do Fluid que sua própria conta Fluid tem permissão para ver.

NOTA para administradores: O Fluid publica um único aplicativo "Fluid API" verificado pela Microsoft (registrado e mantido pelo Fluid). Você não registra seu próprio aplicativo nem gerencia URIs de ID de aplicativo, escopos ou segredos de cliente. Sua única tarefa no Entra é um consentimento de administrador único para que a Fluid API possa operar em seu locatário (Etapa 2). Quando o Excel/Power BI faz login, eles solicitam um token para o endereço web do seu site Fluid – o Fluid já configurou seu aplicativo para aceitar esse endereço.

Você precisará de:

O relatório OAuth 2.0 deve ser ativado para o seu site Fluid, e o endereço web do seu site (por exemplo https://yourcompany.fluid.work) deve ser registrado no aplicativo Fluid API para que a Microsoft emita tokens para ele.

1. Faça login na sua instância Fluid como administrador Fluid e clique na foto do seu perfil no canto superior direito, escolha Console de Administração > Provedor de Autenticação (ou navegue até /Config/AuthenticationProvider).

2. Habilitar OAuth2 API

   

Para que a Microsoft permita que o Excel e o Power BI obtenham um token para o Fluid, um administrador do Microsoft Entra na sua organização concede consentimento único ao aplicativo Fluid API. Você gera o link de consentimento diretamente do seu console de administração Fluid.

1. Faça login na sua instância Fluid como administrador Fluid e clique na foto do seu perfil no canto superior direito, escolha Console de Administração > Provedor de Autenticação (ou navegue até /Config/AuthenticationProvider).

2. Localize o campo GUID do Seu Locatário Entra e insira o ID do locatário do Microsoft Entra — um GUID no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Você pode encontrá-lo no Portal do Azure em Microsoft Entra ID > Visão Geral.

3. Depois de inserir o ID do locatário, o campo URL de Consentimento da Fluid API cria automaticamente o link de consentimento de administrador correto para o seu locatário.

   

4. Clique no ícone de copiar ao lado do campo URL de Consentimento da Fluid API para copiar o link para a área de transferência. Ele será semelhante ao exemplo abaixo:

   https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/adminconsent?client_id=69c9b574-a5bf-46ca-bb04-ed5793d298e4&redirect_uri=https://www.fluid.work

5. Envie o link copiado para um administrador do Microsoft Entra na sua organização (ou abra-o você mesmo se tiver essa função). O administrador abre o link, faz login e aceita o prompt de permissões. Isso registra a Fluid API no seu locatário para que seus usuários possam fazer login nela pelo Excel e pelo Power BI.

NOTA: Esta é uma etapa de consentimento, não um registro de aplicativo. Você está aprovando o aplicativo publicado do Fluid – você não o cria nem o possui. Sem esse consentimento, o login pode falhar com AADSTS650057 ou "Aprovação de administrador necessária".

A configuração está concluída. Os criadores de relatórios podem se conectar a qualquer momento usando a Parte 2.

Você precisa do endereço web (URL) dos dados do Fluid sobre os quais deseja criar relatórios. Este é um endereço Fluid normal que começa com o seu site Fluid, por exemplo:

https://yourcompany.fluid.work/api/...

• Muitas páginas e listas do Fluid oferecem isso por meio de Ferramentas > Exportar (ou uma opção Obter dados / feed) – use isso para obter a URL.

• Se não tiver certeza de qual URL usar, pergunte ao seu Gerente de Conta Fluid ou administrador pela URL de relatório/feed.

DICA: Abra o Bloco de Notas e cole a URL lá para que você possa copiá-la corretamente para o Excel ou Power BI na próxima etapa.

1. No Excel, vá para a guia Dados > Obter Dados > De Outras Fontes > Da Web. (Para uma lista simples, você também pode usar Do Feed OData se o Fluid fornecer um.)

2. Cole a URL de dados do Fluid na caixa de diálogo Da Web e selecione OK.

3. Quando solicitado a fazer login, selecione Conta organizacional à esquerda e, em seguida, selecione Entrar.

NOTA: Escolher Conta organizacional é o que aciona o login seguro com OAuth 2.0. Não escolha Anônimo ou Windows – esses não serão aceitos pelo Fluid.

A caixa de diálogo de login Da Web com Conta organizacional selecionada e o botão Entrar destacado.

4. Faça login com sua conta corporativa Microsoft. Na primeira vez, pode ser solicitado que você aceite um prompt de permissão.

5. Selecione Conectar.

6. No Navegador / Editor do Power Query, formate os dados se necessário (por exemplo, selecione Para Tabela e, em seguida, OK para expandir as linhas em colunas) e escolha Fechar e Carregar para trazer os dados para a sua planilha.

As etapas são as mesmas, usando a faixa de opções do Power BI:

1. Na guia Início, selecione Obter Dados > Web (ou Feed OData).

2. Cole sua URL de dados do Fluid e selecione OK.

3. Quando solicitado, selecione Conta organizacional > Entrar, faça login com sua conta corporativa e selecione Conectar.

4. Modele os dados no Editor do Power Query se necessário, depois selecione Fechar e Aplicar.

• Atualização manual: no Excel use Dados > Atualizar Tudo; no Power BI Desktop use Início > Atualizar. Seu login salvo é reutilizado automaticamente.

• Atualização agendada no serviço do Power BI: após publicar seu relatório, abra as Configurações do modelo semântico (conjunto de dados) > Credenciais da fonte de dados, selecione Editar credenciais, escolha OAuth2 e faça login.

OBSERVAÇÃO: A atualização agendada é executada com a conta que fez login nas credenciais da fonte de dados, portanto essa conta deve ter um usuário Fluid ativo correspondente com permissão para os dados. Para a configuração completa (incluindo o uso de uma conta de atualização dedicada e o gerenciamento de expiração de credenciais), consulte Agendando atualização automática do Power BI a partir do Fluid.

• Para o lado do Fluid (habilitação do OAuth 2.0, registro do endereço do seu site, a URL de dados correta, contas de usuário e permissões), entre em contato com seu Administrador do Sistema Fluid ou Gerente de Conta Fluid.

• Para o lado do Microsoft Entra (consentimento do administrador, acesso condicional, contas corporativas dos seus usuários), entre em contato com seu administrador do Microsoft 365 / Azure.

• Agendando atualização automática do Power BI a partir do Fluid OAuth 2.0

• Conectando o Power Apps ao Fluid usando OAuth 2.0

• Acesso programático à API do Fluid usando OAuth 2.0

• Configurando o Power Automate para chamar a API do Fluid usando OAuth 2.0