Pular para o conteúdo principal
Última atualização em

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:

  1. Serverless Lakeflow Spark Declarative Pipelines ativado em seu workspace.
  2. Unity Catalog, com privilégios para criar ou usar uma conexão Unity Catalog. Consulte Permissões de conexão.
  3. 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​

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​

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

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

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

Configurar permissões de segurança​

  1. No Workday, pesquise e selecione Criar grupo de segurança .
  2. 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.
  3. Clique em OK .
  4. No próximo formulário, adicione o usuário do sistema de integração aos Usuários do Sistema de Integração .
  5. Clique em OK e depois em Concluído .
  6. Pesquise e selecione view Domínio .
  7. Para Domínio , selecione Auditoria de sistema .
  8. 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 .
  9. Adicione o security group à tabela Permissões de Relatório/Tarefa e conceda a ele acesso de view .
  10. Adicione o grupo de segurança à tabela Permissões de Integração e conceda a ele acesso Obter .
  11. Clique em OK e depois em Concluído .
  12. Procure e selecione Ativar alterações pendentes na política de segurança .
  13. Insira uma descrição para a alteração.
  14. Clique em OK .

Registrar um cliente de API​

  1. No Workday, pesquise e selecione Registro clientes de API para integrações .
  2. Insira um Nome do cliente . Por exemplo, Databricks User Activity Monitor.
  3. Selecione Tokens de Refresh Sem Expiração para evitar interrupções causadas pela expiração de tokens de refresh.
  4. Para Escopo (Áreas Funcionais) , selecione Sistema .
  5. Clique em OK .
  6. 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​

  1. No Workday, pesquise e selecione view clientes da API .

  2. Selecione a tab Clientes de API para Integrações .

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

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

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

  6. Selecione API Client > gerenciar refresh tokens for Integrations .

  7. Para account do Workday , selecione o usuário do sistema de integração e clique em OK .

  8. Selecione Gerar novo refresh tokens e clique em OK .

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

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

campo

Observável

systemAccount

email

ipAddress

ip

target.href

url

Nesta página