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

Este tutorial 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 associações de grupos no Zoho One
• Logon único no Zoho One (recomendado).

Pré-requisitos

O cenário descrito neste tutorial 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.
• Uma conta de administrador com o Zoho One.

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 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.

Etapa 3: Adicionar o Zoho One da galeria de aplicativos do Microsoft Entra

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 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 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 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. 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

   

3. Na lista de aplicativos, selecione Zoho One.

   

4. Selecione o separador Aprovisionamento.

   

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

   

6. Na seção Credenciais de administrador, insira sua URL de locatário do Zoho One, Ponto de extremidade de autorização e Ponto de extremidade de token. Clique em 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.

   

   Nota

   • A URL do Locatário do Zoho One, o Ponto de Extremidade de Autorização e o Ponto de Extremidade de Token são específicos da região. Portanto, tenha cuidado ao entrar neles.
   • O Ponto de Extremidade de Autorização deve ser sempre anexado ao ?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 inserir o valor (Por exemplo, se a região for EUA, o Ponto de Extremidade de Autorização a ser inserido deverá 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. 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.

   

8. Selecione Guardar.

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

10. 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	Type	Suportado para filtragem	Exigido pelo Zoho One
    nome de utilizador	String	✓	✓
    active	Boolean
    displayName	String
    title	String
    emails[type eq "work"].value	String
    preferredLanguage	String
    name.givenName	String
    name.familyName	String
    nome.formatado	String
    preferredLanguage	String
    endereços[digite eq "work"].formatted	String
    endereços[digite eq "trabalho"].streetEndereço	String
    endereços[tipo eq "trabalho"].localidade	String
    endereços[digite eq "work"].region	String
    endereços[tipo eq "trabalho"].postalCode	String
    endereços[tipo eq "trabalho"].country	String
    phoneNumbers[type eq "mobile"].value	String
    pphoneNumbers[digite eq "fax"].value	String
    phoneNumbers[type eq "work"].value	String
    externalId	String

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

12. 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	Type	Suportado para filtragem	Exigido pelo Zoho One
    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 o Zoho One, altere o Status de provisionamento para Ativado na seção Configurações.

    

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

    

16. Quando estiver pronto para provisionar, clique em Salvar.

    

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 status do ciclo de provisionamento e quão perto ele está de ser concluído
• 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.

Mais recursos

• Gerir o aprovisionamento de contas de utilizador para Aplicações Empresariais
• O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?

Próximos passos

• Saiba como analisar os registos e obter relatórios sobre a atividade de aprovisionamento