Configurar o Zip para provisionamento automático de usuários com o Microsoft Entra ID

Este artigo descreve as etapas que você precisa executar no Zip 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 Zip 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

Pré-requisitos

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

• Um locatário do Microsoft Entra
• Uma das seguintes funções: Administrador de Aplicativos, Administrador de Aplicativos na Nuvem ou Proprietário de Aplicativos.
• Um inquilino Zip.
• Uma conta de usuário no Zip com permissões de administrador.

Etapa 1: Planear a implementação de provisionamento

1. Saiba mais sobre como funciona o serviço de provisionamento.
2. Determine quem está no escopo do provisionamento.
3. Determine quais dados mapear entre Microsoft Entra ID e o Zip.

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

Para configurar o Zip para suportar o provisionamento com o Microsoft Entra ID - entre em contato com a equipe de suporte do Zip em support@ziphq.com. Eles fornecerão a URL do locatário e o token secreto necessários para configurar o provisionamento automático do usuário para o Zip, conforme mencionado na Etapa 5.

Etapa 3: Adicionar Zip da galeria de aplicativos do Microsoft Entra

Adicione Zip da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Zip. Se você já configurou o Zip para SSO, você pode usar o mesmo aplicativo. No entanto, recomendamos que você crie um aplicativo separado ao testar a integração inicialmente. Saiba mais sobre como adicionar um aplicativo da galeria aqui.

Etapa 4: Definir quem está no escopo do provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem é provisionado com base na atribuição ao aplicativo ou com base nos atributos do usuário ou grupo. Se você optar por definir o escopo de quem é provisionado para seu aplicativo com base na atribuição, poderá usar as etapas para atribuir usuários e grupos ao aplicativo. Se você optar por definir o escopo de quem é provisionado com base apenas nos atributos do usuário ou grupo, poderá usar um filtro de escopo.

• Comece pequeno. Teste com um pequeno conjunto de usuários e grupos antes de distribuir 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 escopo é definido para todos os usuários e grupos, você pode especificar um filtro de escopo baseado em atributo.

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

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

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

Para configurar o provisionamento automático de usuários para Zip 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é Entra ID>aplicações empresariais

   

3. Na lista de aplicativos, selecione Zip.

   

4. Selecione a guia Provisionamento .

   

5. Selecione + Nova configuração.

   

6. No campo URL do Inquilino , introduza o URL do seu Zip tenant e o token secreto. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Zip. Se a ligação falhar, certifique-se de que a sua conta Zip tem os privilégios de administrador necessários e tente novamente.

   

7. Selecione Criar para criar a sua configuração.

8. Selecione Propriedades na página de Visão Geral.

9. Selecione o ícone Editar para editar as propriedades. Ative os emails de notificação e forneça um email para receber notificações de quarentena. Ativar a prevenção de eliminações acidentais. Selecione Aplicar para salvar as alterações.

   

10. Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.

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

    Atributo	Tipo	Suportado para filtragem
    nome de utilizador	Cordão	✓
    ativo	booleano
    emails[tipo = "trabalho"].valor	Cordão
    língua preferida	Cordão
    nome.dado	Cordão
    nome.sobrenome	Cordão
    endereços[tipo eq "work"].formatted	Cordão
    endereços[tipo eq "trabalho"].streetAddress	Cordão
    endereços[tipo igual a "trabalho"].localidade	Cordão
    endereços[tipo eq "trabalho"].região	Cordão
    endereços[tipo eq "trabalho"].postalCode	Cordão
    endereços[tipo eq "trabalho"].país	Cordão
    númerosDeTelefone[tipo eq "trabalho"].valor	Cordão
    Id externo	Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departamento	Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:númeroDeFuncionário	Cordão
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utilizador:gestor	Referência

12. Selecione Grupos.

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

    Atributo	Tipo	Suportado para filtragem
    nome de exibição	Cordão	✓
    Membros	Referência
    Id externo	Cordão

14. Para configurar os filtros de escopo, consulte as instruções fornecidas no artigo sobre filtros de alcance.

15. Use provisionamento sob demanda para validar a sincronização com um pequeno número de utilizadores antes de uma implementação mais ampla na sua organização.

16. Quando estiver pronto para provisionar, selecione Iniciar Provisão na página de Visão Geral .

Etapa 6: Monitorar sua implantação

Depois de configurar o provisionamento, use os seguintes recursos para monitorar sua implantação:

1. Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
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 no artigo estado de quarentena do aprovisionamento de aplicações.

Registo de alterações

• 14/02/2022 - Adicionado mapeamento de atributos de extensão empresarial.

Mais recursos

• Gerenciando o provisionamento de contas de usuário para aplicativos corporativos
• O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?

Conteúdo relacionado

• Saiba como revisar logs e obter relatórios sobre a atividade de provisionamento