Partilhar via

Conector do Google Workspace (G Suite) (usando o Azure Functions) para o Microsoft Sentinel

  • Artigo

O conector de dados do Google Workspace oferece 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 potenciais riscos de segurança, analisar o uso da colaboração pela sua equipe, diagnosticar problemas de configuração, rastrear 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 em sua organização.

Trata-se de conteúdo gerado automaticamente. Para alterações, entre em contato com o provedor da solução.

Atributos do conector

Atributo do conector Description
Código do aplicativo de função 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 a regras de coleta de dados Não é suportado atualmente
Apoiado por Corporação Microsoft

Exemplos de consulta

Eventos do Google Workspace - Todas as atividades

GWorkspaceActivityReports

| sort by TimeGenerated desc

Eventos do Google Workspace - Atividade do administrador

GWorkspace_ReportsAPI_admin_CL

| sort by TimeGenerated desc

Eventos do Google Workspace - Atividade do Google Agenda

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 das Contas de usuário

GWorkspace_ReportsAPI_user_accounts_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com o Google Workspace (G Suite) (utilizando o Azure Functions), certifique-se de que tem:

Instruções de instalação do fornecedor

Nota

Esse conector usa o Azure Functions para se conectar à API do Google Reports para extrair seus logs para o 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 com segurança a(s) chave(s) de autorização do espaço de trabalho e da API ou código(s) no Cofre de Chaves do Azure. 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 Aplicativo de Função do Azure.

NOTA: Este conector de dados depende de um analisador baseado numa Função Kusto para funcionar como esperado, que é implementado como parte da solução. Para visualizar o código da função no Log Analytics, abra a folha Log Analytics/Microsoft Sentinel Logs, clique em Funções e procure o alias GWorkspaceReports e carregue o código da função, na segunda linha da consulta, insira o(s) nome(s) do(s) seu(s) dispositivo(s) GWorkspaceReports e quaisquer outros identificadores exclusivos para o fluxo de log. A função geralmente leva de 10 a 15 minutos para ser ativada após a instalação/atualização da solução.

PASSO 1 - Certifique-se dos pré-requisitos para obter o Google Pickel String

  1. Python 3 ou superior está instalado.
  2. A ferramenta de gerenciamento de pacotes pip está disponível.
  3. Um domínio do Google Workspace com acesso à API ativado.
  4. Uma Conta Google nesse domínio com privilégios de administrador.

PASSO 2 - Passos de configuração para a API do Google Reports

  1. Faça login no console de nuvem do Google com suas credenciais https://console.cloud.google.comde administrador do espaço de trabalho .
  2. Usando a opção de pesquisa (disponível no meio superior), Pesquisar APIs & Serviços
  3. Em APIs & Services ->Enabled APIs & Services, habilite a API Admin SDK para este projeto.
  4. Vá para APIs & Serviços ->Tela de Consentimento OAuth. Se ainda não estiver configurado, crie uma tela de consentimento OAuth com as seguintes etapas:
    1. Forneça o nome do aplicativo e outras informações obrigatórias.
    2. Adicione domínios autorizados com o Acesso à API habilitado.
    3. Na seção Escopos, adicione o escopo da API do SDK do administrador.
    4. Na seção Usuários de Teste, verifique se a conta de administrador do domínio foi adicionada.
  5. Vá para APIs & Services ->Credentials e crie a ID do Cliente OAuth 2.0
    1. Clique em Criar credenciais na parte superior e selecione ID do cliente Oauth.
    2. Selecione Aplicativo Web na lista suspensa Tipo de aplicativo.
    3. Forneça um nome adequado ao Aplicativo Web e adicione http://localhost:8081/ como um dos URIs de redirecionamento autorizados.
    4. Depois de clicar em Criar, baixe o JSON do pop-up exibido. Renomeie este arquivo para "credentials.json".
  6. Para buscar o Google Pickel String, execute o script python da mesma pasta onde credentials.json é salvo.
    1. Quando aparecer para entrar, use as credenciais da conta de administrador do domínio para fazer login.

Nota: Este script é suportado apenas no sistema operativo Windows. 7. A partir da saída da etapa anterior, copie o Google Pickle String (contido entre aspas simples) e mantenha-o à mão. Ele será necessário na etapa de implantação do Function App.

ETAPA 3 - Escolha UMA das duas opções de implantação a seguir para implantar o conector e a Função do Azure associada

IMPORTANTE: Antes de implantar o conector de dados do espaço de trabalho, tenha o ID do espaço de trabalho e a chave primária do espaço de trabalho (pode ser copiado do seguinte), bem como o GooglePickleString do espaço de trabalho prontamente disponível.

Opção 1 - Modelo do Azure Resource Manager (ARM)

Use esse método para a implantação automatizada do conector de dados do Google Workspace usando um modelo ARM.

  1. Clique no botão Implantar no Azure abaixo.

    Implementar no Azure

  2. Selecione a Subscrição, o Grupo de Recursos e a Localização preferidos.

  3. Insira o ID do espaço de trabalho, a chave do espaço de trabalho, o GooglePickleString e implante.

  4. Marque a caixa de seleção Concordo com os termos e condições mencionados acima.

  5. Clique em Comprar para implantar.

Opção 2 - Implantação manual do Azure Functions

Use as instruções passo a passo a seguir para implantar o conector de dados do Google Workspace manualmente com o Azure Functions (Implantação por meio do Visual Studio Code).

1. Implantar um aplicativo de função

NOTA: Você precisará preparar o código VS para o desenvolvimento da função do Azure.

  1. Baixe o arquivo do Aplicativo Azure Function. Extraia o arquivo para o computador de desenvolvimento local.

  2. Inicie o VS Code. Escolha Arquivo no menu principal e selecione Abrir pasta.

  3. Selecione a pasta de nível superior dos arquivos extraídos.

  4. Escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções , escolha o botão Implantar para o aplicativo funcional. Se ainda não tiver sessão iniciada, escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções , selecione Iniciar sessão no Azure Se já tiver sessão iniciada, avance para o passo seguinte.

  5. Forneça as seguintes informações nos pedidos:

    a. Selecionar pasta: escolha uma pasta no seu espaço de trabalho ou navegue até uma que contenha seu aplicativo de função.

    b. Selecione Assinatura: escolha a assinatura a ser usada.

    c. Selecione Criar novo aplicativo de função no Azure (Não escolha a opção Avançado)

    d. Insira um nome globalmente exclusivo para o aplicativo de função: digite um nome válido em um caminho de URL. O nome digitado é validado para garantir que seja exclusivo no Azure Functions. (por exemplo, GWorkspaceXXXXX).

    e. Selecione um tempo de execução: Escolha Python 3.8.

    f. Selecione um local para novos recursos. Para um melhor desempenho e custos mais baixos, escolha a mesma região onde o Microsoft Sentinel está localizado.

  6. A implantação será iniciada. Depois de criar a aplicação de funções, é apresentada uma notificação e o pacote de implementação é aplicado.

  7. Vá para o Portal do Azure para a configuração do Aplicativo de Função.

2. Configurar o aplicativo de função

  1. No Aplicativo de Função, selecione o Nome do Aplicativo de Função e selecione Configuração.

  2. Na guia Configurações do aplicativo , selecione ** Nova configuração do aplicativo**.

  3. Adicione cada uma das seguintes configurações do aplicativo individualmente, com seus respetivos valores de cadeia de caracteres (diferencia maiúsculas de minúsculas): GooglePickleString WorkspaceID WorkspaceKey logAnalyticsUri (opcional)

  4. (Opcional) Altere os atrasos padrão, se necessário.

    NOTA: Os seguintes valores padrão para atrasos de ingestão foram adicionados para diferentes conjuntos de logs do Google Workspace com base na documentação do Google. Estes podem ser modificados com base em requisitos ambientais. Fetch Delay - 10 minutos Calendar Fetch Delay - 6 horas Chat Fetch Delay - 1 dia Contas de usuário Fetch Delay - 3 horas Login Fetch Delay - 6 horas

  5. Use logAnalyticsUri para substituir o ponto de extremidade da API de análise de log para nuvem dedicada. Por exemplo, para nuvem pública, deixe o valor vazio; para o ambiente de nuvem Azure GovUS, especifique o valor no seguinte formato: https://<CustomerId>.ods.opinsights.azure.us.

  6. Depois que todas as configurações do aplicativo tiverem sido inseridas, clique em Salvar.

Próximos passos

Para obter mais informações, vá para a solução relacionada no Azure Marketplace.