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

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

  • Crie usuários no Zoho One.
  • Remova os usuários no Zoho One quando eles não precisarem mais de acesso.
  • Mantenha os atributos do usuário sincronizados entre o Microsoft Entra ID e o Zoho One.
  • Provisionar grupos e membros de grupos no Zoho One
  • Login único no Zoho One (recomendado).
  • Autenticação através do fluxo de concessão de autorização por código suportada.

Pré-requisitos

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

Etapa 1: Planear o seu processo de provisionamento

  1. Saiba mais sobre como funciona o serviço de provisionamento.
  2. Determine quem está dentro do âmbito de provisionamento.
  3. Determine que dados devem ser mapeados entre o Microsoft Entra ID e o Zoho One.

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

Entre em contato com o suporte do Zoho One para configurar o Zoho One para dar suporte ao provisionamento com o Microsoft Entra ID.

Adicione o Zoho One da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento no Zoho One. Se você configurou anteriormente o Zoho One para SSO, poderá 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 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 o Zoho One

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 TestApp 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 Zoho One no Microsoft Entra ID:

  1. Inicie sessão no portal do Azure pelo menos como Administrador de Aplicações Cloud.

  2. Aceda a Microsoft Entra ID>.

    Captura de ecrã do painel Aplicações empresariais.

  3. Na lista de aplicativos, selecione Zoho One.

    Captura de ecrã do link do Zoho One na lista de Aplicações.

  4. Selecione a guia Provisionamento .

    Captura de ecrã do separador Provisioning.

  5. Selecione + Nova configuração.

    Captura de ecrã do separador Provisioning automático.

    Importante

    Configurar credenciais de administrador de provisionamento baseadas em OAuth que exijam consentimento interativo no portal Azure. O centro de administração Microsoft Entra atualmente não suporta este fluxo de autorização. No portal do Azure, vá a Microsoft Entra ID>Aplicações empresariais, selecione a sua aplicação e depois selecione Provisionamento antes de autorizar o acesso.

  6. Na seção Credenciais de administrador, insira a sua URL de tenant do Zoho One, ponto de extremidade de autorização e ponto de extremidade de token. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Zoho One. Se a conexão falhar, verifique se sua conta do Zoho One tem permissões de administrador e tente novamente.

    Captura de ecrã do Token.

    Observação

    • A URL do Inquilino do Zoho One, o Endpoint de Autorização e o Endpoint de Token são específicos da região. Portanto, tenha cuidado ao entrar neles.
    • O endpoint de autorização deve sempre ter ?access_type=offline&prompt=consent&response_type=code&state=&client_id=1000.T3YYZHB8J5Y2BQ185U2FWOIKREUWAH&scope=ZohoOne.SCIM.ALL&redirect_uri=https%3A%2f%2fportal.azure.com%2fTokenAuthorize acrescentado ao introduzir o valor (por exemplo, se a região for US, então o endpoint de autorização a introduzir deve ser https://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent&response_type=code&state=&client_id=1000.T3YYZHB8J5Y2BQ185U2FWOIKREUWAH&scope=ZohoOne.SCIM.ALL&redirect_uri=https%3A%2f%2fportal.azure.com%2fTokenAuthorize)
  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.

    Captura de ecrã das propriedades de provisionamento.

  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 Zoho One na seção Mapeamento de Atributos . Os atributos selecionados como Propriedades correspondentes são usados para corresponder às contas de usuário no Zoho One para operações de atualização. Se você optar por alterar o atributo de destino correspondente, precisará garantir que a API do Zoho One 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 Exigido pelo Zoho One
    nome de utilizador Cordão ✓ ✓
    ativo booleano
    nome de exibição Cordão
    título Cordão
    emails[tipo = "trabalho"].valor Cordão
    língua preferida Cordão
    nome.dado Cordão
    nome.sobrenome Cordão
    nome formatado Cordão
    língua preferida Cordão
    endereços[tipo eq "trabalho"].formatado 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"].código postal Cordão
    endereços[tipo eq "trabalho"].país Cordão
    phoneNumbers[tipo igual a "telemóvel"].valor Cordão
    phoneNumbers[tipo eq "fax"].value Cordão
    númerosDeTelefone[tipo igual "trabalho"].valor Cordão
    Id externo Cordão
  12. Selecione Grupos.

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

    Atributo Tipo Suportado para filtragem Exigido pelo Zoho One
    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 Status de quarentena de provisionamento de aplicações.

Mais recursos