OneLogin com SAML SSO

O OneLogin é um Provedor de Identidade (IdP) que simplifica o gerenciamento de acesso do usuário 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 da 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 elas 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 > SSO Empresarial.
2. Clique em Criar SSO > SAML.

3. Selecione OneLogin como seu provedor de identidade na etapa Escolher 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á na etapa Configurar SP e copie os parâmetros que você precisa.

2. Vá para OneLogin e navegue até a aba 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 ao passo Configurar IdP .
3. No campo Configurar uma conexão existente , você pode herdar de uma configuração SSO já criada que tenha o 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 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 etapa de provisionamento do SCIM .

Passo 5: Configurar o provisionamento SCIM

O provisionamento SCIM automatiza o gerenciamento do ciclo de vida do leitor entre o OneLogin e o Document360. Quando ativado, 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 avance para Configurar as opções de nome e login do SSO abaixo.

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 Concordar.
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. Navegue de volta para o Document360. No campo de função padrão , a função está definida como Contribuinte 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 leitores , 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 continuar.

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 texto do botão de login, insira o texto para o 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 fornece automaticamente usuários e grupos. Saiba mais sobre o grupo de leitores de atribuição automática.
4. Ative o timeout SSO da sessão ociosa se necessário e defina a duração do tempo limite (HH:MM).
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.

SAML SSO com SCIM foi configurado com sucesso. Agora você pode gerenciar leitores diretamente do seu OneLogin IdP.

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 repetições de etapas 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 IdP , selecione o campo Configurar uma conexão existente e escolha o aplicativo pai habilitado para SSO SCIM do qual você deseja herdar. Selecionar essa opção designa o projeto atual como o projeto filho, herdando todas as propriedades relevantes do pai.

Configuração SSO herdada pelo pai

A aplicação mãe exibirá uma lista de todos os projetos que herdaram sua configuração. Quaisquer alterações feitas na aplicação mãe 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.
• Habilitar 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 selo SSO-SCIM ao lado do nome indica que o SCIM está ativado.

Gerencie usuários no Document360

Quando o SCIM está ativado, editar o nome de um usuário ou excluir um usuário diretamente no Document360 é desativado. Essas ações devem ser gerenciadas pelo seu IdP para manter ambas as 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 app SCIM correto no OneLogin. Procure e selecione SCIM Provisioner com SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups) especificamente. Usar um app diferente não funcionará com o Document360.
• Gerencie apenas leitores através do OneLogin SCIM. Atributos de usuário e mapeamento de grupos não são suportados. Planeje seu fluxo de trabalho de gerenciamento de usuários de acordo.
• Aprove 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 exclusões do OneLogin. Note que usuários excluídos no OneLogin tornam-se Inativos no Document360, não deletados.
• 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 em um só lugar.

FAQ