Exercício: configurar o conector do log de auditoria
O fluxo de sincronização do log de auditoria se conecta ao log de auditoria do Microsoft 365 para reunir dados, como usuários exclusivos e lançamentos de aplicativos. O fluxo usa um conector personalizado para conectar-se ao log de auditoria. Nas instruções a seguir, você configurará o conector personalizado e o fluxo.
Observação
O Kit de início do CoE (Centro de Excelência) funcionará sem esse fluxo, mas as informações de uso ficarão em branco no painel do Power BI.
Antes de usar o conector de log de auditoria
Antes de usar o conector de log de auditoria, será necessário atender aos seguintes pré-requisitos:
A pesquisa de log de auditoria do Microsoft 365 deve ser ativada para que o conector de log de auditoria funcione. Para obter mais informações, consulte Ativar ou desativar a pesquisa de log de auditoria.
Seu locatário deve ter uma assinatura que ofereça suporte ao log de auditoria unificada. Para obter mais informações, consulte Diretrizes do Microsoft 365 para segurança e conformidade.
É necessário um administrador global para configurar o registro do aplicativo do Microsoft Entra.
As APIs de Gestão do Office 365 usam o Microsoft Entra ID a fim de fornecer serviços de autenticação que você pode usar para conceder direitos para seu aplicativo acessá-las.
Criar um registro de aplicativo do Microsoft Entra para a API de Gestão do Office 365
Usando essas etapas, você pode configurar um registro de aplicativo do Microsoft Entra para uma chamada HTTP em um fluxo do Power Automate para se conectar ao log de auditoria. Para obter mais informações, consulte Introdução às APIs de Gestão do Office 365.
Entre no portal.azure.com.
Vá para o Microsoft Entra ID, procure e selecione Registros de aplicativo.
Selecione Novo Registro.
Insira um nome (como Gerenciamento do Microsoft 365), mas não altere nenhuma outra configuração. Selecione Registrar.
Selecione Permissões de API > Adicionar uma permissão.
Selecione API de Gestão do Office 365 e configure as permissões desta maneira:
a. Selecione Permissões delegadas e ActivityFeed.Read.
b. Selecione Permissões de aplicativo, ActivityFeed.Read e ServiceHealth.Read.
c. Selecione Adicionar permissões.
Selecione Conceder consentimento do administrador para (sua organização).
As permissões da API agora refletem as permissões ActivityFeed.Read delegada e ActivityFeed.Read e ServiceHealth.Read de aplicativo, com o status de Concedido para (sua organização).
Selecione Certificados e segredos.
Selecione Novo segredo do cliente.
Adicione uma descrição e uma expiração (de acordo com as políticas da sua organização) e selecione Adicionar.
Copie e cole o segredo em um documento de texto no Bloco de Notas do Windows por enquanto.
Selecione Visão geral e copie e cole a ID do aplicativo (cliente) em um documento de texto.
Atualizar variáveis de ambiente
Variáveis de ambiente são usadas para armazenar a ID do Cliente e o segredo para o registro do aplicativo. Também armazenam os pontos de extremidade de serviço de autoridade e público-alvo, dependendo de sua nuvem (comercial, GCC, GCC High, DoD) para a ação HTTP. Atualize as variáveis de ambiente antes de ativar os fluxos.
Observação
Você pode armazenar o segredo do cliente em texto sem formatação na variável de ambiente Logs de Auditoria: Segredo do Cliente ou pode armazenar o segredo do cliente no Azure Key Vault e referenciá-lo na variável de ambiente Logs de Auditoria: Segredo do Cliente do Azure. Estas etapas descrevem o uso de um segredo do cliente, embora o Azure Key Vault seja o método recomendado pela Microsoft.
Acesse o Power Apps.
Vá para Soluções.
Selecione a guia Todos e selecione a solução Centro de Excelência: Componentes Principais para abri-la.
Selecione Aplicativos no menu esquerdo e execute o aplicativo Centro de Comando Administrativo do CoE.
Selecione Variáveis de Ambiente no menu esquerdo do aplicativo.
Encontre a variável de ambiente Logs de Auditoria: Público-alvo e verifique se o valor corresponde ao ponto de extremidade de serviço do público-alvo para seu tipo de nuvem.
Você pode encontrar os valores de público-alvo para seu tipo de nuvem na tabela abaixo. Se o valor não corresponder a seu tipo de nuvem, selecione a linha no aplicativo Centro de Comando e selecione Editar na barra de comandos.
Insira o valor secreto que foi copiado da seção anterior.
Encontre a variável de ambiente Logs de Auditoria: Autoridade e verifique se o valor corresponde ao ponto de extremidade do serviço de autoridade para seu tipo de nuvem.
Você pode encontrar os valores de autoridade para seu tipo de nuvem na tabela abaixo. Se o valor não corresponder a seu tipo de nuvem, selecione a linha no aplicativo Centro de Comando e selecione Editar na barra de comandos.
Encontre a variável de ambiente Logs de Auditoria: ID do Cliente e insira a ID do cliente que foi copiada da seção anterior.
Encontre a variável Logs de Auditoria: Segredo do Cliente e insira o Segredo do Cliente que foi copiado da seção anterior.
Observação
O fluxo que usa essa variável de ambiente está configurado com uma condição para esperar a variável de ambiente Logs de Auditoria: Segredo do Cliente ou Logs de Auditoria: Segredo do Cliente do Azure. Não é necessário editar o fluxo para trabalhar com o Azure Key Vault.
| Nome | Descrição | Valor |
|---|---|---|
| Logs de Auditoria: Público-alvo | O parâmetro de audiência para as chamadas HTTP. | Comercial (Padrão): https://manage.office.com GCC: https://manage-gcc.office.com GCC High: https://manage.office365.us DoD: https://manage.protection.apps.mil |
| Logs de Auditoria: Autoridade | O campo de autoridade nas chamadas HTTP. | Comercial (Padrão): https://login.windows.net GCC: https://login.windows.net GCC High: https://login.microsoftonline.us DoD: https://login.microsoftonline.us |
| Logs de Auditoria: ClientID | ID do Cliente de Registro do aplicativo. | A ID do cliente do aplicativo da etapa Criar um registro de aplicativo do Microsoft Entra para a API de Gestão do Office 365. |
| Logs de Auditoria: Segredo do Cliente | Segredo do cliente de registro de aplicativo em texto sem formatação. | O segredo do cliente do aplicativo da etapa Criar um registro de aplicativo do Microsoft Entra para a API de Gestão do Office 365. Deixe em branco se estiver usando o Azure Key Vault para armazenar a ID e o segredo do cliente. |
| Logs de Auditoria: Segredo do Cliente do Azure | Referência do Azure Key Vault do segredo do cliente de Registro do aplicativo. | A referência do Azure Key Vault para o segredo do cliente do aplicativo da etapa Criar um registro de aplicativo do Microsoft Entra para a API de Gestão do Office 365. Deixe em branco se você estiver armazenando a ID do cliente em texto sem formatação na variável de ambiente Logs de Auditoria: Segredo do Cliente. Essa variável espera a referência do Azure Key Vault, não o segredo. Saiba mais: usar segredos do Azure Key Vault em variáveis de ambiente |
Iniciar uma assinatura para o conteúdo do log de auditoria
Acesse o PowerApps
Selecione Soluções no menu à esquerda.
Selecione a guia Tudo para ver todas as soluções.
Abra a solução Centro de Excelência — Componentes Principais.
Ative o fluxo Administrador | Logs de Auditoria | Assinatura da API de Gestão do Office 365, execute-o e insira start como a operação a ser executada.
Abra o fluxo e verifique se a ação para iniciar a assinatura é aprovada.
Importante
Se já tiver habilitado a assinatura, você verá uma mensagem (400) A assinatura já está habilitada. Isso significa que a assinatura foi habilitada com êxito no passado. Você pode ignorar esse erro e continuar com a configuração. Se você não vir a mensagem acima ou uma resposta (200), a solicitação poderá ter falhado. Pode haver um erro em sua configuração que está impedindo o funcionamento do fluxo. Problemas comuns a serem verificados são:
- Os logs de auditoria estão habilitados e você tem permissão para exibi-los? Verifique se você pode pesquisar no Gerenciador de Conformidade da Microsoft.
- Você habilitou o log de auditoria recentemente? Nesse caso, tente novamente em alguns minutos, para dar tempo ao log de auditoria para ser ativado.
- Valide se você seguiu corretamente as etapas no registro do aplicativo do Microsoft Entra.
Valide se você atualizou corretamente as variáveis de ambiente para esses fluxos.
Ativar fluxos
Vá para make.powerapps.com.
Selecione a guia Tudo para ver todas as soluções.
Abra a solução Centro de Excelência — Componentes Principais.
Ative o fluxo Administrador | Logs de Auditoria | Sincronizar Logs de Auditoria (V2). Esse fluxo é executado de hora em hora e coleta eventos de log de auditoria na tabela Log de Auditoria.