Skip to main content

Empresa e integrações

Este artigo foi traduzido automaticamente do inglês.

Ativar o Single Sign-On (SSO) com SAML

Visão geral

O Single Sign-On (SSO) permite que os usuários da sua conta do PlanRadar façam login usando o provedor de ID habilitado para SAML existente, como o Active Directory, o OneLogin e muitos outros. Isso significa que os usuários não precisam manter o controle de mais um e-mail e uma senha.

Isso também facilita o provisionamento de novos usuários:

  • Você pode criar usuários que fazem login com SSO imediatamente, já com o tipo de usuário, as permissões e os projetos definidos. Leia mais em Criar usuários que fazem login com SSO.
  • Se Create users automatically on first sign-in estiver ativado, as pessoas do seu provedor de identidade que ainda não têm um usuário do PlanRadar são criadas como subcontratados gratuitos no primeiro login. O tipo de usuário e as permissões podem ser alterados posteriormente por outro usuário com permissão para gerenciar usuários.

Acesso e permissões

Preparar o provedor de identidade SAML

O provedor de identidade SAML deve ser configurado para fornecer três atributos: Endereço de e-mail como nameid, firstname e lastname. Esses atributos permitem que o PlanRadar identifique corretamente o usuário e o provisione automaticamente.

Exemplo de ativação do SAML com o Azure

Configuração básica de SAML

  1. Faça login no portal do Azure como administrador de aplicativo em nuvem ou administrador de aplicativo do seu locatário do Azure AD.
  2. Navegue até Azure Active Directory > Aplicativos corporativos > Novo aplicativo > Aplicativo não Gallery, adicione o nome "PlanRadar" e, em seguida, clique em add.
  3. Na seção Manage, selecione Single sign-on.
  4. Selecione SAML.
  5. A página Set up Single Sign-On with SAML - Preview será exibida.
    image-20200221-104448.png

Para editar as opções básicas de configuração do SAML:

  1. Selecione o ícone Edit (um lápis) no canto superior direito da seção Basic SAML Configuration.
  2. Atualize a Basic SAML Configuration com base nos dados fornecidos pelo PlanRadar.

Configurar atributos e reivindicações do usuário

  1. Na seção User Attributes and Claims, selecione o ícone Edit (um lápis) no canto superior direito.
    image-20200221-104903.png
  2. Verifique o Name Identifier Value e defina o valor como user.userprincipalname e o formato como emailAddress.

Para modificar o Name Identifier Value:

  1. Selecione o ícone Edit (um lápis) para o campo Name Identifier Value

  2. Faça as alterações apropriadas no formato e na fonte do identificador, conforme necessário.

  3. Salve as alterações quando terminar.

Para adicionar uma reivindicação:

  1. Selecione Add new claim na parte superior da página.

  2. Digite o nome e selecione a fonte apropriada.

  3. Se o senhor selecionar a fonte Attribute, precisará escolher o atributo Source que deseja usar.

  4. Se o senhor selecionar a fonte Translation, precisará escolher a Transformation e Parameter 1 que deseja usar.

  5. Salve as alterações quando terminar.

    image-20200221-104945.png

  6. Por fim, vá para a seção SAML Signing Certificate e compartilhe o URL App Federation Metadata

    image-20200221-105621.png

Ativar o SSO na conta do PlanRadar

Para ativar o SSO:

  1. Clique em Settings
  2. Clique em Account
  3. Clique em Account settings (Configurações da conta)
    Access.png
  4. Marque a caixa de seleção Enable SSO With SAML
  5. Digite seu URL de metadados do IdP
  6. Clique em Enable SSO With SAML
    Ensable SSO.png

Depois que o SSO é ativado, a página mostra os dados de que o seu provedor de identidade precisa: SP Metadata URL, Consumer URL, Sign on URL, Logout URL e Enterprise Login ID.

Calling Data.png

Certificado de assinatura

O PlanRadar assina as mensagens SAML com um certificado. No painel Signing certificate, você vê quando ele expira. Clique em Download certificate para entregá-lo ao seu provedor de identidade e em Renew certificate antes que ele expire.

Opções de SSO

Em SSO options, escolha como o PlanRadar funciona com o seu provedor de identidade:

  • Create users automatically on first sign-in (ativado por padrão): as pessoas sem um usuário do PlanRadar são criadas como subcontratados gratuitos no primeiro login.
  • Update profiles from your identity provider (ativado por padrão): o nome, os dados de contato e os dados personalizados do usuário são atualizados a partir do seu provedor de identidade a cada login.
  • Single logout (ativado por padrão): sair do PlanRadar também desconecta o usuário do seu provedor de identidade. O Logout URL só é usado enquanto essa opção estiver ativada.
  • Allow encrypted assertions (desativado por padrão): aceita respostas SAML criptografadas do seu provedor de identidade.

Criar usuários que fazem login com SSO

Quando o SSO estiver ativo, você pode criar usuários que fazem login imediatamente pelo single sign-on da sua empresa. Eles não recebem uma senha do PlanRadar.

  • Criar usuário: selecione Log in with SSO ao lado do endereço de e-mail. Os campos de senha desaparecem. Leia mais em Criar e convidar usuários.
  • Importar usuários: mapeie uma coluna com true ou false para Log in with SSO. Leia mais em Importar usuários.
  • API de usuários: defina login_with_saml como true ao criar o usuário.

Se um domínio de e-mail estiver configurado somente para SSO, Log in with SSO é selecionado automaticamente e não pode ser desmarcado.

O novo usuário recebe um e-mail com o nome de usuário e um botão Login que abre a página de login da sua empresa. Depois de fazer login, ele tem o tipo de usuário, as permissões e os projetos que você definiu.

Como funciona

O SAML Single Sign-On (SSO) funciona transferindo sua identidade de um lugar (o provedor de identidade) para outro (PlanRadar). Isso é feito por meio de uma troca de documentos XML assinados digitalmente.

Por exemplo, se o senhor estiver conectado a um sistema que atua como um provedor de identidade (por exemplo, Microsoft Azure, OneLogin etc.) e quiser fazer login no PlanRadar, acontecerá o seguinte:

  1. O senhor acessa o PlanRadar
  2. O PlanRadar identifica sua origem (por subdomínio de aplicativo, endereço IP do usuário ou similar) e redireciona o usuário para o provedor de identidade, solicitando autenticação. (Essa é a solicitação de autenticação)
  3. O senhor tem uma sessão de navegador ativa existente com o provedor de identidade ou estabelece uma sessão fazendo login no provedor de identidade.
  4. O provedor de identidade cria a resposta de autenticação na forma de um documento XML contendo seu nome de usuário ou endereço de e-mail, assina-o usando um certificado X.509 e publica essas informações no PlanRadar.
  5. O PlanRadar, que já conhece o provedor de identidade e tem uma impressão digital do certificado, recupera a resposta de autenticação e a valida usando a impressão digital do certificado.
  6. Sua identidade é estabelecida e o senhor recebe acesso ao aplicativo.

Artigos relacionados

Segurança empresarial

Atualizado em 10 de junho de 2026