Como configurar a chave de acesso da integração com Power BI

A autenticação por chave no Power BI permite adicionar uma camada extra de segurança às URLs de exportação de dados do Ploomes, garantindo que apenas usuários autorizados tenham acesso às informações.

Com ela ativada, somente requisições autenticadas conseguem acessar os dados exportados, garantindo mais controle sobre informações sensíveis utilizadas em relatórios e dashboards, podendo ativar ou desativar a exigência de chave conforme necessário.

Pré-requisitos

Antes de realizar a configuração, valide os seguintes pontos:

A integração com o Power BI deve estar habilitada;
O usuário precisa possuir permissão de administrador;
É necessário ter acesso ao ambiente de configuração do Power BI para inserir os dados de autenticação.

Siga primeiro o artigo: Integração com Power BI.

Como ativar a autenticação por chave

1. Ativar autenticação nas URLs

Para ativar a autenticação nas URLs de exportação:

Acesse Integrações Plug and Play;
Localize a integração do Power BI;
Ative a opção Configuração de acesso aos dados da URL;
Clique em Atualizar integração.

Uma mensagem de confirmação será exibida, informando que todas as URL's antigas passarão a exigir chave.

⚠️ Atenção: ao ativar a autenticação por chave, todas as URLs de exportação existentes passarão a exigir autenticação.

Caso a configuração não seja atualizada no Power BI, os relatórios deixarão de carregar os dados corretamente.

2. Gerar ou atualizar a chave de acesso

Após ativar a autenticação:

Realize uma nova exportação para o Power BI ou acesse a tela Suas Exportações;
Localize os dados de:
- URL;
- Valor;
- Chave de acesso.

Caso ainda não exista uma chave gerada, clique na opção para gerar uma nova chave de acesso.

Caso já exista uma URL configurada no Power BI, você poderá reutilizar a mesma URL e atualizar apenas os campos de Valor e Chave de acesso no Power BI.

Caso já exista uma chave de acesso, a chave pode ser atualizada a qualquer momento. Após gerar uma nova chave, será necessário atualizar também a configuração correspondente no Power BI.

3. Configurar a chave no Power BI

Após identificar os dados de autenticação no Ploomes:

Acesse o Power BI;
Localize a configuração da conexão utilizada;
No campo Parâmetros do cabeçalho de solicitação HTTP, preencha:
- No campo da esquerda: o Valor informado no Ploomes;
- No campo da direita: a Chave de acesso correspondente.

Pronto!

Com isso, as requisições passarão a ser autenticadas corretamente.

Como funciona a autenticação nas exportações

URLs sem autenticação

Quando a autenticação estiver desativada:

Qualquer pessoa com acesso à URL poderá consumir os dados;
Os campos de Valor e Chave de acesso não serão exibidos.

URLs com autenticação

Ao ativar a autenticação:

Cada URL de exportação terá sua própria chave de acesso;
Será necessário configurar corretamente o Valor e a Chave de acesso no Power BI;
Requisições sem autenticação válida terão o acesso bloqueado.

Impacto nas URLs antigas

Todas as URLs de exportação geradas anteriormente passarão a exigir autenticação após a ativação da funcionalidade.

Por isso, será necessário atualizar as configurações existentes no Power BI.

O que acontece ao desativar a autenticação

Caso a autenticação seja desativada:

As URLs voltarão a funcionar sem autenticação;
As chaves geradas anteriormente serão desconsideradas.

Avisos de segurança e comportamento do sistema

Um alerta será exibido ao ativar a autenticação, reforçando que as URLs antigas passarão a exigir chave.
A chave deve ser inserida corretamente no Power BI para não interromper o consumo de dados.
A qualquer momento você poderá gerar uma nova URL ou uma nova chave. Lembre-se de sempre manter esses campos atualizados no Power BI.

Limitações da funcionalidade

Cada URL exportada possui sua própria chave de acesso;
Chaves não podem ser reutilizadas entre exportações diferentes;
Caso o usuário responsável pela exportação seja desativado ou perca a permissão de exportação, a URL correspondente deixará de funcionar;
A atualização da chave exige reconfiguração no Power BI.

Perguntas frequentes

1. O que acontece com as URLs antigas quando ativo a chave?

As URLs antigas passam a exigir a chave de autenticação.

Caso a configuração não seja atualizada no Power BI, o acesso aos dados será bloqueado.

2. Posso desativar a exigência de chave a qualquer momento?

Sim. Ao desativar, as URLs voltam a funcionar normalmente, sem necessidade de autenticação.

3. Como validar se minha chave está funcionando?

Após configurar corretamente os parâmetros no Power BI, os dados serão carregados normalmente.

Caso exista algum erro na autenticação, o Power BI exibirá uma mensagem de falha de acesso.

4. A minha chave pode ser utilizada em URLs geradas por terceiros, mesmo que para a exportação de uma mesma aba?

Não. Cada exportação possui sua própria URL e sua própria chave de acesso, mesmo quando dois usuários exportam a mesma aba.

5. A chave de acesso influencia nos prazos de expiração?

Não. A chave de acesso e o prazo de expiração são configurações independentes.

6. Ativei a integração. Ainda posso acessar meu relatório/dashboard externamente pela URL do Power BI na web ou em outros sistemas?

Não. Após ativar a autenticação por chave, qualquer integração ou consulta externa que utilize apenas a URL de exportação deixará de funcionar sem autenticação válida. Os dados passam a ser acessíveis apenas dentro da plataforma, garantindo mais segurança e controle dos dados.

Glossário

Chave de acesso/autenticação: código gerado que permite validar o acesso a uma URL de dados exportados.
Power BI: ferramenta da Microsoft utilizada para análise e visualização de dados.
URL de exportação: URL que permite consumir dados do Ploomes diretamente no Power BI.
Parâmetros do cabeçalho de solicitação HTTP: são informações extras, ou "cabeçalhos de solicitação" específicos, que você envia para realizar uma consulta de informações na WEB. No nosso caso, preenchemos e enviamos as informações de autenticação para que o servidor possa reconhecer quem deseja fazer a solicitação e, caso as credenciais correspondam ao esperado, os dados extraídos do Ploomes para o Power BI serão apresentados.

Pesquisa