Configurar o UKG spoke

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 6 min. de leitura

    • Integre sua aplicação Kronos com sua instância ServiceNow. Registre uma aplicação OAuth em Kronos e autentique solicitações de ServiceNow.

    Antes de Iniciar

    • Solicite a assinatura do Integration Hub.
    • Ativar o UKG spoke
    • Kronos credenciais de usuário ou superusuário do gerente
    • Função necessária: administrador
    Nota:
    Certifique-se de que o registro da aplicação, as conexões e as credenciais estejam dentro do escopo da aplicação.
    Você pode optar por configurar o UKG spoke usando o modelo de conexão ou usando registros de conexão e credenciais de acordo com seus requisitos.

    Opção 1: configurar uma conexão para o spoke do UKG

    Adicione e configure uma conexão usando o modelo de conexão para autenticar ServiceNow solicitações no spoke do UKG.

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Se você estiver atualizando de uma versão anterior (versão 3.3.0) do spoke, primeiro será necessário remover o registro de conexão atual, o registro de credenciais e as credenciais do usuário do Kronos. Em seguida, você pode configurar a conexão usando o modelo.

    Procedimento

    1. Navegar até Todos > Automação de Processo > Flow Designer.
    2. Selecione a guia Conexões.
    3. Localize o alias de conexão do UKG e clique em Exibir detalhes.
      Nota:
      Não clique em Adicionar conexão.
      Modelo de conexão para spoke do UKG.
    4. Clique em Editar.
      Se você estiver configurando o spoke pela primeira vez, clique em Configurar.Configurar uma conexão para o spoke do UKG
    5. No formulário, preencha os campos.
      Campo Descrição
      Nome da Conexão Nome para identificar o registro da conexão com exclusividade. Por exemplo, insira Kronos Conn.
      URL de Conexão URL da instância Kronos.
      Chave da aplicação Chave da aplicação da instância Kronos.
      Nome da entidade OAuth Nome exclusivo para identificar o perfil da entidade OAuth do spoke do UKG. Por exemplo, selecione a entidade UKG OAuth.
      ID do cliente OAuth ID de cliente criado durante a configuração da aplicação em Kronos.
      Segredo do cliente OAuth Segredo do cliente criado durante a configuração da aplicação em Kronos.
      URL de Token Endpoint do token do servidor OAuth. Por exemplo, https://<Kronos-Instance> .com/api/authentication/access_token .
    6. Clique em Configurar e obter token do OAuth.
      Uma página modal é exibida para inserir suas Kronos credenciais.
    7. Insira seu Kronos nome de usuário e senha e clique em Obter token OAuth.

    Resultado

    Depois que o token OAuth for obtido com sucesso, você poderá começar a usar a conexão do spoke do UKG.

    Opção 2: usando registros de conexão e credenciais para a configuração do spoke do UKG

    Crie um registro de conexão e um registro de credencial para configurar o spoke do UKG.

    Antes de Iniciar

    Função necessária: administrador
    Nota:
    Se você já configurou uma conexão usando o modelo de conexão, poderá ignorar este procedimento.

    Registrar Kronos como um provedor OAuth

    Use as informações geradas durante a criação e a configuração da aplicação Kronos para registrar Kronos como um provedor OAuth e permitir que a instância solicite tokens OAuth 2.0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Abra o registro do spoke Kronos.
    3. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira Kronos OAuth profile.
      ID de cliente ID de cliente criado durante a configuração da aplicação em Kronos.
      Segredo do cliente Segredo do cliente criado durante a configuração da aplicação em Kronos.
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Credenciais de senha do responsável pelo recurso.
      Aplicação Escopo da aplicação que contém este registro. Selecione Kronos Spoke.
      Acessível de Escopo da aplicação a partir do qual este registro fica acessível.
      Ativo Opção para usar ativamente o registro da aplicação. Selecione a opção.
      URL de Token Endpoint do token do servidor OAuth. Por exemplo, https:// <Kronos-Instance> .com/api/authentication/access_token .
      URL de redirecionamento Endpoint de retorno de chamada do OAuth. Por exemplo, https://<ServiceNow-Instance> .com/oauth_redirect.do .
    4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    5. Na guia Escopos de Entidade OAuth, insira uma linha e forneça estes valores.
      Campo Valor
      Nome Kronos
      Escopo de OAuth sn uid do perfil do openid do determinado nome de e-mail
    6. Clique em Atualizar.
    7. Na guia Perfil de entidade OAuth, clique no perfil padrão, Kronos oAuth default_profile.
    8. Insira um registro na lista relacionada Escopo de entidade OAuth e selecione o escopo da entidade padrão para o spoke Kronos, por exemplo, Kronos.
    9. Clique em Atualizar.

    Criar registro de credencial para o spoke Kronos

    Autorize as ações de spoke Kronos criando registros de credenciais para a aplicação registrada em Kronos. O alias de conexão e credencial do spoke Kronos usa essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
    3. Selecione Credenciais OAuth 2.0.
    4. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Kronos Cred.
      Ativo Opção de usar ativamente o registro de credencial. Selecione a opção.
      Perfil de Entidade OAuth Perfil de entidade OAuth padrão do spoke Kronos. Por exemplo, selecione Kronos oAuth default_profile.
      Ordem Ordem na qual as credenciais são usadas. Por exemplo: insira 100.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Fornecer Kronos credenciais de usuário

    Crie um registro para fornecer detalhes e credenciais do usuário Kronos necessário. O Kronos spoke usa essas credenciais de usuário para executar ações em Kronos.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Certifique-se de fornecer credenciais de um usuário gerente ou superusuário Kronos. Com essas credenciais, as solicitações de folga do funcionário e do gerente podem ser gerenciadas.

    Procedimento

    1. Navegar até Todos > Kronos > Credenciais.
    2. Clique em Nova.
    3. No formulário, preencha estes valores.
      Tabela 1. Formulário de credenciais do Kronos
      Campo Descrições
      Nome Nome para identificar exclusivamente o registro.
      Chave da aplicação Chave da aplicação do usuário Kronos.
      Nome de usuário Nome de usuário para fazer login na conta do usuário em Kronos.
      Senha Senha da conta de usuário Kronos.
      Alias de credencial e conexão Registro de alias padrão associado ao spoke Kronos.
      O token de atualização expira Data e hora em que o token de atualização Kronos expira. O Kronos spoke gera um novo token de atualização periodicamente, antes que o token de atualização atual expire.
    4. Clique em Enviar.
    5. Para gerar o token Kronos, clique no link relacionado Obter token Kronos.

    Resultado

    O subfluxo Kronos - Obter token do Kronos é acionado. O subfluxo usa os detalhes fornecidos durante a configuração do spoke para recuperar um token de atualização válido de Kronos. O subfluxo atualiza o valor de Token de atualização expira.
    Nota:
    Para acessar mais detalhes sobre o token de atualização Kronos, navegue até OAuth de Sistema > Gerenciar tokens.. Aqui, um registro é criado para cada token de atualização.

    Criar registro de conexão para o spoke Kronos

    Crie registros de conexão para sua aplicação Kronos. Os aliases de conexão e credencial do spoke Kronos usam essas conexões para executar ações em Kronos.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o registro do spoke Kronos.
    3. Na guia Conexões, clique em Novo.
    4. No formulário, preencha estes valores.
      Tabela 2. Formulário de conexão HTTP
      Campo Valor necessário
      Nome Nome para identificar o registro da conexão com exclusividade. Por exemplo, insira Kronos Conn.
      Credenciais Registro de credencial criado para Kronos. Por exemplo, selecione Kronos Cred. Para obter mais informações, consulte Criar registro de credencial para o spoke Kronos.
      Alias de conexão Registro de alias associado a esta conexão.
      Construtor de URL
      Nota:
      Não marque a caixa de seleção.
      URL de Conexão URL da instância Kronos.
      Usar MID Server Este campo não é aplicável.
      Ativo Opção para usar a conexão ativamente. Selecione a opção.
      Domínio Domínio em que a ação ou atividade é executada.
    5. Na guia Atributos, preencha estes valores.
      Campo Descrição
      u_app_key Chave da aplicação do usuário Kronos.
      u_version Kronos versão da sua instância. Insira v1.
    6. Clique em Enviar.