Atividade de auditoria do Google Workspace
Beta
Lakewatch está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias no nível do workspace.
O Lakewatch fornece um conector de API para ingerir a atividade de auditoria de aplicações e serviços do Google Workspace. Este artigo aborda pré-requisitos, instruções de configuração, o esquema do conector e observáveis de segurança.
Pré-requisitos
O conector exige:
-
Serverless Lakeflow pipelines ativados no seu workspace.
-
Unity Catalog, com privilégios para criar ou usar uma conexão do Unity Catalog. Consulte Permissões de conexão.
-
A pré-visualização do Lakeflow Connect para Google Workspace ativada em seu workspace por um administrador do workspace. Consulte Ativar a prévia do conector.
-
Se a política de rede serverless do seu workspace usar acesso restrito, os domínios de API da fonte deverão estar na lista de Domínios permitidos da política. Veja Permitir os domínios de API de origem em sua política de rede.
-
Uma account de administrador do Google Workspace com o privilégio Relatórios . Os superadministradores já têm esse privilégio. Caso contrário, crie uma função de administrador personalizada que inclua Relatórios e, em seguida, atribua a função à account que autoriza a conexão. Relatórios está listado em Relatórios na lista de privilégios.
- Para ingerir a atividade de auditoria do Vault, inclua o privilégio Google Vault Access All Logs na mesma função personalizada, em Vault .
-
Acesso a um projeto do Google Cloud onde você pode habilitar a API do Admin SDK e criar credenciais OAuth.
-
Uma edição compatível para cada aplicativo do Google Workspace que exige uma. O Lakewatch grava esses aplicativos na tabela
activitiescombinada:- As atividades Drive e Keep requerem uma edição Business ou Enterprise. Consulte a referência da API de relatórios do SDK de administrador.
- A atividade de transparência de acesso requer Frontline Plus, Enterprise Plus, Education Standard, Education Plus ou Enterprise Essentials Plus. Consulte Transparência de acesso.
- A atividade do Vault requer uma licença complementar do Google Vault. Veja Licenciamento do Google Vault.
Limitações conhecidas
- O conector ingere a atividade de auditoria da API de Relatórios do Admin SDK. Ele não ingere conteúdo de caixa de correio, arquivos do Google Drive ou outros recursos do Google Workspace.
- A retrospectiva histórica não pode exceder 179 dias. O Google mantém relatórios de atividades de auditoria por 180 dias. Consulte Escolher até que ponto ingerir.
- O conector suporta a autenticação OAuth user-to-machine (U2M). A autenticação OAuth M2M, nome de usuário e senha, e API key não são suportadas.
- O Google limita cada combinação de account do Google e cliente OAuth a 100 tokens de refresh. A criação de outro token invalida o token mais antigo.
Configure o Google Workspace para incorporação
Crie um projeto do Google Cloud, configure a tela de consentimento do OAuth, habilite a API Admin SDK e crie credenciais de cliente OAuth. Use o ID e o segredo do cliente resultantes para criar a conexão do Unity Catalog no Databricks. Para mais informações, consulte Habilitar APIs do Google Workspace e Criar credenciais de acesso.
Criar ou selecionar um projeto do Google Cloud
- log in o console do Google Cloud.
- Na parte superior da página, abra o seletor de projeto. Selecione um projeto existente ou clique em Criar projeto para criar um novo.
- Se você criar um projeto, insira um Nome do projeto descritivo, escolha um Local e clique em Criar . Leva alguns segundos para criar o projeto.
- No menu de navegação à esquerda, acesse Visão geral da cloud > Dashboard .
- Confirme se o projeto que você selecionou ou criou é exibido na parte superior da página. Se não estiver, abra o seletor de projetos e selecione-o.
Configure seu aplicativo do Google Cloud
-
Na barra de pesquisa superior, pesquise por Tela de consentimento OAuth e selecione-a.
-
Na página Tela de consentimento do OAuth , clique em Começar .
-
Na página Marca , insira o seguinte e deixe os campos restantes em branco:
- Nome do aplicativo : Um nome para o aplicativo.
- email de suporte ao usuário : seu endereço de email.
- Público : selecione Interno .
- Informações de contato do desenvolvedor : seu endereço de email.
-
Clique em Salvar e continuar .
-
Na página Acesso a dados , clique em Adicionar ou remover escopos .
-
Em Adicionar escopos manualmente , insira
https://www.googleapis.com/auth/admin.reports.audit.readonly. -
Clique em Adicionar à tabela e, em seguida, em Atualizar .
-
Clique em Salvar .
Ativar a API Admin SDK
- Na barra de pesquisa superior, procure por Admin SDK API e selecione-o.
- Na página Admin SDK API , clique em Enable (Habilitar ).
Criar credenciais OAuth
- Na barra de pesquisa superior, procure API e serviços e selecione-o.
- No menu de navegação à esquerda, clique em Credenciais .
- Clique em Criar credenciais .
- Selecione ID do cliente OAuth .
- Para Tipo de aplicativo , selecione Aplicativo web e insira um Nome para o cliente.
- Em URIs de redirecionamento autorizados , clique em Adicionar URI .
- Insira
https://<workspace-url>/login/oauth/http.html. Substitua<workspace-url>pelo host name do workspace Databricks. - Clique em Criar .
- Na caixa de diálogo, registre o ID do cliente e o Segredo do cliente . Use esses valores para criar a conexão do Unity Catalog.
Ao criar uma conexão através da UI do Lakewatch, insira a ID do Cliente e o Segredo do Cliente reunidos acima, em seguida clique em Fazer login no Google e conceda a permissão solicitada.
Para obter mais informações, consulte a configuração da origem do Google Workspace.
Próximos os passos
Após concluir a configuração acima, crie uma fonte de dados com o conector do Google Workspace na interface do usuário do Lakewatch. Consulte conectores de API para obter instruções.
Esquemas de conector e Lakewatch
O Lakewatch combina a atividade de auditoria de todos os aplicativos Google Workspace suportados em uma única tabela chamada activities.
Tabela de origem | Dados do Google Workspace | Analisador Lakewatch integrado |
|---|---|---|
| Atividade de auditoria combinada de todos os aplicativos do Google Workspace compatíveis |
|
O conector grava cada tabela de origem diretamente no destino configurado para o seu parser integrado. Por default, a tabela de destino recebe o nome <parser>_<datasource>, onde <datasource> é o nome da fonte de dados. Por exemplo, com o nome de fonte de dados default google_workspace, a tabela é google_workspace_reports_google_workspace. Você pode definir um destino diferente durante a criação da fonte de dados. Não existe uma tabela de staging raw separada nem o passo de parsing posterior.
Colunas gerenciadas pelo Lakewatch
O conector adiciona as seguintes colunas a cada linha de saída:
lw_id: Uma string não nula que o Lakewatch usa como parte da chave primária. O conector deriva um ID estável e ordenável por tempo detimee um hash estável da identidade da atividade de origem e dos campos do evento. A tabelaactivitiesusalw_ideapplicationcomo key primária composta.time: Um Timestamp não nulo analisado a partir deid.time. O conector usatimecomo o campo de cursor para ingestão incremental.
Para fontes de dados Lakewatch, o conector também adiciona:
lw_meta: A fonte de dados e a identidade da conexão, nome e versão do parser e hora da ingestão.lw_observables: Observáveis de segurança extraídos pelo conector.
Para obter mais informações, consulte Tabelas de saída do conector.
Esquema da tabela de saída do conector
O destino inclui as colunas de fonte e evento abaixo, juntamente com as colunas lw_meta e lw_observables descritas acima.
A tabela activities grava uma linha por evento. Cada linha contém o tipo, nome, status, IDs de recurso e parâmetros específicos da aplicação do evento, juntamente com detalhes de atividade compartilhados, como o ator, endereço IP e hora do evento. Parâmetros específicos da aplicação são armazenados como VARIANT.
Esquema
Coluna | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Para definições de campos, consulte o recurso de atividade da API Admin SDK Reports.
Observáveis de segurança
O conector extrai os seguintes campos em lw_observables.
Observáveis
campo | Observável |
|---|---|
|
|
|
|
|
|
|
|
O conector também verifica parameters por nome de parâmetro. A correspondência não diferencia maiúsculas de minúsculas.
Observáveis
Nomes de parâmetros | Observável |
|---|---|
|
|
|
|
|
|
|
|
|
|