Configurar uma instância do Workday para replicação de dados

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para replicar dados de uma instância do Workday para um destino compatível, como o BigQuery ou o Cloud Storage, conecte o Workday como uma origem do Datastream. Para autenticar a conexão, crie um usuário do sistema de integração (ISU, na sigla em inglês), conceda permissões de grupo de segurança e registre um cliente de API para o OAuth 2.0.

Antes de começar

Antes de começar a configurar o Workday para uso com o Datastream, você precisa:

• Ter acesso a uma instância ativa do Workday.
• Saber navegar e mudar as configurações no Workday.
• Saber como criar usuários do sistema de integração e grupos de segurança no Workday.

Configurar uma instância do Workday para uso com o Datastream

Para estabelecer uma conexão entre sua instância do Workday e o Datastream, é necessário fornecer o nome do host e do locatário da instância, além das credenciais do cliente OAuth 2.0, como um ID do cliente, uma chave secreta do cliente e um token de atualização ao criar um perfil de conexão do Workday.

Identificar o nome do host e do locatário

É possível encontrar o nome do host e do locatário da sua instância do Workday de uma das seguintes maneiras:

• Usando o endereço de URL de login. O nome do host e o nome do locatário fazem parte do endereço de URL da instância que você usa para fazer login no Workday. Por exemplo, se o URL de login for https://wd5-impl.workday.com/google/d/home.html, a parte wd5-impl.workday.com será o nome do host, e o nome curto ou alias da instância que aparece imediatamente após o nome do host no URL será o nome do locatário (neste caso, google).

• Usando os detalhes do cliente de API registrado. Se você já registrou um cliente de API, é possível recuperar essas informações diretamente do endereço de URL do endpoint REST:

  1. No Workday, pesquise e selecione a tarefa View cliente de API.
  2. Em Detalhes do cliente, encontre o campo Endpoint da API REST do Workday, por exemplo: https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant.

  3. Encontre suas credenciais:

     • O nome do host é a parte do domínio do URL, por exemplo, wd2-impl-services1.workday.com.
     • O nome do locatário é o último segmento de caminho do URL após /v1/ (por exemplo, mytenant).

Para mais informações sobre como encontrar seus endpoints de API, consulte a documentação das APIs do Workday.

Configurar um usuário e um grupo de segurança

Para transmitir dados do Workday, é preciso configurar um usuário do sistema de integração (ISU, na sigla em inglês) dedicado, atribuí-lo a um grupo de segurança sem restrições e conceder ao grupo as permissões de domínio necessárias.

Criar o usuário do sistema de integração (ISU, na sigla em inglês)

1. Na barra de pesquisa do Workday, pesquise e selecione a tarefa Criar usuário do sistema de integração.

2. Configure a conta de ISU:

   1. Digite um nome de usuário, por exemplo, datastream_isu.
   2. Crie uma senha segura.
   3. Digite 0 (sem tempo limite) no campo Minutos de tempo limite da sessão.
   4. Desmarque a caixa de seleção Não permitir sessões de interface.
   Observação :inicialmente, é preciso permitir sessões UI para o ISU para que você possa autenticar e autorizar o cliente OAuth 2.0. Depois de concluir a configuração e gerar o token de atualização, recomendamos que você marque essa caixa de seleção por segurança.

3. Clique em OK e em Concluído.

Criar um grupo de segurança do sistema de integração

1. Pesquise e selecione a tarefa Create Security Group.

2. Configure as opções do grupo de segurança:

   1. No menu suspenso Tipo de grupo de segurança locatário, selecione Grupo de segurança do sistema de integração (sem restrições).
   2. No campo Nome, insira um nome para o grupo de segurança, por exemplo, datastream_sg.

3. Clique em OK.

4. Na página seguinte, no campo Usuários do sistema de integração, pesquise e selecione o ISU que você criou na etapa anterior.

5. Clique em OK.

Conceder permissões de política de segurança de domínio

Para garantir a cobertura total dos domínios de dados padrão, conceda ao grupo de segurança as permissões Get Only para os domínios necessários do Workday:

1. Na página de detalhes do grupo de segurança, clique no ícone de reticências (...) de Ações relacionadas ao lado do nome do grupo de segurança.
2. Acesse Grupo de segurança > Manter permissões de domínio para o grupo de segurança.

3. Na tabela Permissões da política de segurança de domínio, adicione os seguintes domínios:

   • Worker Data: Public Worker Reports
   • Workday Usage Metrics
   • Manage: Organization Integration
   • Worker Data: All Positions
   • Job Requisition Data
   • Manage: Evergreen Requisitions
   • Special OX Web Services
   • Prospects
   • Candidate Data: Job Application
   • Worker Data: Skills and Experience
   • Payroll Interface
   • Job Information
   • Staffing Organizations: Header
   • Staffing Organizations: Company
   • Staffing Organizations: Region
   • Staffing Organizations: Business Unit
   • Staffing Organizations: Custom Organization

4. Para cada domínio adicionado, marque a caixa de seleção na coluna de acesso Somente GET.

5. Clique em OK e em Concluído.

Isentar a ISU da validade da senha

Para evitar interrupções de stream devido a senhas expiradas, isente o ISU das regras padrão de expiração de senha do locatário:

1. Pesquise e selecione a tarefa Manter regras de senha.
2. No campo Usuários do sistema isentos de expiração de senha, adicione o ISU que você criou.
3. Clique em OK e em Concluído.

Ativar mudanças na política de segurança

Ative explicitamente as mudanças de permissão de domínio. Caso contrário, elas não vão entrar em vigor:

1. Pesquise e selecione a tarefa Ativar mudanças pendentes na política de segurança.
2. No campo Comentário, insira uma descrição para as mudanças, por exemplo, Grant permissions for Datastream Workday integration.
3. Clique em OK.
4. Na página de confirmação, marque a caixa de seleção Confirmar.
5. Clique em OK para ativar as mudanças.

Criar e configurar um cliente de API

Use as tarefas a seguir no Workday para gerar as credenciais necessárias para seu perfil de conexão do Datastream.

Registrar o cliente da API

1. Na barra de pesquisa do Workday, pesquise e selecione a tarefa Registrar cliente da API para integrações.

2. Configure o cliente da API:

   1. Insira um nome para a integração do Datastream.
   2. Em Tipo de permissão de acesso do cliente, selecione Concessão de código de autorização.
   3. Em Tipo de token de acesso, selecione Portador.
   4. Marque a caixa de seleção Aplicar validade personalizada do token de acesso e especifique um prazo de validade de sua escolha.

   5. Se quiser, marque a caixa de seleção Tokens de atualização que não expiram para evitar interrupções na conexão.

      Observação: se os requisitos da política de segurança da sua organização exigirem tokens de atualização que expiram, você precisará atualizar manualmente o token de atualização no perfil de conexão do Datastream antes ou imediatamente após a expiração.

   6. Em Escopos, recomendamos que você inclua as seguintes áreas funcionais para garantir a cobertura completa dos domínios de dados padrão:

      • Implementation
      • Jobs & Positions
      • Organizations and Roles
      • Payroll Interface
      • Pre-Hire Process
      • Recruiting
      • Staffing
      • System
      • Talent Pipeline

      Os escopos necessários dependem dos endpoints de onde você quer transmitir dados.

   7. Marque a caixa de seleção Incluir escopo de propriedade do Workday.

3. Clique em OK.

4. Copie e salve o ID do cliente e a chave secreta do cliente gerados. Você vai precisar dessas credenciais para criar o perfil de conexão do Datastream.

Gerenciar tokens de atualização para integrações

1. Depois de registrar o cliente, clique no ícone de reticências (...) ao lado do nome do cliente e selecione Gerenciar tokens de atualização para integrações.
2. Selecione o usuário do sistema de integração (ISU, na sigla em inglês) que você criou anteriormente.

3. Clique em Gerar novo token de atualização.

   Observação: recomendamos criar um token de atualização que não expire. Se os requisitos da política de segurança da sua organização exigirem que os tokens expirem, você precisará atualizar manualmente o token de atualização no perfil de conexão do Datastream sempre que ele expirar.
   Importante :copie e salve o token de atualização imediatamente, porque ele é exibido apenas uma vez.

Editar grupos de segurança do cliente de API

1. Para garantir que o cliente de API possa ser usado pela ISU, pesquise a tarefa Editar cliente de API.
2. Selecione o cliente registrado e acesse as configurações de segurança.
3. Adicione o grupo de segurança do sistema de integração associado ao ISU à lista de grupos de segurança permitidos para esse cliente.

Ver cliente de API

1. Para recuperar o ID do cliente e a chave secreta do cliente, pesquise a tarefa Ver cliente da API ou acesse a página de detalhes do cliente da API.
2. Em Detalhes do cliente, localize e copie o ID do cliente.
3. Clique em Gerenciar detalhes do consumidor para ver e copiar a chave secreta do cliente.

A seguir

• Saiba mais sobre a fonte do Workday.