Ferramenta de sincronização de usuários em massa

A ferramenta de sincronização de usuários em massa é um utilitário configurável e sem servidor para automatizar e gerenciar operações de ciclo de vida do usuário entre o serviço de diretório central da sua organização e a plataforma CCAI. É um projeto de código aberto que pode ser encontrado no Google Cloud repositório do GitHub

Você pode usar a ferramenta de sincronização de usuários em massa para sincronizar contas de usuário, atribuições de equipe e papéis com base nas associações de grupo no diretório de origem. Isso ajuda a garantir que as permissões de usuário na plataforma CCAI estejam sempre alinhadas com o provedor de identidade principal da sua organização. Isso pode ajudar a reduzir a administração manual, eliminar erros e melhorar a segurança.

O serviço é gerenciado por uma interface da Web e oferece suporte aos três serviços de diretório a seguir:

  • Google Workspace

  • Microsoft Active Directory (via LDAP)

  • Microsoft Entra ID

Como a sincronização funciona

A ferramenta de sincronização de usuários em massa segue estas etapas sempre que executa uma sincronização:

  1. Identificar usuários gerenciados: recebe todos os usuários da plataforma CCAI que têm o User Sync Custom Role atribuído. Essa é a lista de usuários atuais de todos os usuários gerenciados por essa ferramenta.

  2. Criar lista de diretórios: conecta-se ao diretório configurado (por exemplo, o Google Workspace) e recebe todos os membros de cada grupo de diretório definido na seção Group Mappings. Isso cria uma lista abrangente de usuários de diretório de todos os usuários ativos na plataforma CCAI.

  3. Processar adições: o sistema compara a lista de usuários atual com a lista de usuários de diretório. Qualquer usuário na lista de usuários de diretório que não esteja na lista de usuários atual (ou esteja marcado como Inactive na plataforma CCAI) será adicionado a uma lista de "adição".

  4. Processar desativações: qualquer usuário que esteja Active na lista de usuários atual , mas não esteja na lista de usuários de diretório, será adicionado a uma lista de "desativação". O status será definido como Inactive.

  5. Processar atualizações: para usuários que estão Active e presentes nas duas listas, o sistema compara as equipes e os papéis atuais da plataforma CCAI com as regras definidas na seção Group Mappings. Se houver uma incompatibilidade, o usuário será adicionado a uma lista de "atualização" com as atribuições corretas.

  6. Enviar mudanças: as listas "adicionar", "desativar" e "atualizar" são combinadas em um único payload e enviadas à API Bulk user management para aplicar todas as mudanças em uma única operação.

Recursos

A ferramenta de sincronização de usuários em massa oferece os seguintes recursos:

  • Sincronização automatizada: defina uma programação (por hora, diária ou cron personalizada) para manter os usuários sincronizados automaticamente.

  • Mecanismo de mapeamento flexível: mapeie grupos de diretório para equipes e papéis específicos da plataforma CCAI. Um único grupo de diretório pode conceder vários papéis ou uma atribuição de equipe.

  • Modo de simulação: execute uma sincronização "Somente simular" para gerar um relatório de todas as mudanças propostas (adições, atualizações, desativações) sem aplicá-las. Esse recurso permite a verificação de regras antes de confirmar qualquer mudança ativa.