--- title: "Solução de Problemas de Sincronização e Provisionamento SCIM" slug: "scim-sync-and-provisioning-troubleshooting" updated: 2026-07-30T01:55:15Z published: 2026-07-30T01:55:15Z canonical: "knowledge.catonetworks.com/scim-sync-and-provisioning-troubleshooting" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Solução de Problemas de Sincronização e Provisionamento SCIM ## Visão Geral A sincronização SCIM (Sistema de Gerenciamento de Identidade Cross-domain) e o provisionamento de usuários são essenciais para automatizar o gerenciamento de identidade e garantir o acesso seguro e simplificado a aplicativos e recursos. No entanto, desafios podem ocorrer que interrompem essa automação, potencialmente levando a problemas de acesso ou riscos de conformidade. Este playbook foi projetado para abordar problemas comuns de sincronização e provisionamento SCIM na Cato e oferecer soluções eficazes para resolvê-los. ## Sintomas Falhas no provisionamento SCIM podem se manifestar de várias maneiras. Um administrador pode observar os seguintes sintomas: - Mensagem de erro ao habilitar o SCIM - Os usuários não são provisionados para o CMA - Falha na Conexão de Teste do IdP para o CMA - Usuários Provisionados falham em se conectar aos clientes SDP - Usuários Duplicados no CMA ## Causas possíveis Liste as possíveis causas que eles tentarão identificar durante a solução de problemas - Configuração Incorreta - Uso de Credenciais de Administrador Erradas - Licenciamento - Usuário Duplicado provisionado via IdP ## Solução de problemas do problema Antes de mergulhar nas etapas de solução de problemas, o diagrama abaixo oferece uma visão geral de alto nível de como o provisionamento SCIM funciona. Ao contrário do LDAP, que depende de uma abordagem baseada em pull, o SCIM usa um mecanismo push para entregar atualizações de usuários diretamente para o Cato Management Application (CMA). ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26455622955165.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=%2BBSO%2BK085YvynC3LQkKk6TGJygSIjA0T1Q8YWY9XQFE%3D) A Cato suporta provisionamento SCIM para usuários através do Azure, Okta e One Login. Para mais informações sobre como configurar o provisionamento SCIM para cada provedor de identidade (IdP), consulte [Provisionando Usuários com SCIM](/v1/docs/scim-user-provisioning). Este playbook foca especificamente no provisionamento SCIM com Azure (Entra ID), mas os conceitos principais e técnicas de resolução de problemas são aplicáveis a outros IdPs também. ### Erro ao Habilitar SCIM Ao habilitar o SCIM no CMA, o seguinte erro é observado: "Não é possível habilitar o provisionamento SCIM. Por favor, entre em contato com o Suporte e mencione a Configuração do ID da Conta - Email". ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26606350511773.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=ciFjJ2gImPRTyOeSugu9dNTSomusbXvyGCoUiF8o%2BCk%3D) Ao encontrar esse erro, por favor, entre em contato com [Suporte](/v1/docs/submitting-a-support-ticket) para modificar o tipo de ID de Usuário em sua conta. ### Usuários Não Estão Sendo Provisionados para o CMA Esta seção mostrará algumas das razões comuns pelas quais os usuários não estão sendo provisionados para o CMA. #### Validar Credenciais de Admin - Vá para Aplicação SCIM > Provisionamento > Atualizar Credenciais. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26511743159325.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=%2Bxlb%2BnDpmgC4MMJRLRI5MYUFJ9kXFm36as8cGySYf9Y%3D) - Expanda Credenciais de Admin e clique em Testar Conexão ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26511683786909.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=6A1%2FeTWaTYmk9xgGRRFguDtXGrLty5dgQ%2FCoa4vTUbU%3D) - Para uma integração e provisionamento bem-sucedidos com o CMA, você deve ver o seguinte resultado. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26511683788189.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=amq5xCc52JL%2FU6K4I3dbcOP0bZ%2BGNyZQcYTHC4YSXWM%3D) - Se o Teste de Conexão falhar, consulte [Resolvendo Credenciais de Admin](/v1/docs/scim-sync-and-provisioning-troubleshooting#resolving-admin-credentials) para entender como resolver isso. #### Atributos Obrigatórios - Certos atributos são exigidos e obrigatórios para o Provisionamento SCIM com Microsoft Entra ID. Se algum desses atributos exigidos estiver faltando, o provisionamento de usuários pode falhar, ou o usuário provisionado pode não conseguir se conectar. - A captura de tela abaixo mostra os campos obrigatórios necessários para o provisionamento funcionar. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26513224640157.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=tgEX63ZGno3beX4ioTp8LPqQaNFL01WWOAFyAjG4Fu4%3D) - Se o campo de email estiver ausente, o usuário ainda será provisionado para o CMA, mas não poderá se conectar ao cliente SDP. - Consulte a seção [resolvendo Atributo Obrigatório](/v1/docs/scim-sync-and-provisioning-troubleshooting#resolving-mandatory-attribute) para validar se isso está causando o problema e como resolvê-lo. #### Usuários/Grupos Não Atribuídos à Aplicação Empresarial no Portal do Azure Usuários e grupos precisam ser adicionados ao Aplicativo de Provisionamento Cato no portal do Azure antes de serem sincronizados no CMA. Esta seção fornece instruções passo a passo sobre como validar isto. - Vá para Aplicações Empresariais > Aplicativo de Provisionamento Cato > Usuário & Grupos e verifique se o usuário ou grupo está listado. - No exemplo abaixo, podemos ver que 1 grupo e 1 usuário são atribuídos à aplicação "Cato Networks Provisioning—APJ T1 Lab". ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26513224640669.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=OvspgqMJ7q0L30rYys0o9EJbO28mgzpSBwhaCypGyIg%3D) - Se o usuário ou grupos não estiverem listados em seu Aplicativo de Provisionamento no Azure, consulte [Atribuindo Usuários/Grupos ao Aplicativo de Provisionamento](/v1/docs/scim-sync-and-provisioning-troubleshooting#assigning-usersgroups-to-provisioning-application). #### Filtro de Escopo em Usuários/Grupos - Verifique se os filtros de escopo estão configurados para usuários ou grupos na configuração de provisionamento. - Navegue até Aplicações Empresariais > Aplicativo de Provisionamento Cato > Provisionamento > Mapeamentos, então selecione o mapeamento de Usuário ou Grupo. - Revise os filtros de Escopo do Objeto Fonte para ver se eles podem estar excluindo o usuário ou grupo em questão. - Se o provisionamento falhar devido a um filtro de escopo, o usuário/grupo será pulado, e o Azure mostrará uma razão para a falha. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26514553909149.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=yrYXxdAQuyCMXlzpNUqr%2FxtQeemxpePWspdsDHyiE60%3D) - Para resolver isso, consulte [Resolvendo Filtros de Escopo em Usuários/Grupos](/v1/docs/scim-sync-and-provisioning-troubleshooting#resolving-scoping-filters-in-usersgroups). ### Usuários Provisionados Falhando ao Conectar-se ao Cliente SDP - Após serem provisionados no CMA pelo SCIM, os usuários encontram o seguinte erro ao tentar se conectar pelo cliente SDP, especificamente depois de inserir seu e-mail e subdomínio. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26623066681885.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=mpdiHFYRf1WZi6IcgS%2BCbhBeh5tBbbCPbV1sU5wxSok%3D) - Uma possível causa dessa falha é a questão de licenciamento - Consulte a seção [Resolvendo a questão de licenciamento](/v1/docs/scim-sync-and-provisioning-troubleshooting#resolving-the-licensing-issue) para saber como validar se essa questão está relacionada ao licenciamento e como resolvê-la. ### Usuários Duplicados no CMA Usuários duplicados com o mesmo endereço de e-mail podem aparecer no CMA. Tipicamente, um usuário é desativado, enquanto o outro tem a licença SDP atribuída. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26700725460893.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=IQQKSqiCOE0g97BWNbK83kW%2Fbd0bic7AnsYLpwdJZk8%3D) Consulte a seção [Resolvendo Usuários Duplicados no CMA](/v1/docs/scim-sync-and-provisioning-troubleshooting#resolving-duplicate-users-in-cma) para entender a possível razão de isso ter ocorrido e como resolvê-lo. ## Resolvendo Questões Descobertas ### Resolvendo Credenciais de Admin - Faça login em seu CMA e navegue até Acesso > Serviços de Diretório > SCIM para validar se a URL Base é a mesma que a URL do Locatário configurada no Azure. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26511683788445.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=KW%2B0viEEKyTmqeLWmUfb697l6rN5HZSfrZ1hEF8ULWM%3D) - Se a URL base é a mesma, tente gerar um novo token. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26511743168541.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=7uHvPKTyxlQgKATbl9uhuxAuDeiAlWps0XrsuQVnUJM%3D) - Copie o novo token *antes* de salvar a configuração no CMA. Depois disso, insira o novo token no Azure e clique novamente em **Testar Conexão**. ### Resolvendo Atributo Obrigatório - O atributo de email é obrigatório. Se este campo estiver ausente nas informações do usuário dentro do Provedor de Identidade (IdP), o usuário ainda será provisionado para o CMA, mas seu perfil ficará sem um endereço de e-mail. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26625524742941.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=ECvkiKhcL9lbDe%2B%2BKDKQLsuXJ1jBwn94wrCZ2nvJbxs%3D) - Quando o campo de e-mail está ausente do perfil do usuário, o sistema não pode atribuir uma licença SDP, impedindo o usuário de se conectar com sucesso via cliente SDP. ### Atribuindo Usuários/Grupos ao Aplicativo de Provisionamento - Para atribuir usuários ou grupos ao seu Aplicativo de Provisionamento, clique em Adicionar usuário/grupo, e depois selecione "Usuários e grupos". - Em seguida, o painel à direita aparecerá para que você selecione os usuários/grupos respectivos a serem adicionados. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26513224642205.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=Tv2z0KjaClEjWBTqk8F4Gc4Xx3bGtx2Pz6SRSbXohDA%3D) - Opcionalmente, após adicionar os Usuários e Grupos à Aplicação de Provisionamento, em vez de aguardar o ciclo de provisionamento automatizado regular, você pode provisionar manualmente esses usuários/grupos na CMA através de "Provisionar Sob Demanda." ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26886686855069.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=SyqeP5XGFgA%2B577tfwJpwSZkl%2B%2BkzzfaLXqhz5RDRec%3D)**NOTA**: O provisionamento de grupos aninhados não é suportado ### Resolvendo Filtros de Escopo em Usuários/Grupos - Se um filtro de escopo estiver excluindo o usuário ou grupo inadvertidamente: - Ajuste os critérios do filtro de escopo para garantir que ele inclua o usuário/grupo. - Confirme se a lógica dos filtros (E/OU) corresponde ao comportamento pretendido. - Para mais detalhes, consulte o documento da Microsoft - [Escopando usuários ou grupos a serem provisionados com filtros de escopo](https://learn.microsoft.com/en-us/azure/active-directory/app-provisioning/define-conditional-rules-for-provisioning-user-accounts?pivots=app-provisioning). - Após fazer ajustes, execute novamente o provisionamento sob demanda para verificar se o usuário/grupo agora está incluído. ### Resolvendo a Questão de Licenciamento - Navegue até Acesso > Usuários, e clique em Diretório de Usuários. Valide se o usuário recebeu uma licença SDP. A imagem abaixo mostra que o Usuário Scim não recebeu nenhuma licença SDP. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26624060542365.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=Zgo5C1TwepfLoezCjnNw6%2FmaFt0yCoupgsnbOC8CHlM%3D) - Em seguida, navegue para *Acesso > Atribuição de Licenças* para verificar se a opção "**Atribuir licença SDP a todos os usuários**" está habilitada. - Se estiver, verifique se o Número Total de Usuários excede o Número Total de Licenças SDP. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26624624598045.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=9u10cD4kJJUuaPgVw71cOHDk9XygjJtOwOsKDa5lo8s%3D) - Se o número de usuários exceder as licenças disponíveis, entre em contato com seu representante de vendas da Cato para explorar opções para adquirir licenças SDP adicionais. - Se você não souber quem são, sinta-se à vontade para entrar em contato com [Suporte](/v1/docs/submitting-a-support-ticket). - Se "**Atribuir licença SDP a usuários ou grupos selecionados**" estiver selecionado, certifique-se de que os usuários provisionados pelo SCIM estejam incluídos nos grupos atribuídos. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26624104674205.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=oAWCmotgaOj1tKVrBbx03LWmc8za4UaE6tf8k9MOZmY%3D) ### Resolvendo Usuários Duplicados no CMA - Quando um usuário é excluído no Azure, o sistema acrescenta o valor do ObjectID ao valor do UPN e define o status ativo do usuário como falso. Esta ação desativa o usuário no banco de dados SCIM e atualiza o valor do UPN para incluir o ObjectID+UPN. Esse comportamento está alinhado com a [documentação Microsoft](https://learn.microsoft.com/en-us/answers/questions/129068/azure-ad-scim-adding-suffix-and-prefix-to-username).![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26860424599069.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=xbJcmE9j3R%2FVIH2CzS82NNGQvbhgjbR1Opa5Jk1%2B2Pk%3D) - Se o mesmo usuário for recriado no Azure usando o mesmo endereço de e-mail, um usuário duplicado será criado tanto no banco de dados SCIM quanto na CMA com um ObjectID diferente. Nesta fase, o UPN para os usuários duplicados será diferente. Neste cenário, o usuário desativado deve ser excluído na CMA para evitar duplicação. - A Cato permite usuários com endereços de e-mail duplicados; no entanto, apenas um usuário duplicado pode ser atribuído a uma licença SDP. É importante notar que o UPN e o ObjectID devem permanecer únicos em todos os Serviços de Diretório SCIM. ## Notas e Limitações 1. Diferentes usuários podem ser provisionados através do SCIM e LDAP. No entanto, se um usuário for provisionado através de ambos SCIM e LDAP, o provisionamento SCIM terá precedência. Como resultado, o usuário é removido dos grupos provisionados por LDAP e adicionado aos grupos provisionados por SCIM. Para mais detalhes, consulte [Provisionando Usuários com SCIM e LDAP](/v1/docs/provisioning-users-with-scim-and-ldap). 2. Se você planeja alternar entre provisionamento SCIM e LDAP, leia [Mudando Entre Provisionamento de Usuários SCIM e LDAP](/v1/docs/changing-between-scim-and-ldap-user-provisioning) primeiro para garantir uma transição suave. 3. Embora usuários e grupos possam ser excluídos na CMA, recomendamos que você exclua usuários diretamente em seu aplicativo SCIM. Consulte [Removendo Usuários ou Grupos do App SCIM](/v1/docs/provisioning-users-with-scim) para detalhes sobre a forma correta de fazer isso. ## Levantamento de casos para Suporte Cato Envie um [Ticket de Suporte](/v1/docs/submitting-a-support-ticket) com os resultados dos passos de solução de problemas acima. Por favor, inclua as seguintes informações no ticket: 1. Descrição do Problema e Impacto no Usuário - Uma descrição clara do problema encontrado durante o provisionamento SCIM. - Uma visão geral do escopo e impacto nos usuários afetados (por exemplo, número de usuários impactados, mensagens de erro recebidas, etc.). 2. Status de Provisionamento para o CMA - Os usuários afetados foram provisionados com sucesso para o CMA? - Se não, a análise dos logs pode oferecer insights adicionais e ajudar a identificar a causa subjacente do problema, facilitando a resolução e solução de problemas adicionais. - Faça login em [www.portal.azure.com](http://www.portal.azure.com). Vá para Aplicação Empresarial > Aplicativo de Provisionamento Cato > Provisionamento - Clique em "Logs de Provisionamento" para ver o histórico de provisionamento. - Clicar em um provisionamento específico abrirá o painel "Detalhes do log de provisionamento" à direita. Abaixo podemos ver que a sincronização para este objeto foi pulada porque não foi atribuída à aplicação. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/26676034994845.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A53%3A12Z&se=2026-11-19T05%3A53%3A12Z&sr=b&sp=r&sig=sAxK%2B9M9OKPdNt8t%2BO4KwEAvg5uoLrR4UYJKwr87rs4%3D) - Por favor, tente também o provisionamento sob demanda para os usuários impactados e inclua: - Uma captura de tela do resultado (mensagem de sucesso ou erro) - O timestamp exato de quando o provisionamento sob demanda foi realizado 3. Conectividade ao Cliente SDP - Os usuários provisionados com sucesso conseguem se conectar ao cliente SDP? - Se não, forneça uma captura de tela da interface do cliente mostrando o erro quando o usuário tentou se conectar - Forneça os logs do cliente usando o recurso [Registrar Problema](/v1/docs/recording-issues-using-the-cato-client).