Perguntas frequentes sobre SCIM
Perguntas gerais
O que é SCIM e por que devo usá-lo?
SCIM (Sistema para Gerenciamento de Identidade entre Domínios) é um protocolo padrão do setor para automatizar o gerenciamento de identidade do usuário entre sistemas. Com a integração do SCIM, você pode:
- Crie contas de usuário automaticamente quando novos funcionários ingressam
- Atualizar as informações do usuário quando ocorrerem alterações no seu provedor de identidade
- Remover contas imediatamente quando os funcionários saem
- Reduza o trabalho administrativo manual e os erros humanos
- Garantir dados de usuário consistentes em todos os sistemas
Quais provedores de identidade são suportados?
- Microsoft Entra ID (anteriormente Azure Active Directory, Azure AD)
Para configurar o Cosafe SCIM com outros IdPs, entre em contato com o suporte.
Perguntas técnicas
Qual versão do SCIM o Cosafe suporta?
A Cosafe implementa o protocolo SCIM 2.0, que oferece suporte específico a um subconjunto de operações focadas no provisionamento padrão de usuários e gerenciamento de grupos, que está sendo usado pela maioria dos provedores de identidade.
O que acontece se minha chave de API for comprometida?
Se você suspeitar que sua chave de API foi comprometida:
- Entre em contato com o suporte da Cosafe imediatamente em support@cosafe.com
- O suporte desativará a chave atual e emitirá uma nova
- Atualize a configuração do seu provedor de identidade com a nova chave
- Monitore os registros de auditoria do seu provedor de identidade
Perguntas sobre gerenciamento de usuários e grupos
Quais informações do usuário são sincronizadas?
Os seguintes atributos de usuário são sincronizados:
- Obrigatório: Nome de usuário, nome de exibição
- Opcional: Números de telefone, cargo
- Status: Status ativo para gerenciamento de conta
Atributos atualizáveis:
- Atualizável: Nome de usuário, nome de exibição, cargo, números de telefone
Para obter mais informações sobre atributos, consulte Atributos suportados
Quais informações do grupo são sincronizadas?
Os seguintes atributos de grupo são sincronizados:
- Opcional: Nome de exibição
Para obter informações sobre como remover o mapeamento do nome de exibição, consulte Etapa 5: Configuração do mapeamento de atributos e role um pouco para baixo.
Posso excluir determinados usuários ou grupos da sincronização SCIM?
Sim, a maioria dos provedores de identidade permite que você:
- Criar integração de provisionamento com escopo apenas para usuários e grupos atribuídos
- Configure as limitações de escopo nas suas configurações de provisionamento.
Para obter orientações específicas sobre a configuração, entre em contato com o suporte da Cosafe.
Posso usar o mesmo ID de grupo para vários grupos no Cosafe?
Com o SCIM, a correspondência precisa ser única. Um ID por grupo Cosafe.
O que acontece quando um usuário é excluído no meu provedor de identidade?
Quando um usuário é excluído ou desativado no seu provedor de identidade:
- A conta do usuário no Cosafe é excluída automaticamente
- O usuário perde o acesso ao Cosafe imediatamente
- Dados históricos e registros de auditoria são preservados
Posso substituir manualmente dados gerenciados pelo SCIM?
Você pode editar atributos que não são mapeados via SCIM (Atributos Suportados).
É altamente recomendável não editar dados e atributos mapeados via SCIM. Fazer isso resultará em dados de usuário conflitantes ou inválidos entre o Cosafe e seu IdP.
Ainda posso criar usuários manualmente se tiver habilitado o SCIM?
Sim! Os usuários criados manualmente serão ignorados pela sincronização do SCIM, desde que não sejam gerenciados pelo seu provedor de identidade.
Isso inclui adicionar o usuário a grupos gerenciados pelo SCIM.
O que acontece quando um usuário sincronizado que foi adicionado manualmente a grupos é removido?
Se um usuário for definido como inativo, excluído ou removido de todos os grupos SCIM no seu Active Directory, ele será excluído do Cosafe e removido de todos os grupos, incluindo os grupos gerenciados manualmente.
No entanto, se o usuário ainda for membro de um ou mais grupos SCIM, ele permanecerá em quaisquer grupos adicionados manualmente até que seja removido manualmente desses grupos ou até que atenda aos critérios acima.
Perguntas para solução de problemas
Os usuários não estão sincronizando. O que devo verificar?
Etapas comuns de solução de problemas:
-
Verificar credenciais da API:
- Verifique se a chave da API está correta e ativa
- Confirme o formato da URL base do SCIM
- Teste a conexão por meio da configuração de integração do seu provedor de identidade. Normalmente, nas configurações de integração/credenciais, após os campos base-url e access-key/token, há um botão "Testar", "Conectar" ou "Testar conexão".
-
Verifique a configuração do provedor de identidade:
- Verifique se o provisionamento está habilitado
- Confirme se os mapeamentos de atributos estão corretos
- Confirme se grupos e/ou usuários estão atribuídos à integração SCIM
Por que alguns atributos do usuário não estão sincronizando?
Possíveis causas:
- Mapeamento de atributos ausente: Verifique a configuração do seu provedor de identidade
- Atributos não suportados: Verifique se os atributos são suportados pelo Cosafe SCIM e estão mapeados corretamente na configuração do seu provedor de identidade
- Problemas com o formato dos dados: Certifique-se de que os formatos dos dados correspondam aos padrões SCIM esperados
Mais detalhes sobre mapeamento e requisitos de formato estão em Configuração de mapeamento de atributos
Como lidar com problemas de atribuição de grupos?
Para problemas de atribuição de grupo:
- Verificar mapeamento de grupo: Verifique se os grupos de provedores de identidade mapeiam para IDs de grupo Cosafe válidos
- Verificar permissões de grupo: Certifique-se de que os grupos existam e sejam acessíveis no Cosafe
- Revise as regras de atributo: Confirme a atribuição de grupo no seu provedor de identidade
Perguntas de implementação
Posso migrar usuários existentes para o gerenciamento do SCIM?
Sim, usuários existentes podem ser migrados para o gerenciamento do SCIM.
Precisa de mais ajuda?
Se você tiver dúvidas não abordadas nesta FAQ, envie um e-mail para nossa equipe de suporte em support@cosafe.com