Logs de auditoria do Atlassian

info

Visualização

O Lakewatch está na Prévia privada. Para solicitar acesso, entre em contato com a equipe da sua conta da Databricks.

O Lakewatch fornece um conector de API para ingerir eventos de log de auditoria da organização do Atlassian. Este artigo aborda pré-requisitos, instruções de configuração, o esquema do conector e observáveis do analisador Lakewatch.

Pré-requisitos

O conector requer:

Lakeflow Spark Declarative Pipelines serverless ativado no seu workspace.
Unity Catalog, com privilégios para criar ou usar uma conexão Unity Catalog. Consulte Permissões de conexão.
Uma inscrição do Atlassian Guard Standard, Atlassian Guard Premium ou Cloud Enterprise. Sem uma dessas, a Atlassian não popula o log de auditoria da organização. Consulte a documentação das atividades do log de auditoria da Atlassian.
Permissão de administrador da organização para criar a key de API que autentica o conector. Veja a documentação da API REST de organizações da Atlassian.

Limitações conhecidas

O SCD tipo 2 não é suportado.
O conector oferece suporte à autenticação por key de API da organização Atlassian. A autenticação OAuth e a autenticação básica de nome de usuário e senha não são suportadas.
As chaves de API da Atlassian expiram após no máximo um ano. Crie uma nova key e atualize a conexão do Unity Catalog antes que a key atual expire.
A pesquisa retrospectiva histórica não pode exceder 180 dias. Consulte Escolher até onde retroceder na ingestão.

Configurar Atlassian para ingestão

A Atlassian autentica solicitações de API de administrador com uma key de API que o conector envia como um tokens de portador. Para obter mais informações, consulte o guia da Atlassian para gerenciar uma organização com as APIs de administrador.

Entre na Administração da Atlassian como um usuário com permissão de administrador da organização. Se você gerenciar mais de uma organização, selecione a sua.
Selecione Configurações da organização e, em seguida, Chaves de API .
Selecione keys de API com escopos e, em seguida, selecione Criar key de API .
Insira um Nome para a key e selecione uma data de validade. As chaves não podem durar mais de um ano.
Selecione o escopo read:events:admin (exibido como Leitura para Eventos ). Este é o único escopo exigido pelo conector. Consulte a documentação de eventos da API REST de organizações da Atlassian.
Revise a key e selecione Criar .
Copie o ID da organização e a key da API . A Atlassian não mostrará esses valores novamente. Use-os para criar uma conexão do Unity Catalog no Databricks.

nota

As chaves de API da Atlassian expiram após no máximo um ano e não são renovadas automaticamente. Antes que a key expire, crie uma nova key de API da organização e atualize a Key de API na conexão existente do Unity Catalog. Não crie uma nova conexão.

dica

Ao criar uma conexão através da interface do usuário do Lakewatch, insira o ID da organização e a API Key reunidos acima.

Para obter mais informações, consulte Configurar autenticação no Atlassian.

Os passos seguintes

Após concluir a configuração acima, crie uma fonte de dados com o conector Atlassian na interface do usuário do Lakewatch. Veja Conectores de API para instruções.

Esquemas de conector e Lakewatch

O conector ingere a seguinte tabela de origem do esquema de origem default:

Tabela de origem	Dados da Atlassian	Analisador integrada do Lakewatch
`audit_logs`	Eventos de alteração de usuário, segurança e configuração da organização	`atlassian_audit`

O conector grava a tabela de origem no destino bruto da fonte de dados. O analisador integrado grava uma tabela analisada separada com o nome do analisador, a menos que você defina um destino analisado ao configurar a fonte de dados.

Colunas gerenciadas pelo Lakewatch

O conector usa o campo de origem id como key primária não nula e o campo de origem time como cursor para ingestão incremental. Diferente de conectores que sintetizam um ID Lakewatch, esse conector não adiciona uma coluna lw_id. O analisador atribui a coluna time analisada.

Para pipelines criados pelo Lakewatch, o conector também adiciona essas colunas à tabela bruta e a tabela analisada as transporta para a frente:

lw_meta: Metadados padrão de processamento do Lakewatch.
lw_observables: Valores extraídos de campos marcados como observáveis de segurança no analisador.

Para mais informações, consulte Referência de parser.

Esquema de tabela de conector bruto

O esquema a seguir inclui os campos de evento de auditoria da organização Atlassian. Para definições de campos, consulte a referência do conector de logs de auditoria da Atlassian.

Esquema

Coluna	Tipo de dados
`id`	`STRING`
`type`	`STRING`
`time`	`TIMESTAMP`
`action`	`STRING`
`actor`	`STRUCT<id: STRING, name: STRING, email: STRING, picture: STRING, links: STRUCT<self: STRING, alt: STRING>>`
`context`	`VARIANT`
`container`	`VARIANT`
`location`	`STRUCT<ip: STRING, geo: STRING, countryName: STRING, regionName: STRING, city: STRING>`
`message`	`STRUCT<content: STRING, format: STRING>`
`links`	`STRUCT<self: STRING, alt: STRING>`
`relations`	`VARIANT`

Coluna	Tipo de dados
`id`	`STRING`
`type`	`STRING`
`time`	`TIMESTAMP`
`action`	`STRING`
`actor`	`STRUCT<id: STRING, name: STRING, email: STRING, picture: STRING, links: STRUCT<self: STRING, alt: STRING>>`
`context`	`VARIANT`
`container`	`VARIANT`
`location`	`STRUCT<ip: STRING, geo: STRING, countryName: STRING, regionName: STRING, city: STRING>`
`message`	`STRUCT<content: STRING, format: STRING>`
`links`	`STRUCT<self: STRING, alt: STRING>`
`relations`	`VARIANT`

Observáveis do analisador

O analisador atlassian_audit grava objetos aninhados como VARIANT e extrai os seguintes campos em lw_observables.

Observáveis

campo	Observável
`actor.id`	`actor_id`
`actor.name`	`username`
`actor.email`	`email`
`actor.links.self`	`url`
`actor.links.alt`	`url`
`location.ip`	`ip`
`links.self`	`url`
`links.alt`	`url`

Pré-requisitos​

Limitações conhecidas​

Configurar Atlassian para ingestão​

Os passos seguintes​

Esquemas de conector e Lakewatch​

Colunas gerenciadas pelo Lakewatch​

Esquema de tabela de conector bruto​

Observáveis do analisador​