Logs de auditoria do Zendesk

O Lakewatch fornece um conector de API para ingerir Logs de auditoria de account do Zendesk Support. Esta página aborda os pré-requisitos, instruções de configuração, o esquema do conector e os indicadores do parser do Lakewatch.

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. Uma account do Zendesk Support com permissão para criar clientes OAuth. Consulte Usando autenticação OAuth com seu aplicativo.
4. 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 a tabela de origem no destino bruto da fonte de dados. O parser integrado grava uma tabela analisada separada nomeada após o parser, a menos que você defina um destino analisado ao configurar a fonte de dados.

Colunas gerenciadas por Lakewatch

O conector adiciona as seguintes colunas a cada linha de origem não processada:

• 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.

A tabela analisada leva lw_id adiante e adiciona lw_meta e lw_observables. lw_meta contém metadados de processamento padrão do Lakewatch. lw_observables contém valores extraídos de campos marcados como indicadores de segurança no parser. Consulte a referência do parser.

Esquema de tabela de conector não processado

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

Indicadores de parser

O parser zendesk_audit extrai os seguintes campos para lw_observables.

Indicadores

campo	Indicador
actor_name	username
ip_address	ip
url	url

campo	Indicador
actor_name	username
ip_address	ip
url	url