Gerenciando Usuários e Leitores com SCIM na Entra

SCIM (System for Cross-domain Identity Management) é um protocolo padrão aberto que automatiza o provisionamento e o desprovisionamento do usuário entre provedores de identidade e aplicações. Quando integrado ao Microsoft Entra, o SCIM permite sincronizar automaticamente usuários, leitores e grupos do Entra para o Document360, eliminando a necessidade de gerenciamento manual do usuário. Quaisquer alterações feitas no Entra, como adicionar, atualizar ou desativar usuários, são automaticamente refletidas no Document360, garantindo que sua equipe sempre tenha o nível certo de acesso.

Antes de começar, certifique-se de que os seguintes pré-requisitos estejam cumpridos:

1. Complete a configuração SCIM no Microsoft Entra ID. Para instruções de configuração, veja SAML SSO com Entra.

2. Seu aplicativo Microsoft Entra ID deve ser criado como um aplicativo não de galeria usando:

   Nova aplicação > Crie sua própria aplicação > Integre qualquer outra aplicação que você não encontrar na galeria.

   Se você usar um aplicativo da Galeria, o provisionamento SCIM não estará disponível. Veja SAML SSO com Entra para mais detalhes.

3. O SSO SAML deve estar totalmente configurado e funcionando entre o Microsoft Entra ID e o Document360.

4. O provisionamento SCIM deve ser ativado no Document360. Navegue até Configurações > Usuários e permissões > Configuração SSO, abra sua configuração SSO e confirme que o botão Ativar provisionamento SCIM está ativado.

Comece a Provisionar

Para começar a provisionar no Entra, certifique-se de que você já criou e integrou o SCIM com o Entra. Depois de concluído:

1. Navegue até seu aplicativo SCIM no Entra e clique em Iniciar provisionamento.

2. No diálogo de confirmação, clique em Sim.

Com SCIM, você pode gerenciar leitores, usuários e grupos, e quaisquer alterações feitas serão sincronizadas automaticamente com o Document360.

Mapeamento de atributos atribuídos

Para criar um novo mapeamento de atributos para a condição de papel do Usuário,

1. Abra a aba do aplicativo Enterprise e selecione seu aplicativo SCIM SSO.

2. Navegue até a aba Provisionamento , selecione Mapeamento de Atributos (Prévia) no menu esquerdo e clique em Prover Usuários do ID Microsoft Entra.

3. Desça até a seção de Mapeamentos de Atributos , selecione a caixa Mostrar opções avançadas e então clique em Editar lista de atributos para aplicativos personalizados e assim prosseguir.

4. Na página da lista de atributos Editar , role para baixo, insira o parâmetro URL no campo Nome e defina o Tipo como Booleano a partir do menu suspenso, conforme mostrado abaixo.

 NOTA

Certifique-se de que não haja espaços em branco ao inserir o parâmetro URL no campo Nome .

5. Clique em Salvar, depois em Sim no diálogo de confirmação.

Uso do construtor de expressões para mapear papéis

Você pode configurar uma expressão de mapeamento de atributos no Entra que avalie o atributo de perfil existente de cada usuário, como Título do Trabalho, e determina automaticamente se ele deve ser provisionado como Usuário ou como Leitor no Document360.

A expressão mapeia diretamente para o isTeamAccount atributo:

• isTeamAccount = True → provisionado como Usuário

• isTeamAccount = False → fornecida como Leitor

Etapas para configurar

1. Abra sua aplicação SCIM SSO no Entra e navegue até o Provisionamento > Mapeamentos de Atributos.

2. Localize o isTeamAccount atributo e clique no ícone Editar ao lado dele. Isso irá até a página Editar Atributo .

3. Defina o tipo de mapeamento para Expressão.

4. Insira sua expressão no campo de expressão. A expressão avalia o atributo do perfil de cada usuário e determina se ele deve ser provisionado como Usuário ou Leitor. Consulte o link Use the expression builder abaixo do campo de expressão para construir visualmente e testar sua expressão contra um usuário real no seu diretório antes de aplicá-la.

 NOTA

Para mais informações sobre como construir e testar expressões no Entra, consulte a documentação do Expression Builder da Microsoft.

5. Defina o valor padrão se nulo (opcional) para Falso, isso garante que qualquer usuário sem um valor de atributo correspondente seja provisionado como Leitor por padrão.

6. Clique em Ok para salvar o atributo.

Exemplo

Se seus usuários tiverem um atributo Cargo no perfil do Entra, você pode mapear os papéis com base no título deles:

Switch([jobTitle], "False", "Manager", "True", "Senior Manager", "True", "Team Lead", "True")

Usuários com os títulos de Gerente, Gerente Sênior ou Líder de Equipe são provisionados como Usuários. Qualquer outro Título de Cargo retorna False e o usuário é provisionado como um Leitor.

Criar Usuário, Leitor e Grupo

Gerencie o acesso ao conteúdo para Usuários, Leitores e grupos

No Document360, nomes de usuários e grupos não podem ser editados ou excluídos diretamente, essas ações devem ser gerenciadas pelo Entra. No entanto, você ainda pode gerenciar papéis, permissões e acesso ao conteúdo dentro do Document360.

1. Selecione o usuário desejado e clique em Gerenciar acesso ao conteúdo.

2. No diálogo, use os menu suspensos para selecionar o acesso ao conteúdo desejado.

3. Se necessário, você também pode gerenciar atribuições em grupo e adicionar o usuário ao grupo desejado.

4. Clique em Atualizar para confirmar e salvar as alterações.

Atualizar Usuários, Leitores e Grupos

Para fazer alterações no nome do usuário/grupo,

1. Na barra de navegação da esquerda, clique em Usuários e procure pelo usuário na barra de busca, depois clique em Selecionar.

2. Na página de Visão Geral do usuário, abra a aba Propriedades e clique no ícone Editar para fazer as alterações necessárias.

3. Depois que as alterações forem feitas, clique em Salvar.

4. Para refletir essas mudanças no Document360, navegue para aplicativos empresariais > SCIM SSO app > Provisionamento > Provisão sob demanda.

5. Selecione o usuário atualizado na página Provisionamento sob demanda e clique em Provisão.

Os dados atualizados do usuário agora serão refletidos no Document360.

Excluir usuário, leitor ou grupo

Para excluir um usuário, leitor ou grupo,

1. Abra a aba Usuários no menu esquerdo, pesquise e selecione o usuário desejado.

2. Depois, clique em Excluir.

O usuário é excluído com sucesso. Essa mudança será refletida no Document360.

 NOTA

Deletar um usuário no Entra não remove o perfil do usuário do Document360. Em vez disso, o status do usuário muda de Ativo para Inativo.

Herdar de outra aplicação

Ao criar uma nova configuração de SSO no Document360, você pode herdar as configurações SCIM de uma conexão SSO existente. Essa abordagem simplifica o processo de configuração, evita etapas repetitivas de configuração e ajuda os administradores a economizar tempo, garantindo consistência entre integrações.

Configuração SSO herdada por filho

Na página Configurar Provedor de Identidade (IdP ), selecione o campo Configurar uma conexão existente e escolha o aplicativo pai habilitado para SSO SCIM do qual deseja herdar. Selecionar essa opção designará o projeto atual como projeto filho, herdando todas as propriedades relevantes do pai.

NOTA

Uma vez criada a configuração SSO, as configurações de provisionamento SCIM serão herdadas do aplicativo pai e não poderão ser modificadas no aplicativo filho.

Configuração SSO Herdada pelo Pai

A aplicação principal exibirá uma lista de todos os projetos que herdaram sua configuração. Quaisquer alterações feitas na aplicação principal serão automaticamente refletidas na aplicação filha.

• Se o SCIM for ativado no projeto pai depois que projetos filhos já o herdaram, os usuários e grupos serão automaticamente provisionados para todos os projetos filhos em segundo plano.

• Ativar a herança facilita o gerenciamento de múltiplas configurações de SSO com o SCIM ativado, já que todas as configurações são controladas a partir de um único aplicativo pai. Isso economiza tempo e reduz o esforço necessário para gerenciar cada configuração individualmente.

Solução de problemas

A sincronização falhou devido a um erro no servidor SCIM

Ao adicionar novos usuários do Entra, esse erro indica que um ou mais usuários não puderam ser sincronizados com o Document360. Isso pode ser causado por:

• Provisão de usuários duplicados

• Limite de usuários atingido com base no seu plano de assinatura atual

• Outros erros de validação ou processamento.

Clique em Ver detalhes para ver quais usuários não sincronizaram.