Partilhar via


Tutorial: Configurar o TimeClock 365 para provisionamento automático de usuários

Este tutorial descreve as etapas que você precisa executar no TimeClock 365 e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente usuários e grupos para o TimeClock 365 usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Capacidades suportadas

  • Criar usuários no TimeClock 365
  • Remova os usuários no TimeClock 365 quando eles não precisarem mais de acesso
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o TimeClock 365
  • Logon único no TimeClock 365 (recomendado).

Pré-requisitos

O cenário descrito neste tutorial pressupõe que você já tenha os seguintes pré-requisitos:

Etapa 1: Planejar a implantação do provisionamento

  1. Saiba como funciona o serviço de aprovisionamento.
  2. Determine quem vai estar no âmbito do aprovisionamento.
  3. Determine quais dados mapear entre o Microsoft Entra ID e o TimeClock 365.

Etapa 2: Configurar o TimeClock 365 para dar suporte ao provisionamento com o Microsoft Entra ID

  1. Faça login no console de administração do Timeclock365.

  2. Navegue até Configurações > Perfil > da empresa Geral.

    Gerar página de token

  3. Role para baixo até Sincronização de usuários do Azure. Copie e salve o token do Microsoft Entra. Esse valor será inserido no campo Token secreto * na guia Provisionamento do seu aplicativo TimeClock 365.

    Gerar Token

  4. https://live.timeclock365.com/scimserá inserido no campo URL do locatário na guia Provisionamento do seu aplicativo TimeClock 365.

Adicione o TimeClock 365 da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento ao TimeClock 365. Se você tiver configurado anteriormente o TimeClock 365 para SSO, poderá usar o mesmo aplicativo. No entanto, é recomendável criar uma aplicação separada ao testar a integração inicialmente. Saiba mais sobre como adicionar uma aplicação a partir da galeria aqui.

Etapa 4: Definir quem estará no escopo do provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem será provisionado com base na atribuição ao aplicativo e/ou com base nos atributos do usuário/grupo. Se optar por determinar quem vai ser aprovisionado na sua aplicação com base na atribuição, pode utilizar os seguintes passos para atribuir utilizadores e grupos à aplicação. Se escolher determinar quem vai ser aprovisionado com base apenas em atributos do utilizador ou grupo, pode utilizar um filtro de âmbito conforme descrito aqui.

  • Comece pequeno. Teste com um pequeno conjunto de utilizadores e grupos antes de implementar para todos. Quando o âmbito do aprovisionamento está definido para os utilizadores e os grupos atribuídos, pode controlar isto ao atribuir um ou dois utilizadores ou grupos à aplicação. Quando o âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.

  • Se precisar de funções adicionais, você pode atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuários para o TimeClock 365

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no TimeClock 365 com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.

Para configurar o provisionamento automático de usuários para o TimeClock 365 no Microsoft Entra ID:

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Aplicativos de identidade>>Aplicativos corporativos

    Painel Aplicações empresariais

  3. Na lista de aplicativos, selecione TimeClock 365.

    O link TimeClock 365 na lista Aplicativos

  4. Selecione o separador Aprovisionamento.

    Separador Aprovisionamento

  5. Defina o Modo de Aprovisionamento como Automático.

    Guia Provisionamento automático

  6. Na seção Credenciais de administrador, insira sua URL de locatário do TimeClock 365 e o token secreto. Clique em Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao TimeClock 365. Se a conexão falhar, verifique se sua conta TimeClock 365 tem permissões de administrador e tente novamente.

    Token

  7. No campo E-mail de Notificação, introduza o endereço de e-mail de uma pessoa ou um grupo que deve receber as notificações de erro de aprovisionamento e marque a caixa de verificação Enviar uma notificação de e-mail quando ocorre uma falha.

    E-mail de Notificação

  8. Selecione Guardar.

  9. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o TimeClock 365.

  10. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o TimeClock 365 na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no TimeClock 365 para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API do TimeClock 365 ofereça suporte à filtragem de usuários com base nesse atributo. Selecione o botão Salvar para confirmar as alterações.

    Atributo Type Suportado para filtragem
    nome de utilizador String
    active Boolean
    displayName String
    emails[type eq "work"].value String
    externalId String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager String
  11. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

  12. Para habilitar o serviço de provisionamento do Microsoft Entra para o TimeClock 365, altere o Status de provisionamento para Ativado na seção Configurações.

    Estado do Aprovisionamento Ativado

  13. Defina os usuários e/ou grupos que você gostaria de provisionar para o TimeClock 365 escolhendo os valores desejados em Escopo na seção Configurações .

    Âmbito de Aprovisionamento

  14. Quando estiver pronto para aprovisionar, clique em Guardar.

    Guardar Configuração de Aprovisionamento

Esta operação inicia o ciclo de sincronização inicial de todos os utilizadores e grupos definidos no Âmbito na secção Definições. O ciclo inicial leva mais tempo para ser executado do que os ciclos subsequentes, que ocorrem aproximadamente a cada 40 minutos, enquanto o serviço de provisionamento do Microsoft Entra estiver em execução.

Etapa 6: Monitorar sua implantação

Depois de configurar o aprovisionamento, utilize os seguintes recursos para monitorizar a sua implementação:

  • Utilize os registos de aprovisionamento para determinar quais os utilizadores que foram aprovisionados com ou sem êxito
  • Verifique a barra de progresso para ver o estado do ciclo de aprovisionamento e quão próximo está da conclusão
  • Se a configuração de aprovisionamento parecer estar num mau estado de funcionamento, a aplicação vai entrar em quarentena. Saiba mais sobre os estados de quarentena aqui.

Mais recursos

Próximos passos