SAML SSO com OneLogin

OneLogin é um Provedor de Identidade (IdP) que simplifica o gerenciamento de acesso dos usuários ao permitir que eles façam login em múltiplos aplicativos com um único conjunto de credenciais. Com o SSO SAML configurado entre o OneLogin e o Document360, seus membros de equipe e leitores podem acessar o Document360 usando suas credenciais OneLogin existentes.

O que você pode fazer com o OneLogin como seu IDP

Antes de começar

• Você tem uma conta OneLogin ativa com acesso de administrador.
• Você tem acesso de Proprietário ou Administrador no seu projeto Document360.
• Abra o Document360 e o OneLogin em duas abas separadas do navegador. Você precisará alternar entre eles várias vezes durante a configuração.

Passo 1: Inicie a configuração do SSO no Document360

Criar SSO no Document360

1. No Document360, navegue até Configurações () > Usuários e permissões > Configuração SSO.
2. Clique em Criar SSO.

3. Selecione o OneLogin como seu provedor de identidade na página Escolha seu Provedor de Identidade (IdP ).

Passo 2: Criar uma aplicação SAML no OneLogin

Adicione o SCIM Provisioner com o app SAML

1. Faça login no seu Portal de Administração OneLogin.
2. No menu superior, selecione Aplicações.
3. Clique em Adicionar App.

4. Na barra de busca, digite SCIM e selecione SCIM Provisioner com SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups) na lista e clique em Salvar.

Baixe o certificado X.509

1. No seu aplicativo OneLogin, navegue até a aba SSO .
2. Clique em Ver Detalhes para baixar o certificado X.509.

Passo 3: Configure o Provedor de Serviço no OneLogin

Copie os parâmetros do SP do Document360 e insira o OneLogin

1. No Document360, vá até a página Configurar o Provedor de Serviço (SP) e copie os parâmetros que você precisa.

2. Vá até OneLogin e navegue até a aba de Configuração . Insira os parâmetros do Document360 usando o mapeamento abaixo.

Passo 4: Complete a configuração do SSO no Document360

Configure o Provedor de Identidade no Document360

1. No OneLogin, navegue até a aba SSO e copie os parâmetros exibidos lá.

2. No Document360, clique em Próximo para ir à página Configurar o Provedor de Identidade (IdP ).
3. No campo Configurar uma conexão existente , você pode herdar de uma configuração SSO já criada que tenha SCIM ativado em um projeto pai. Ao selecionar e herdar essa conexão, a configuração atual do SSO será definida como a configuração do SSO herdada pelo filho e herdará automaticamente a configuração SCIM do pai.

4. Insira os parâmetros do OneLogin no Document360 usando o mapeamento abaixo.

5. Anexe o certificado X.509 previamente baixado no campo de certificado SAML no Document360.
6. Ative ou desative a opção Permitir login iniciado por IDP de acordo com os requisitos do seu projeto.

7. Clique em Próximo para navegar até a página de provisionamento SCIM .

Passo 5: Configurar o provisionamento SCIM

O provisionamento SCIM automatiza o gerenciamento do ciclo de vida do leitor entre OneLogin e Document360. Quando ativados, os leitores adicionados ou desativados no OneLogin são sincronizados automaticamente com o Document360.

Se você não precisar de provisionamento SCIM, clique em Próximo e siga os passos do Passo 6: Mais configurações.

Ative o SCIM no Document360

1. Ative a opção Ativar provisão SCIM .

2. Um diálogo de confirmação aparece. Revise os termos, selecione a caixa de seleção e clique em Aceitar.
3. Os parâmetros necessários para completar a configuração SCIM no OneLogin serão então exibidos.

Configure SCIM no OneLogin

1. No OneLogin, navegue até a aba Configuração e role para baixo até a seção de Conexão da API .
2. Insira os parâmetros do Document360 usando o mapeamento abaixo.

3. Clique em Habilitar para ativar o provisionamento SCIM no OneLogin.
4. Clique em Salvar para criar com sucesso o aplicativo SAML com SCIM ativado.

Habilitar o provisionamento SCIM no OneLogin

1. No OneLogin, vá para a aba Provisão .
2. Selecione a caixa de seleção Habilitar provisionamento e clique em Salvar.

O SCIM Provisioner com aplicação SAML foi criado com sucesso.

Atribuir função padrão e grupos no Document360

1. Volte para o Document360. No campo do papel padrão , o papel é definido como Contribuidor por padrão. Você pode mudar isso a partir do menu suspenso, se necessário.
2. Nos campos de grupos de usuários e grupos de leitor , selecione os grupos que deseja adicionar. Vários grupos podem ser adicionados, e eles herdarão o papel padrão que você selecionou anteriormente.

3. Clique em Próximo para navegar em Mais configurações.

Passo 6: Mais configurações

Configurar o nome do SSO e as opções de login

1. No campo do nome do SSO , insira um nome para a configuração do SSO.
2. No botão Personalizar login, insira o texto do botão de login exibido aos usuários.
3. Atribuir automaticamente grupo de leitores — essa opção está disponível apenas para configurações SSO existentes. Para configurações de SSO recém-criadas, essa opção não será exibida, pois o SCIM automaticamente fornece usuários e grupos. Saiba mais sobre o grupo de leitores Auto Assign.
4. Ative o Logout do usuário SSO ocioso se necessário e alterne conforme suas necessidades.
5. Escolha se convida Todos os usuários ou apenas usuários selecionados para SSO usando os botões de rádio.

6. Clique em Criar para completar a configuração do SSO.

O SSAO SSO com SCIM foi configurado com sucesso. Agora você pode gerenciar os leitores diretamente pelo seu IdP do OneLogin.

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. Isso simplifica o processo de configuração, evita etapas repetidas 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 designa o projeto atual como projeto filho, herdando todas as propriedades relevantes do pai.

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.

Gerenciando o Document360 com o OneLogin

Depois de configurar com sucesso o aplicativo SAML com SCIM no Document360 usando o OneLogin, você pode gerenciar os leitores diretamente do OneLogin, com todas as alterações refletidas automaticamente no Document360.

Adicione um leitor

1. No menu superior do OneLogin, expanda o menu suspenso Usuários e selecione Usuários.
2. Clique em Novo Usuário, insira os dados necessários do usuário e clique em Salvar.

Um novo usuário agora é criado com sucesso.

Atribuir aplicação ao usuário

1. Após criar o usuário, vá em Aplicativo no menu esquerdo.
2. Clique no ícone + no canto superior direito para adicionar uma aplicação.
3. Selecione a aplicação com SAML providenciado pelo SCIM ativado e clique em Continuar.

4. Insira o endereço de e-mail do usuário no campo do nome de usuário SCIM e clique em Salvar.

O usuário agora é atribuído com sucesso à aplicação.

Aprovar status de usuário

1. No menu superior do OneLogin, clique em Aplicações e selecione Aplicações.
2. Escolha o aplicativo SAML provisionado por SCIM e abra a aba Usuários .
3. Clique no status do usuário, que aparece como Pendente, e então selecione Aprovar no diálogo de confirmação.

O usuário agora é aprovado e adicionado com sucesso ao Document360.

Verificar no Document360

Para verificar se o usuário foi adicionado com sucesso ao Document360:

1. No Document360, navegue até Configurações () > Usuários e permissões > Leitores e grupos.

O leitor é adicionado automaticamente no Document360. O distintivo SSO-SCIM ao lado do nome indica que o SCIM está habilitado.

Gerencie usuários no Document360

Quando o SCIM está ativado, editar o nome de um usuário ou deletar um usuário diretamente no Document360 é desativado. Essas ações devem ser gerenciadas pelo seu IDP para manter as duas plataformas sincronizadas.

No entanto, você ainda pode gerenciar o acesso ao conteúdo dentro do Document360.

Gerencie o acesso ao conteúdo

1. No Document360, navegue até Configurações () > Usuários e permissões > Leitores & grupos.
2. Selecione o usuário desejado e clique em Gerenciar acesso ao conteúdo.
3. Atribua o nível de acesso ao conteúdo no menu suspenso e clique em Atualizar.

O acesso ao conteúdo agora é atribuído com sucesso ao usuário.

Excluir um usuário

1. No menu superior do OneLogin, clique em Usuários e selecione o usuário que deseja excluir.
2. Expanda o menu suspenso Mais Ações e clique em Deletar.

3. No diálogo de confirmação, clique em Excluir novamente.

O usuário foi deletado com sucesso e não aparecerá mais no OneLogin.

Melhores práticas

• Use o aplicativo SCIM correto no OneLogin. Procure e selecione especificamente o SCIM Provisioner com SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups ). Usar um aplicativo diferente não vai funcionar com o Document360.
• Gerencie apenas leitores via OneLogin SCIM. Atributos de usuário e mapeamento de grupos não são suportados. Planeje seu fluxo de trabalho de gestão de usuários de acordo.
• Aprove os usuários provisionados rapidamente. Usuários adicionados no OneLogin aparecem no Document360 com o status Pendente. Aprove-os no OneLogin para ativar o acesso.
• Não exclua usuários no Document360 quando o SCIM estiver ativado. Deletar um usuário diretamente no Document360 é desativado quando o SCIM está ativo. Gerencie as exclusões do OneLogin. Note que usuários excluídos no OneLogin ficam Inativos no Document360, não são excluídos.
• Use a herança para configurações de múltiplos projetos. Se você tem vários projetos do Document360 que compartilham a mesma configuração de SSO, use a herança pai-filho para gerenciar todas as configurações de um só lugar.

FAQ