Registro de atividades do Workday

info

Visualização

O Lakewatch está em 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 dados do log de atividades do Workday. Este artigo aborda pré-requisitos, instruções de configuração, esquemas de conectores e observáveis do analisador Lakewatch.

Pré-requisitos

O conector requer:

LakeFlow Pipelines Serverless ativados no seu workspace.
Unity Catalog, com privilégios para criar ou usar uma conexão Unity Catalog. Consulte Permissões de conexão.
A pré-visualização do Lakeflow Connect para Log de Atividades do Workday foi ativada em seu workspace por um administrador do workspace. Consulte Ativar a pré-visualização do conector.
Se a política de rede serverless do seu workspace usa acesso restrito, os domínios da API da origem devem estar na lista de Domínios permitidos da política. Veja Permitir os domínios da API da origem na sua política de rede.
Permissão no Workday para editar configurações do tenant, criar usuários do sistema de integração e grupos de segurança, atualizar políticas de segurança de domínio, fazer o registro de clientes de API e gerar tokens de refresh.

Limitações conhecidas

O SCD tipo 2 não é suportado, uma vez que os logs de atividade do Workday são somente anexação.
A retrospectiva histórica não pode exceder 30 dias. Consulte Escolher até onde retroceder na ingestão.

Configurar Workday para ingestão

Configure o Workday para habilitar o acesso ao log de autenticação e atividade do usuário.

Habilitar registro de atividade e OAuth

No Workday, pesquise e selecione Editar configuração de tenant - Sistema .
Certifique-se de que Habilitar registro de atividade do usuário esteja selecionado.
Pesquise e selecione Editar Configuração do Tenant - Segurança .
Certifique-se de que OAuth 2.0 Clients Enabled esteja selecionado.

Criar um usuário de sistema de integração

No Workday, pesquise e selecione Criar Usuário do Sistema de Integração .
Digite um nome de usuário. Por exemplo, ISU_Databricks.
Insira uma nova senha.
Defina Minutos de tempo limite da sessão como 0.
Selecione Não Permitir Sessões da IU .
Clique em OK .
Registre o nome de usuário. Você o usa ao gerar o token refresh.

Configurar permissões de segurança

No Workday, pesquise e selecione Criar grupo de segurança .
Para Tipo de grupo de segurança com locação , selecione Grupo de segurança do sistema de integração (Sem restrições) e insira um nome para o grupo. Por exemplo, ISSG_Databricks_Monitoring.
Clique em OK .
No próximo formulário, adicione o usuário do sistema de integração aos Usuários do Sistema de Integração .
Clique em OK e depois em Concluído .
Pesquise e selecione view Domínio .
Para Domínio , selecione Auditoria de sistema .
Clique no menu de três pontos ao lado do nome de domínio Auditoria de Sistema e selecione Domínio > Editar Permissões de Política de Segurança .
Adicione o security group à tabela Permissões de Relatório/Tarefa e conceda a ele acesso de view .
Adicione o grupo de segurança à tabela Permissões de Integração e conceda a ele acesso Obter .
Clique em OK e depois em Concluído .
Procure e selecione Ativar alterações pendentes na política de segurança .
Insira uma descrição para a alteração.
Clique em OK .

Registrar um cliente de API

No Workday, pesquise e selecione Registro clientes de API para integrações .
Insira um Nome do cliente . Por exemplo, Databricks User Activity Monitor.
Selecione Tokens de Refresh Sem Expiração para evitar interrupções causadas pela expiração de tokens de refresh.
Para Escopo (Áreas Funcionais) , selecione Sistema .
Clique em OK .
Registre o ID do cliente e o Segredo do cliente . Você usa esses valores ao criar a conexão do Unity Catalog.

Recuperar os valores do Workday para autenticação do Databricks

No Workday, pesquise e selecione view clientes da API .
Selecione a tab Clientes de API para Integrações .
Para o cliente da API que você criou, confirme se as seguintes configurações estão ativadas:
- Tipo de concessão do cliente : Concessão de código de autorização
- Tipo de Access Token : Portador
Localize o Endpoint da API REST do Workday . Registre os seguintes valores da URL:
- O domínio da instância, terminando em .com e excluindo o esquema e o caminho. Por exemplo, wd2-impl-services1.workday.com.
- O nome do tenant, que aparece após /v1/ na URL.
Clique no link do cliente da API. Na página view cliente de API , clique no menu de três pontos ao lado do nome do cliente.
Selecione API Client > gerenciar refresh tokens for Integrations .
Para account do Workday , selecione o usuário do sistema de integração e clique em OK .
Selecione Gerar novo refresh tokens e clique em OK .
Grave o token de refresh. Você o utiliza ao criar a conexão do Unity Catalog.

dica

Ao criar uma conexão através da UI do Lakewatch, você precisa da URL da instância , do nome do tenant , da ID do cliente , do segredo do cliente e do token de refresh reunidos acima.

Os passos seguintes

Após concluir a configuração acima, crie uma fonte de dados com o conector Workday na interface do 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 esquema de origem default:

Tabela de origem	Dados do Workday	Analisador Lakewatch integrado
`activity_logging`	Eventos de registro de atividade do usuário	`workday_activity`

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

Colunas gerenciadas pelo Lakewatch

O conector adiciona as seguintes colunas a cada linha de origem bruta:

lw_id: Uma strings não nula que o Lakewatch usa como a key principal. O conector deriva um ID estável e classificável por tempo do requestTime do Workday e do registro de origem completo. O ID oferece suporte à desduplicação entre sincronizações incrementais.
time: Um timestamp não nulo copiado de requestTime. O conector usa time como o campo de cursor para ingestão incremental.

Para fontes de dados do Lakewatch, a tabela bruta também contém essas colunas, e a tabela analisada transporta todos os três campos gerenciados pelo Lakewatch:

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

O analisador também atribui a coluna time analisada.

Para obter mais informações, consulte a referência do parser.

Esquema da tabela do conector bruto

O esquema a seguir combina os campos padrão do Lakeflow Connect com campos gerenciados pelo Lakewatch.

Esquema

Coluna	Tipo de dados
`lw_id`	`STRING`
`time`	`TIMESTAMP`
`systemAccount`	`STRING`
`activityAction`	`STRING`
`requestTime`	`TIMESTAMP`
`userAgent`	`STRING`
`taskId`	`STRING`
`deviceType`	`STRING`
`ipAddress`	`STRING`
`userActivityEntryCount`	`LONG`
`sessionId`	`STRING`
`target`	`STRUCT<id: STRING, descriptor: STRING, href: STRING>`
`taskDisplayName`	`STRING`
`lw_observables`	`STRUCT<account_ids: ARRAY<STRING>, actor_ids: ARRAY<STRING>, cves: ARRAY<STRING>, device_ids: ARRAY<STRING>, emails: ARRAY<STRING>, hashes: ARRAY<STRING>, hostnames: ARRAY<STRING>, ip_addresses: ARRAY<STRING>, mac_addresses: ARRAY<STRING>, mitre_attack_technique_ids: ARRAY<STRING>, request_trace_ids: ARRAY<STRING>, resource_ids: ARRAY<STRING>, resource_tags: ARRAY<STRING>, serial_numbers: ARRAY<STRING>, usernames: ARRAY<STRING>>`
`lw_meta`	`STRUCT<datasource_id: STRING, datasource_name: STRING, connection_name: STRING, parser_name: STRING, parser_version: STRING, ingestion_time: TIMESTAMP>`

Coluna	Tipo de dados
`lw_id`	`STRING`
`time`	`TIMESTAMP`
`systemAccount`	`STRING`
`activityAction`	`STRING`
`requestTime`	`TIMESTAMP`
`userAgent`	`STRING`
`taskId`	`STRING`
`deviceType`	`STRING`
`ipAddress`	`STRING`
`userActivityEntryCount`	`LONG`
`sessionId`	`STRING`
`target`	`STRUCT<id: STRING, descriptor: STRING, href: STRING>`
`taskDisplayName`	`STRING`
`lw_observables`	`STRUCT<account_ids: ARRAY<STRING>, actor_ids: ARRAY<STRING>, cves: ARRAY<STRING>, device_ids: ARRAY<STRING>, emails: ARRAY<STRING>, hashes: ARRAY<STRING>, hostnames: ARRAY<STRING>, ip_addresses: ARRAY<STRING>, mac_addresses: ARRAY<STRING>, mitre_attack_technique_ids: ARRAY<STRING>, request_trace_ids: ARRAY<STRING>, resource_ids: ARRAY<STRING>, resource_tags: ARRAY<STRING>, serial_numbers: ARRAY<STRING>, usernames: ARRAY<STRING>>`
`lw_meta`	`STRUCT<datasource_id: STRING, datasource_name: STRING, connection_name: STRING, parser_name: STRING, parser_version: STRING, ingestion_time: TIMESTAMP>`

Observáveis do analisador

O analisador workday_activity grava target como VARIANT e extrai os seguintes campos em lw_observables.

Observáveis

campo	Observável
`systemAccount`	`email`
`ipAddress`	`ip`
`target.href`	`url`

Pré-requisitos​

Limitações conhecidas​

Configurar Workday para ingestão​

Habilitar registro de atividade e OAuth​

Criar um usuário de sistema de integração​

Configurar permissões de segurança​

Registrar um cliente de API​

Recuperar os valores do Workday para autenticação do Databricks​

Os passos seguintes​

Esquemas do conector e do Lakewatch​

Colunas gerenciadas pelo Lakewatch​

Esquema da tabela do conector bruto​

Observáveis do analisador​