Neste artigo, vamos orientá-lo através do processo de configuração de um service principal para PowerBI no Microsoft Azure e conectá-lo ao OptiSigns.
- Criando um Aplicativo Entra no Microsoft Azure
- Habilitar Configurações de Administração do PowerBI Service
- Autenticando o OptiSigns via Service Principal
- Exibindo o PowerBI em uma Tela
Usar um service principal do PowerBI com registro de aplicativo é a opção preferida para empresas com regras rígidas de segurança da informação que não desejam usar contas de usuário individuais para integração com PowerBI.
Isso reduz problemas em situações quando:
- Há uma mudança de cargo ou permissão de um usuário e a autenticação precisa ser realizada novamente por um usuário diferente.
- Um período prolongado de token de autenticação não pode ser definido para usuários individuais, e você precisará reautorizar e atualizar o token a cada dois meses.
Usando um service principal do PowerBI, os tokens de autenticação são associados a um aplicativo registrado em vez de um usuário. Isso permite definir um tempo de validade mais longo para o token de autenticação e evita reautorizações mais frequentes. O uso de service principal com registro de aplicativo para integração com Power BI é bem suportado pelo OptiSigns.
| OBSERVAÇÃO: Este recurso está disponível apenas para clientes com plano Enterprise. |
Criar um Aplicativo Entra no Microsoft Azure
Um aplicativo Entra será responsável por gerenciar identidade e acesso para seu service principal. Para criar um, você precisará fazer login no Microsoft Azure com uma conta Microsoft válida.
Uma vez no portal do Azure, pesquise por "registros de aplicativo", depois selecione Registros de aplicativo da lista que aparece:
Crie um Novo registro.
Nesta tela, digite um nome para o aplicativo e deixe as outras configurações como padrão. Estas podem ser alteradas ou modificadas a qualquer momento.
Quando terminar, clique em Registrar.
Habilitar Configurações de Administração do PowerBI Service
Siga este link para o Portal de Administração do PowerBI.
Uma vez lá, clique em Configurações de locatário. Em seguida, role até Configurações do desenvolvedor.
Habilite a opção Incorporar conteúdo em aplicativos, conforme abaixo:
Neste exemplo, configuramos esta incorporação para aplicar permissões a toda a organização. No entanto, você pode restringir o acesso a grupos de segurança específicos com base em suas necessidades. Essas configurações de segurança podem ser alteradas conforme seus requisitos.
Em seguida, Habilite Service principals podem criar workspaces, conexões e pipelines de implantação e Habilite Service principals podem chamar APIs públicas do Fabric, conforme abaixo:
Como anteriormente, aplicamos estas configurações a toda a organização. Assim como no último passo, você pode restringir o acesso a grupos de segurança específicos com base em suas necessidades.
Adicionar o Service Principal a um Workspace
Agora precisamos atribuir acesso do service principal aos workspaces que você deseja mostrar em seus relatórios do PowerBI.
No portal de administração, clique em Workspaces. Vá para o workspace ao qual você deseja atribuir acesso do service principal. Clique no workspace e depois em Acesso.
Adicione o service principal que você criou no passo anterior como membro do workspace.
Autenticando o OptiSigns via Service Principal
Para autenticar seu PowerBI no OptiSigns via service principal, você precisará de quatro informações:
- Nome do service principal
- ID do aplicativo (cliente)
- ID do diretório (locatário)
- Segredo do aplicativo (cliente)
Como já criamos um aplicativo Entra no Azure, já temos acesso às três primeiras informações. Estas podem ser encontradas em Registros de aplicativo no Azure.
Neste exemplo, os valores foram desfocados, mas em seu portal do Azure, estes devem estar visíveis.
A única informação que você não terá é o segredo do cliente. Para obtê-lo, clique em Gerenciar → Certificados e segredos → Segredos do cliente → Novo segredo do cliente
Em seguida, defina a Descrição e Expiração, depois clique em Adicionar.
O Valor apresentado é a última informação de que você precisa.
Agora, acesse o aplicativo OptiSigns. Clique em seu Nome de perfil → Mais → Integrações.
Uma tela como a abaixo aparecerá. Clique em Adicionar Service Principal do Azure.
Quando o popup aparecer, colete as informações mencionadas acima do Microsoft Azure e insira-as no OptiSigns. Os valores correspondem assim:
Depois que todas as informações forem inseridas corretamente, clique em Salvar. Agora seu Service Principal está salvo no portal OptiSigns.
Exibindo o PowerBI em uma Tela
Agora precisaremos configurar seu ativo PowerBI no OptiSigns para uso com suas telas.
No portal OptiSigns, vá para Arquivos/Ativos → Apps → PowerBI
Marque Usar Service Principal e selecione o service principal que você configurou no último passo, ou qualquer service principal que você queira usar.
| OBSERVAÇÃO: Usando um service principal, o link da URL do Dashboard do Power BI precisa incluir o ID real do workspace (grupo) em vez de me. |
Finalmente, insira a URL do relatório que você deseja compartilhar. Nomeie o aplicativo como preferir e clique em Visualizar para ver seu relatório.
Clique em Salvar, e este aplicativo PowerBI existirá como um ativo. Ele pode ser enviado para qualquer uma de suas telas individualmente, agendado ou adicionado a uma Lista de reprodução.
É isso!
Se você tiver perguntas adicionais, preocupações ou qualquer feedback sobre o OptiSigns, sinta-se à vontade para entrar em contato com nossa equipe de suporte em support@optisigns.com.