Entra com SAML SSO

Microsoft Entra ID é o serviço de gerenciamento de identidade e acesso baseado em nuvem da Microsoft, anteriormente conhecido como Azure Active Directory. Com o SAML SSO configurado entre Microsoft Entra e Document360, seus usuários e leitores podem fazer login no Document360 usando suas credenciais Microsoft existentes, sem precisar de uma senha separada.

O que você pode fazer com o Microsoft Entra como seu IDP

Antes de começar

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

Passo 1: Criar uma aplicação SAML no Microsoft Entra

Faça login no Microsoft Entra

1. Faça login na sua conta Microsoft Azure no entra.microsoft.com.
2. Você será direcionado para a página do centro de administração do Microsoft Entra .

Crie a aplicação

1. No centro de administração do Microsoft Entra, selecione ID Entra na barra de navegação da esquerda e clique em aplicativos empresariais.
2. Na página de aplicações empresariais , clique em Nova aplicação > Criar sua própria aplicação.
3. Insira o nome da sua aplicação no campo Nome de Entrada e clique em Criar.

Passo 2: Configure SAML no Entra 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 > SAML.

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

5. A etapa Configurar SP exibe os parâmetros necessários para configurar sua integração SAML no Provedor de Identidade.

Configure SAML no Entra

1. Vá para o Microsoft Entra e, na página da aplicação criada, abra a aba de Login Único e selecione método SAML .

2. Clique em Editar na seção Configuração Básica de SAML e insira os parâmetros do Document360 conforme mostrado abaixo.

3. Clique em Salvar.

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

Configure o Provedor de Identidade no Document360

1. Volte ao Document360 e clique em Próximo para navegar até a etapa Configurar IdP .
2. Se você já tem uma configuração SSO existente, pode selecioná-la no menu suspenso Configurar uma conexão existente para herdar suas configurações. Isso elimina configurações redundantes e economiza tempo.

3. Preencha os campos necessários usando os parâmetros encontrados na seção Set Up Document360 SCIM SSO da página do Entra, conforme mostrado abaixo.

4. Baixe o Certificado (Base64) na seção de Certificados SAML e anexe-o ao campo de certificado SAML no Document360.

5. Ative ou desative a opção Permitir login iniciado por IdP , dependendo das necessidades do seu projeto. Saiba mais sobre o login iniciado por IdP.
6. Clique em Próximo para prosseguir até a página de provisionamento SCIM .

Passo 4: Configurar o provisionamento SCIM

O provisionamento SCIM automatiza o gerenciamento do ciclo de vida do usuário e do leitor entre Microsoft Entra e Document360. Quando ativado, usuários adicionados, atualizados ou desativados no Entra são automaticamente sincronizados 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. Na página de provisão SCIM no Document360, ative a opção Ativar provisão SCIM .
2. Um diálogo de confirmação será exibido. Leia os termos e clique em Aceitar. Um conjunto de parâmetros será então exibido.

Configure o provisionamento SCIM no Entra

1. Vá até Entra, selecione a aba Provisionamento no menu esquerdo e depois selecione Nova configuração no menu superior.

2. A página de configuração do novo provisionamento será exibida. Preencha os campos na seção de credenciais de administrador usando os parâmetros do Document360 conforme mostrado abaixo.

Defina papéis e grupos padrão no Document360

1. Navegue de volta para o Document360 e ative a opção Ativar sincronização de grupos . Quando ativado, usuários e grupos de leitores são automaticamente atribuídos com base nos mapeamentos de grupos 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 de 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 Empresarial no Document360 é criada com sucesso.

Passo 5: Complete o provisionamento SCIM na Entra

Teste e salve a conexão SCIM

1. Navegue de volta para o Entra, onde a página de configuração de novo provisionamento está exibida.
2. Depois que todos os campos necessários forem preenchidos, clique em Testar conexão para verificar a configuração.

3. Uma mensagem de confirmação aparecerá assim que a conexão de provisionamento SCIM entre Entra e Document360 for bem-sucedida.
4. Clique em Criar para finalizar a configuração.

O provisionamento SCIM entre Entra e Document360 foi criado com sucesso.

Melhores práticas

• Crie um aplicativo que não seja Galeria. Sempre use a opção Integrar qualquer outro aplicativo que você não encontrar na galeria ao criar seu aplicativo Entra. Aplicativos de galeria não suportam provisão SCIM personalizada.
• Armazene ambos os tokens secretos de forma segura. Trate os tokens SCIM primários e secundários como senhas. Armazene-os em um gerenciador de segredos ou cofre de senhas, não em arquivos de texto simples ou repositórios de código.
• Não teste a conexão SCIM antes de salvar a configuração do Document360. O teste falhará nessa etapa. Sempre complete e salve a configuração SSO do Document360 primeiro, depois volte ao Entra para testar.
• Defina o mapeamento de atributos no nível do usuário, não no nível do grupo. Ao configurar o userType atributo ou isTeamAccount , sempre defina-o no nível do usuário para evitar conflitos de provisão para usuários que pertencem a múltiplos grupos.
• Alinhe o timeout ocioso com sua política de segurança. Ative o Logout do usuário ocioso do SSO e defina a duração para corresponder aos requisitos de gerenciamento de sessões da sua organização.

FAQ