Single Sign-On (SSO)

Configuração e uso do SSO

---

Perigo

Este guia é destinado a administradores de sistema. Se você não tiver a experiência técnica necessária, entre em contato com o seu departamento de TI para obter assistência.

Visão geral

A Prevu3D Cloud Platform suporta o Single Sign-On (SSO) seguro por meio de protocolos padrão do setor:

• SAML 2.0 – para autenticação e login de usuários.

• SCIM 2.0 – para provisionamento automático de usuários e grupos.

Provedores de identidade suportados

Qualquer provedor de identidade que suporte totalmente os protocolos SAML 2.0 e/ou SCIM 2.0 deve ser compatível com o Prevu3D, incluindo Okta, Google Workspace, OneLogin, Ping Identity e outros. A implementação do Prevu3D segue as especificações oficiais SAML 2.0 e SCIM 2.0, garantindo ampla compatibilidade com sistemas de identidade modernos.

Testamos minuciosamente a integração com:

• Microsoft Entra ID (anteriormente Azure Active Directory)

• JumpCloud (English)

Nota

• Cada organização Prevu3D suporta apenas uma conexão com um provedor de identidade por vez.

• O recurso de SSO está incluído na assinatura Enterprise. Entre em contato com sales@prevu3d.com para habilitá-lo para a sua organização.

SAML 2.0 – Configuração de autenticação

Pré-requisitos

Para configurar o SSO baseado em SAML com o Prevu3D, você precisará de:

• Acesso de administrador à sua organização Prevu3D.

• Acesso ao seu IdP com permissão para configurar aplicativos.

Etapas

1. Faça login na sua conta Prevu3D (usando seu endereço de e-mail e senha)

2. Vá para a aba Settings

3. Selecione a aba SSO no menu à esquerda

Não consegue acessar a aba “SSO”?

1. Se ela estiver faltando, você não é um administrador da organização.

2. Se ela estiver esmaecida, sua organização não assinou o recurso de SSO.

4. Copie os seguintes valores da aba SSO e cole-os na configuração do seu IdP:

   • Service Provider Endpoint

   • Service Provider Entity ID

5. Recupere o seguinte do seu IdP e insira-o na aba SSO do Prevu3D:

   • SAML Certificate (formato PEM)

   • SAML Endpoint URL

6. Se o SCIM não estiver habilitado, defina os seguintes mapeamentos de atributos SAML:

   1. First name

   2. Last name

   3. Role (opcional – veja o Mapeamento de funções abaixo)

      

Cuidado

Esses atributos são opcionais quando o provisionamento SCIM está habilitado e configurado. O SCIM gerencia automaticamente os detalhes dos usuários.

7. Clique em Save na parte inferior da página.

8. Realize um login de teste a partir do seu IdP para verificar a configuração.

Mapeamento de funções (opcional)

Você pode atribuir funções de nível de organização do Prevu3D por meio de um atributo SAML personalizado (por exemplo, Prevu3DRole):

• Admin – Permissões totais em toda a empresa

• Guest – Sem acesso padrão (deve ser concedido no nível do projeto)

Se nenhum atributo de função for fornecido, uma função padrão é aplicada. Por motivos de segurança, recomendamos defini-la como Guest.

Cuidado

Se o SCIM estiver habilitado, a atribuição de funções deve ser tratada via SCIM.

Mapeamento de grupos (opcional)

Também é possível mapear grupos do seu sistema IdP para os grupos do Prevu3D a fim de simplificar o gerenciamento de acesso das pessoas da sua organização. As etapas a seguir orientam você no mapeamento dos seus grupos.

• Configure seu IdP para passar as associações de grupo por meio de um atributo SAML.

• Insira esse atributo na aba Prevu3D SSO.

• Na seção “Groups” do Prevu3D, clique em “Edit group” e especifique o valor de grupo SAML esperado pelo seu IdP.

• Esse mapeamento é aplicado aos usuários quando eles fazem login no Prevu3D Cloud. Se o usuário já estiver conectado, ele deve sair e entrar novamente para que as alterações de acesso tenham efeito.

Nota

• O mapeamento de grupos é aplicado no login. Os usuários devem sair e entrar novamente para aplicar o acesso atualizado.

• Certifique-se de que o grupo tenha algum acesso concedido; para mais informações, consulte a seção grupos.

Cuidado

• Se o SCIM estiver habilitado, a criação de grupos e a atribuição de associação devem ser tratadas via SCIM.

SCIM 2.0 – Configuração de provisionamento

O Prevu3D suporta o provisionamento de usuários e grupos por meio do protocolo SCIM 2.0 (System for Cross-Domain Identity Management).

Pré-requisitos

• Sua organização deve estar no plano Enterprise.

• Seu IdP deve suportar SCIM (por exemplo, Azure AD/Entra, Okta, JumpCloud).

O que o SCIM habilita

• Provisionamento de usuários – Novos usuários são criados automaticamente no Prevu3D

• Desprovisionamento de usuários – Os usuários são desabilitados ou removidos quando são desabilitados no seu IdP

• Atribuição de grupos – Grupos e funções podem ser gerenciados centralmente a partir do seu IdP

Guia de configuração

1. Faça login na sua conta Prevu3D como administrador da organização.

2. Vá para a aba Settings

3. Selecione a aba SSO no menu à esquerda

4. Role até a seção SCIM Provisioning e habilite-a.

   

5. Você encontrará:

   • SCIM Base URL (usuários do Entra ID, veja o aviso abaixo)

   • Bearer Token

Nota

Você também pode rotacionar o bearer token quando necessário para segurança ou rotação de credenciais.

Cuidado

Ao configurar o SCIM com o Entra ID (Azure AD), você deve anexar ?aadOptscim062020 ao final da SCIM Base URL fornecida pelo Prevu3D.

6. No seu provedor de identidade (por exemplo, Microsoft Entra ID):

   • Abra o aplicativo empresarial do Prevu3D.

   • Habilite o provisionamento SCIM.

   • Insira a SCIM Base URL e o Bearer Token obtidos na aba SSO.

7. Configure os mapeamentos de atributos para:

   • userName, givenName, familyName, email

   • Opcional: groups, roles, active

8. Salve sua configuração

   Seu IdP agora sincronizará automaticamente usuários e grupos com o Prevu3D com base no cronograma de provisionamento.

Definições

• IdP, Identity Provider (provedor de identidade): refere-se ao sistema que registra todos os usuários e habilita a conexão com vários outros serviços. Esta é a sua fonte de verdade para a sua organização, usuários e grupos. Ex.: Azure AD, JumpCloud…

• SP, Service Provider (provedor de serviço): refere-se ao aplicativo de serviço que consome as informações de SSO, neste caso o Prevu3D Cloud.

• SSO, Single Sign-On: refere-se a um mecanismo que permite aos usuários obter suas credenciais a partir de um único portal e distribuir a configuração de gerenciamento de usuários entre vários aplicativos.

• SAML, Security Assertion Markup Language: um protocolo de todo o setor que permite o uso do SSO em várias plataformas baseadas em nuvem.

• SCIM, System for Cross-Domain Identity Management: protocolo para o provisionamento de usuários e grupos.