Pular para o conteúdo principal

Logs de auditoria do Zendesk

O Lakewatch fornece um conector de API para ingerir logs de auditoria da account do Zendesk Support. Esta página aborda pré-requisitos, instruções de configuração, o esquema do conector e observáveis de segurança.

Pré-requisitos​

O conector requer:

  1. LakeFlow Pipelines Serverless habilitados em seu Workspace.
  2. Unity Catalog, com privilégios para criar ou usar uma conexão do Unity Catalog. Consulte Permissões de conexão.
  3. Se a política de rede serverless do seu workspace usar acesso restrito, os domínios da API da origem deverão estar na lista de Domínios permitidos da política. Consulte Permitir os domínios da API de origem na sua política de rede.
  4. Uma account do Zendesk Support com permissão para criar clientes OAuth. Consulte Usando autenticação OAuth com seu aplicativo.
  5. Acesso à API de logs de auditoria do Zendesk Support. Consulte Logs de auditoria.

Limitações conhecidas​

  • A dimensão de alteração lenta (SCD) tipo 2 não é suportada.
  • O conector oferece compatibilidade apenas com a autenticação OAuth user-to-machine (U2M). A autenticação OAuth machine-to-machine e a autenticação básica não são compatíveis.
  • A primeira sincronização da tabela audit_logs começa no momento em que a fonte de dados começa, que deve estar nos últimos 30 dias. Se você não definir um horário para começar, a ingestão começará quando você criar a fonte de dados. As sincronizações posteriores serão retomadas a partir do último valor time ingerido. Consulte Escolher até onde voltar para realizar a ingestão.

Configurar o Zendesk Support para ingestão​

Crie um cliente OAuth confidencial no Zendesk Support. O Identificador único é o ID do cliente que você insere no Databricks.

  1. Vá para o centro de administração em https://<subdomain>.zendesk.com/admin/home.

  2. Clique em Aplicativos e integrações > APIs > Clientes OAuth .

  3. Clique em Adicionar cliente OAuth no lado direito da lista de clientes OAuth.

  4. Preencha os campos obrigatórios para criar um cliente:

    • Nome do cliente: Digite o nome que aparece na lista de aplicativos com acesso à sua instância do Zendesk Support.

    • Identificador exclusivo: clique no campo para preenchê-lo automaticamente com o nome do cliente. Você pode alterá-lo se necessário. Este valor é o ID do cliente no Databricks.

    • Tipo de cliente: Selecione Confidencial .

    • URLs de redirecionamento: Insira https://<your_workspace_domain>/login/oauth/lakehousefederation.html.

      Substitua <your_workspace_domain> pelo nome da instância do seu workspace, por exemplo 1234567890123456.7.gcp.databricks.com.

  5. Clique em Salvar . Copie o novo valor de Segredo pré-preenchido que aparece, que é o segredo do cliente que você usa ao criar a conexão. O Zendesk mostra apenas uma vez.

  6. Clique em Salvar novamente.

  7. Observe o subdomínio do Zendesk (por exemplo, your-company de https://your-company.zendesk.com).

dica

Ao criar uma conexão através da UI do Lakewatch, insira o Subdomínio , o ID do Cliente (o identificador exclusivo) e o Segredo do cliente dos passos anteriores. Clique em Entrar com o suporte do Zendesk e autorize a aplicação.

Consulte Configurar o Zendesk Support para OAuth.

Os passos seguintes​

Após configurar o Zendesk Support, crie uma fonte de dados com o conector do Zendesk na interface de usuário do Lakewatch. Consulte Conectores de API para obter instruções.


Esquemas do conector e do Lakewatch​

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

Tabela de origem

Dados do Zendesk

Analisador Lakewatch integrado

audit_logs

Ações e alterações administrativas em nível de account

zendesk_audit

Tabela de origem

Dados do Zendesk

Analisador Lakewatch integrado

audit_logs

Ações e alterações administrativas em nível de account

zendesk_audit

O conector grava cada tabela de origem diretamente no destino configurado para o seu parser integrado. Por default, a tabela de destino chama-se <parser>_<datasource>, onde <datasource> é o nome da fonte de dados. Por exemplo, com o nome de fonte de dados default zendesk, a tabela é zendesk_audit_zendesk. Você pode definir um destino diferente durante a criação da fonte de dados. Não há uma tabela de staging bruta separada ou uma etapa de parsing posterior.

Colunas gerenciadas por Lakewatch​

O conector adiciona as seguintes colunas a cada linha de saída:

  • lw_id: uma strings não nula que o Lakewatch usa como key primária. O conector deriva um ID estável e classificável por tempo dos campos de origem created_at e id.
  • time: Um timestamp UTC não nulo convertido do valor de created_at da fonte. O conector usa time como o campo de cursor para ingestão incremental.

O conector não escreve o campo de origem id na tabela de destino.

Para fontes de dados do Lakewatch, o conector também adiciona lw_meta e lw_observables. lw_meta contém a fonte de dados e a identidade da conexão, nome e versão do parser e hora da ingestão. lw_observables contém observáveis de segurança extraídos pelo conector. 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.

O esquema a seguir inclui os campos de log de auditoria do Zendesk Support. Para definições de campo, consulte a referência do conector do Zendesk Support e a API de logs de auditoria do Zendesk.

Esquema

Coluna

Tipo de dados

lw_id

STRING

time

TIMESTAMP

action

STRING

action_label

STRING

actor_id

BIGINT

actor_name

STRING

change_description

STRING

created_at

STRING

ip_address

STRING

source_id

BIGINT

source_label

STRING

source_type

STRING

url

STRING

Coluna

Tipo de dados

lw_id

STRING

time

TIMESTAMP

action

STRING

action_label

STRING

actor_id

BIGINT

actor_name

STRING

change_description

STRING

created_at

STRING

ip_address

STRING

source_id

BIGINT

source_label

STRING

source_type

STRING

url

STRING

Observáveis de segurança​

O conector extrai os seguintes campos para lw_observables.

Observáveis

campo

Indicador

actor_name

username

ip_address

ip

url

url

campo

Indicador

actor_name

username

ip_address

ip

url

url