Conector do Google Workspace (G Suite) (usando o Azure Functions) para o Microsoft Sentinel
O conector de dados do Google Workspace fornece a capacidade de ingerir eventos de Atividade do Google Workspace no Microsoft Sentinel por meio da API REST. O conector fornece a capacidade de obter eventos que ajudam a examinar possíveis riscos de segurança, analisar o uso de colaboração da sua equipe, diagnosticar problemas de configuração, controlar quem entra e quando, analisar a atividade do administrador, entender como os usuários criam e compartilham conteúdo e mais eventos de revisão na sua organização.
Atributos do conector
| Atributo do conector | Description |
|---|---|
| Código do aplicativo de funções do Azure | https://aka.ms/sentinel-GWorkspaceReportsAPI-functionapp |
| Tabela(s) do Log Analytics | GWorkspace_ReportsAPI_admin_CL GWorkspace_ReportsAPI_calendar_CL GWorkspace_ReportsAPI_drive_CL GWorkspace_ReportsAPI_login_CL GWorkspace_ReportsAPI_mobile_CL GWorkspace_ReportsAPI_token_CL GWorkspace_ReportsAPI_user_accounts_CL |
| Suporte às regras de coleta de dados | Sem suporte no momento |
| Com suporte por | Microsoft Corporation |
Exemplos de consulta
Eventos do Google Workspace – Todas as Atividades
GWorkspaceActivityReports
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade de Administração
GWorkspace_ReportsAPI_admin_CL
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade do Calendário
GWorkspace_ReportsAPI_calendar_CL
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade do Drive
GWorkspace_ReportsAPI_drive_CL
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade de Login
GWorkspace_ReportsAPI_login_CL
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade Móvel
GWorkspace_ReportsAPI_mobile_CL
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade de Token
GWorkspace_ReportsAPI_token_CL
| sort by TimeGenerated desc
Eventos do Google Workspace – Atividade de Contas do Usuário
GWorkspace_ReportsAPI_user_accounts_CL
| sort by TimeGenerated desc
Pré-requisitos
Para se integrar ao Google Workspace (G Suite) (usando o Azure Functions), verifique se você tem:
- Permissões do Microsoft.Web/sites: é necessário ter permissões de leitura e gravação no Azure Functions para criar um aplicativo de funções. Confira a documentação para saber mais sobre o Azure Functions.
- Credenciais/permissões da API REST: GooglePickleString é necessário para a API REST. Confira a documentação para saber mais sobre a API. Encontre as instruções para obter as credenciais na seção de configuração abaixo. Você também pode verificar todos os requisitos e seguir as instruções aqui.
Instruções de instalação do fornecedor
Observação
Esse conector usa o Azure Functions para se conectar à API REST do Google Reports para efetuar pull dos seus logs no Microsoft Sentinel. Isso pode resultar em custos adicionais de ingestão de dados. Consulte a página de preços do Azure Functions para obter detalhes.
(Etapa opcional): armazene o espaço de trabalho e as chaves de autorização ou tokens da API com segurança no Azure Key Vault. O Azure Key Vault fornece um mecanismo seguro para armazenar e recuperar valores de chave. Siga estas instruções para usar o Azure Key Vault com um aplicativos do Azure Function.
OBSERVAÇÃO: esse conector de dados depende de um analisador baseado em uma Função Kusto para funcionar conforme o esperado, o que é implantado como parte da solução. Para exibir o código de função no Log Analytics, abra o painel Logs do Microsoft Sentinel/Log Analytics, clique em Funções e pesquise o alias GWorkspaceReports e carregue o código da função ou clique aqui, na segunda linha da consulta, insira o(s) nome(s) do(s) host(s) do(s) dispositivo(s) GWorkspaceReports e quaisquer outros identificadores exclusivos para o fluxo de registro. A função geralmente leva de 10 a 15 minutos para ser ativada após a instalação/atualização da solução.
ETAPA 1 – Verifique os pré-requisitos para obter o Google Pickle String
- O Python 3 ou superior está instalado.
- A ferramenta de gerenciamento de pacote pip está disponível.
- Um domínio do Google Workspace com acesso à API habilitado.
- Uma conta do Google nesse domínio com privilégios de administrador.
ETAPA 2 – Etapas de configuração para a API do Google Reports
- Faça logon no Console da Google Cloud com suas credenciais de Administrador do Espaço de Trabalho https://console.cloud.google.com.
- Usando a opção de pesquisa (disponível na parte superior central), Pesquise por APIs e Serviços
- A partir de APIs e Serviços –>APIs e Serviços Habilitados , habilite aAPI do SDK de administrador para esse projeto.
- Vá para APIs e Serviços –>Tela de Consentimento do OAuth. Se ainda não estiver configurado, crie uma Tela de Consentimento do OAuth com as seguintes etapas:
- Forneça o Nome do Aplicativo e outras informações obrigatórias.
- Adicione os domínios autorizados com Acesso Habilitado à API.
- Na seção Escopos, adicione o escopo API do SDK de administrador.
- Na seção Testar Usuários, verifique se a conta de administrador de domínio foi adicionada.
- Acesse APIs e Serviços –>Credenciais e crie a ID do cliente OAuth 2.0
- Clique em Criar Credenciais na parte superior e selecione a ID do cliente Oauth.
- Selecione Aplicativo Web na lista suspensa Tipo de Aplicativo.
- Forneça um nome adequado para o Aplicativo Web e adicione http://localhost:8081/ como um dos URIs de redirecionamento autorizados.
- Depois de clicar em Criar, baixe o JSON a partir do pop-up que aparecer. Renomeie esse arquivo para "credentials.json".
- Para buscar o Google Pickel String, execute o script python na mesma pasta em que o arquivo credentials.json está salvo.
- Quando surgir a solicitação para fazer login, use as credenciais da conta de administrador de domínio.
Observação: Esse script só é compatível com o sistema operacional Windows. 7. A partir da saída da etapa anterior, copie a cadeia de caracteres do Google Pickle (contida entre aspas simples) e mantenha-a à mão. Ele será necessário na etapa de implantação do Aplicativo de Funções.
ETAPA 3 – Escolha UMA das duas opções de implantação a seguir para implantar o conector e o Azure Function associado
IMPORTANTE: antes de implantar o conector de dados do Workspace, tenha a ID do Espaço de Trabalho e a Chave Primária do Espaço de Trabalho (podem ser copiadas do seguinte), bem como o Workspace do GooglePickleString, prontamente disponíveis.
Opção 1: Modelo do Azure Resource Manager (ARM)
Utilize esse método para implantação automatizada do conector de dados do Google Workspace usando um Modelo ARM.
Clique no botão Implantar no Azure abaixo.
Selecione a Assinatura, o Grupo de Recursos e a Localização de sua preferência.
Insira a ID do workspace, a Chave do workspace, o GooglePickleString e implante.
Marque a caixa de seleção Concordo com os termos e condições declarados acima.
Clique em Comprar para implantar.
Opção 2 - Implantação Manual do Azure Functions
Use as seguintes instruções passo a passo para implantar o conector de dados do Googlw Workspace manualmente com o Azure Functions (Implantação através do Visual Studio Code).
1. Implantar um Aplicativo de Funções
OBSERVAÇÃO: você precisará preparar o VS Code para o desenvolvimento da função do Azure.
Baixe o arquivo do Aplicativo Azure Functions. Extraia o arquivo para seu computador de desenvolvimento local.
Iniciar o VS Code. Escolha Arquivo no menu principal e selecione Abrir Pasta.
Selecione a pasta de nível superior dos arquivos extraídos.
Escolha o ícone do Azure na barra de atividades e, na área Azure: Funções, escolha o botão Implantar no aplicativo de funções. Se você ainda não estiver conectado, escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções, escolha Entrar no Azure Se você já estiver conectado, vá para a próxima etapa.
Forneça as seguintes informações nos prompts:
a. Selecione a pasta: escolha uma pasta do seu espaço de trabalho ou navegue até uma que contenha seu aplicativo de funções.
b. Selecionar Assinatura: escolha a assinatura a ser usada.
c. Selecione Criar aplicativo de Funções no Azure (não escolha a opção Avançado)
d. Insira um nome globalmente exclusivo para o aplicativo de funções: digite um nome que seja válido em um caminho de URL. O nome que você digitar é validado para ter certeza de que ele é exclusivo no Azure Functions. (e.g. GWorkspaceXXXXX).
e. Selecione um runtime: escolha o Python 3.8.
f. Selecione uma localização para novos recursos. Para um melhor desempenho e custos mais baixos, escolha a mesma região onde o Microsoft Sentinel está localizado.
A implantação será iniciada. Uma notificação é exibida depois que seu aplicativo de funções é criado e o pacote de implantação é aplicado.
Acesse o Portal do Azure para ver a configuração do Aplicativo de Funções.
2. Configurar o Aplicativo de Funções
No Aplicativo de Funções, selecione o Nome do Aplicativo de Funções e selecione Configuração.
Na guia Configurações do aplicativo, selecione **Novas configurações do aplicativo**.
Adicione cada uma das seguintes configurações de aplicativo individualmente, com seus respectivos valores de cadeia de caracteres (diferenciam maiúsculas de minúsculas): GooglePickleString WorkspaceID WorkspaceKey logAnalyticsUri (opcional)
(Opcional) Altere os atrasos padrão, se necessário.
OBSERVAÇÃO: Os valores padrão a seguir para atrasos de ingestão foram adicionados para um conjunto diferente de logs do Google Workspace com base na documentação do Google. Eles podem ser modificados com base em requisitos ambientais. Atraso de busca – atraso de busca de calendário de 10 minutos – atraso de busca de chat de 6 horas – atraso de busca de contas de usuário de 1 dia – atraso de busca de logon de 3 horas – 6 horas
Use logAnalyticsUri para substituir o ponto de extremidade da API do Log Analytics para a nuvem dedicada. Por exemplo, para a nuvem pública, deixe o valor vazio; para o ambiente de nuvem do Azure GovUS, especifique o valor no seguinte formato:
https://<CustomerId>.ods.opinsights.azure.us.Após todas as configurações do aplicativo terem sido inseridas, clique em Salvar.
Próximas etapas
Para obter mais informações, acesse a solução relacionada no Azure Marketplace.