Outras configurações com SAML SSO

O Document360 suporta SAML SSO com qualquer Provedor de Identidade (IdP) que suporte o protocolo SAML 2.0, mesmo que não esteja listado explicitamente nas opções IdP do Document360. Este artigo guia você como configurar SSO entre o Document360 e um Provedor de Identidade personalizado ou não listado.

O que você pode fazer com um IdP personalizado

Antes de começar

• Você tem as credenciais necessárias e acesso administrativo tanto ao Document360 quanto ao seu Provedor de Identidade escolhido.
• Você tem acesso de Proprietário ou Administrador no seu projeto Document360.
• Seu Provedor de Identidade suporta SAML 2.0.
• Abra o Document360 e seu Provedor de Identidade em duas abas separadas do navegador. Você precisará alternar entre elas várias vezes durante a configuração.

Passo 1: Crie uma aplicação SAML no seu Provedor de Identidade

Adicione uma nova aplicação no seu IDP

1. Faça login no console de administração do seu Provedor de Identidade.
2. Localize a seção onde você pode criar ou gerenciar aplicações (frequentemente chamada de Aplicações, Aplicações Empresariais ou similar).
3. Selecione a opção de criar uma nova aplicação.
4. Configure as configurações básicas para a nova aplicação:
   • Nome do Aplicativo: Insira um nome, por exemplo "Document360 SSO".
   • Tipo de Aplicação: Selecione SAML 2.0 como método de login.
5. Salve as configurações do seu aplicativo.

Passo 2: Configure SAML no seu IdP usando parâmetros do Document360

Obtenha os parâmetros do Provedor de Serviço no Document360

1. Abra o Document360 em uma aba separada.
2. Navegue até Configurações () > Usuários e permissões > SSO Empresarial.
3. Clique em Criar SSO.

4. Selecione Outros como seu Provedor de Identidade (IdP) para navegar automaticamente até a etapa Configurar SP .

5. A etapa Configurar SP exibe os parâmetros que você precisa para configurar o SAML no seu Provedor de Identidade.

Insira os parâmetros do Document360 no seu IdP

Na configuração SAML do seu Provedor de Identidade, insira os parâmetros do Document360 usando o mapeamento abaixo.

Configure o mapeamento de atributos no seu IdP

Você pode precisar configurar as instruções de atributos no seu Provedor de Identidade. Adicione os seguintes atributos.

Complete qualquer configuração adicional no seu IdP

1. Forneça quaisquer detalhes adicionais de configuração exigidos pelo seu Provedor de Identidade.
2. Revise suas configurações e salve a configuração em SAML.
3. Clique em Próximo no Document360 para navegar até a etapa Configurar IdP .

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

Configure o Provedor de Identidade no Document360

1. Volte para a aba Document360 que exibe a etapa Configurar IdP .
2. O campo Configurar uma conexão existente permite que você herde uma configuração SSO que já foi criada. Ao selecionar essa opção, a configuração atual do SSO será definida como filho e nenhuma alteração poderá ser feita nela.

3. Insira os valores correspondentes do seu Provedor de Identidade usando o mapeamento abaixo.

4. Baixe o Certificado X.509 do seu Provedor de Identidade e faça o upload no campo Certificado SAML no Document360.
5. Ative ou desative a opção Permitir login iniciado por IdP com base nos requisitos do seu projeto.

6. Clique em Próximo para prosseguir para a etapa de provisionamento do SCIM .

Passo 4: Configurar o provisionamento SCIM

O provisionamento SCIM automatiza o gerenciamento do ciclo de vida do usuário e do leitor entre seu Provedor de Identidade e o Document360. Isso está disponível se seu IdP suportar SCIM.

Se você não precisar de provisionamento SCIM, pule 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. Um conjunto de parâmetros será então exibido — use-os para habilitar o provisionamento SCIM no seu IDP.

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

1. Ative ativar a sincronização de grupos , se necessário. Isso atribui automaticamente usuários e leitores com base nos mapeamentos do seu grupo IdP.
2. 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.
3. 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.
4. 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 contas de usuários e leitores existentes para o SSO.

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

A configuração do SSO agora será configurada no Document360 usando o Provedor de Identidade selecionado pelo seu Usuário.

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 Provedor de Identidade (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 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.

Melhores práticas

• Verifique o suporte ao SAML 2.0 antes de começar. Confirme que seu Provedor de Identidade suporta o protocolo SAML 2.0. O Document360 não suporta SAML 1.x nem protocolos proprietários SSO.
• Verifique cuidadosamente o uso de maiúsculas e minúsculas do nome dos atributos. Os nomes email dos atributos são name diferenciados entre minúsculas. Certifique-se de que eles estejam inseridos exatamente conforme mostrado na tabela de mapeamento de atributos.
• Baixe e armazene o certificado X.509 antes de concluir a configuração. Você precisará enviar esse arquivo para o Document360. Guarde uma cópia em um local seguro caso precise reconfigurar.
• Teste com um único usuário primeiro. Antes de implantar o SSO para todos os usuários, verifique a configuração com uma conta de teste para confirmar que o mapeamento de atributos, certificados e URLs estão funcionando corretamente.

FAQ