SAML SSO com Entra

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 eles 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 > Configuração SSO.
3. Clique em Criar SSO.

4. Selecione o Entra ID como seu Provedor de Identidade (IdP) para navegar automaticamente até a página Configurar o Provedor de Serviço (SP ).

5. A página Configurar o Provedor de Serviço (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. Retorne ao Document360 e clique em Próximo para navegar até a página Configurar o Provedor de Identidade (IdP ).
2. Se você já tiver uma configuração de SSO existente, pode selecioná-la no menu suspenso Configurar uma conexão existente para herdar as 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 com base nos requisitos do seu projeto. Saiba mais sobre o login iniciado pelo 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 ativados, usuários adicionados, atualizados ou desativados no Entra 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 5: Mais configurações.

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 Concordar. 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 de 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. Volte para o Document360 e ative a opção Ativar sincronização de grupo . Quando ativados, usuários e grupos de leitores são automaticamente atribuídos com base nos mapeamentos de grupos IdP.
2. 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.

3. 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.
4. Clique em Próximo para navegar até a página de Configurações de Mais .

Passo 5: 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 o 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 automaticamente fornece usuários e grupos. Saiba mais sobre o grupo de leitores Auto Assign.
4. Ative o Logout do usuário ocioso SSO se necessário e defina a duração do ocioso.
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 SSO no Document360 é criada com sucesso.

Passo 6: Complete o provisionamento SCIM no 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 uma aplicação que não seja da 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-as 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 vai falhar nessa fase. Sempre complete e salve primeiro a configuração do SSO do Document360, 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 isTeamAccount atributo, 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