Partilhar via

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

  • Artigo

O objetivo deste tutorial é demonstrar as etapas a serem executadas no Zenya e no Microsoft Entra ID para configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente usuários e/ou grupos para o Zenya. 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. Antes de tentar usar este tutorial, certifique-se de que conhece e atende a todos os requisitos. Em caso de dúvidas, contacte a Infoland.

Capacidades suportadas

  • Criar utilizadores no Zenya
  • Remover/desativar usuários no Zenya quando eles não precisam mais de acesso
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Zenya
  • Provisionar grupos e associações de grupos no Zenya
  • Logon único para Zenya (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 Zenya.

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

  1. Faça login no Zenya Admin Console. Navegue até Ir para > Gerenciamento de Aplicativos.

    Captura de ecrã a mostrar a Consola do administrador Zenya.

  2. Selecione Gerenciamento de usuários externos.

    Captura de ecrã a mostrar a página Utilizadores e Grupos Zenya com a ligação Gestão de utilizadores externos realçada.

  3. Para adicionar um novo provedor, selecione o ícone de adição . Na nova caixa de diálogo Adicionar provedor , forneça um Título. Você pode optar por adicionar restrição de acesso baseada em IP. Selecione OK.

    Captura de ecrã a mostrar o botão Zenya adicionar novo.

    Captura de ecrã a mostrar a página Zenya add provider.

  4. Selecione o botão Token permanente. Copie o token permanente e salve-o. Você não poderá visualizá-lo mais tarde. Esse valor é inserido no campo Token secreto na guia Provisionamento do seu aplicativo Zenya.

    Captura de tela mostrando a página de provisionamento do Zenya User para criar um Token.

Adicione o Zenya da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Zenya. Se você já configurou o Zenya para SSO, você pode usar o mesmo aplicativo. No entanto, é recomendável que você crie um aplicativo separado 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 escopo para provisionamento é definido como usuários e grupos atribuídos, mantenha o controle atribuindo um ou dois usuários ou grupos ao aplicativo. Quando o âmbito está definido para todos os utilizadores e grupos, pode especificar um filtro de âmbito baseado em atributos.

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

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

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 Zenya com base em atribuições de usuário e/ou grupo no Microsoft Entra ID.

Para mais informações (em neerlandês) leia também: Implementatie SCIM koppeling

Para configurar o provisionamento automático de usuários para Zenya 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

    Captura de ecrã a mostrar a folha Aplicações empresariais.

  3. Na lista de aplicações, selecione Zenya.

    Captura de tela para selecionar o aplicativo na lista Aplicativos.

  4. Selecione o separador Aprovisionamento.

    Captura de tela das opções Gerenciar com a opção Provisionamento destacada.

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

    Captura de tela da lista suspensa Modo de provisionamento com a opção Automático destacada.

  6. Na seção Credenciais de administrador, insira a URL base do SCIM 2.0 e os valores de Token permanente recuperados anteriormente na URL do locatário e adicione /scim/ a ela. Adicione também o Token Secreto. Você pode gerar um token secreto no Zenya usando o botão de token permanente. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Zenya. Se a ligação falhar, certifique-se de que a sua conta Zenya tem permissões de administrador e tente novamente.

    Captura de ecrã a mostrar a página Testar ligação e os campos para URL e Token do Inquilino.

  7. No campo Email de notificação, digite o endereço de e-mail de uma pessoa ou grupo que deve receber as notificações de erro de provisionamento e marque a caixa de seleção - Enviar uma notificação por e-mail quando ocorrer uma falha.

    Captura de ecrã a mostrar o campo para introduzir um endereço de e-mail para notificação.

  8. Selecione Guardar.

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

  10. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o Zenya na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Zenya para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo Type
    ativo Boolean
    displayName String
    emails[type eq "work"].value String
    preferredLanguage String
    nome de utilizador String
    phoneNumbers[type eq "work"].value String
    externalId String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
    title String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager String

  11. Na seção Mapeamentos, selecione Sincronizar grupos do Microsoft Entra com o Zenya.

  12. Analise os atributos de grupo sincronizados do Microsoft Entra ID para o Zenya na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no Zenya para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo Type
    displayName String
    membros Referência
    externalID String

  13. Para configurar filtros de âmbito, veja as instruções seguintes disponibilizadas no Tutorial de filtro de âmbito.

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

    Captura de tela mostrando o status de provisionamento ativado.

  15. Defina os usuários e/ou grupos que você gostaria de provisionar para a Zenya escolhendo os valores desejados em Escopo na seção Configurações. Você precisa de uma licença P1 ou P2 para permitir o provisionamento de usuários e grupos atribuídos.

    Captura de tela mostrando onde selecionar o escopo de provisionamento.

  16. Quando estiver pronto para provisionar, selecione Salvar.

    Captura de tela mostrando o botão Salvar para salvar a configuração de provisionamento.

Esta operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos em Escopo na seção Configurações. A sincronização inicial leva mais tempo para ser executada do que as sincronizações 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:

  1. Utilize os registos de aprovisionamento para determinar quais os utilizadores que foram aprovisionados com ou sem êxito
  2. Verifique a barra de progresso para ver o estado do ciclo de aprovisionamento e quão próximo está da conclusão
  3. Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre os estados de quarentena aqui.

Registo de alterações

  • 17/06/2020 - Removido o suporte para o atributo de extensão empresarial urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.
  • 10/11/2023 - Adicionado suporte para título de atributo principal e adicionado suporte para atributos de extensão empresarial urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department e urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.

Mais recursos

Próximos passos