---
title: Autenticação com OneLogin (SAML)
slug: help/neurons/pt_br/autenticacao-com-onelogin-saml
createdAt: 2026-09-08T07:53:21.572Z
---

O Ivanti Neurons atualmente oferece a opção de escolher o OneLogin como provedor de autenticação externa para o seu locatário. O OneLogin centraliza a experiência de logon do usuário final, reduz a ocorrência de chamadas relacionadas a senha para o suporte técnico e gera controle granular sobre políticas e trilhas de auditoria.

## Configurar e habilitar a autenticação externa

:::ExpandableHeading
## Etapa 1 - Configurar e habilitar a autenticação externa (Plataforma Ivanti Neurons)

1. Na Plataforma Ivanti Neurons, navegue até **Administrador** > **Autenticação**.
   A página **Autenticação** aparece.
2. Na seção **Autenticação Externa (SSO)**, clique em **Configurar e habilitar**.
   A página **Habilitar autenticação externa (SSO)** é exibida.
3. No menu suspenso **Provedor**, selecione **OneLogin**.
4. No menu suspenso **Método de login**, selecione **Saml 2.0.**
   As definições de configuração de SAML 2.0 do OneLogin aparecem. É recomendável deixar essa guia aberta para consultar quando for configurar os detalhes no console do OneLogin.
:::

::::ExpandableHeading
## Etapa 2 - Configuração do aplicativo OneLogin (console do OneLogin)

1. Faça login no console do **OneLogin**.
2. Navegue até **Aplicativos&#x20;**> **Aplicativos**.
3. Clique em **Adicionar aplicativo** para adicionar um novo aplicativo.
   A tela **Localizar aplicativos** é exibida.
4. Selecione **Conector personalizado SAML (avançado)**.
   A tela **Adicionar conector personalizado SAML (avançado)** é exibida.
5. Insira a descrição conforme necessário e clique em **Salvar**.
6. Em **Configuração**, insira nos campos a seguir os valores oriundos da guia Ivanti Neurons que foi aberta:
   1. **Audiência (ID da entidade): ID da entidade.**
   2. **Destinatário: URL do Serviço do Consumidor de Declaração**
   3. **Validador de URL do ACS (consumidor): URL do Serviço do Consumidor de Declaração**
   4. **URL do ACS (consumidor): URL do Serviço do Consumidor de Declaração.**
7. Clique em **Salvar**.
8. Navegue até **Parâmetros** e atualize o campo Conector personalizado SAML (avançado) conforme segue.
   1. Clique em :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/WEWAs3z3CoqH82_iQzGsR_add-application.png" alt caption size="10" width="36" height="38"}. Nomeie o campo como **email** e selecione **Incluir na declaração SAML** > **Salvar**. Em **Editar campo email**, defina **Valor** como **Email** > **Salvar**.
   2. Clique em :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/WEWAs3z3CoqH82_iQzGsR_add-application.png" alt caption size="10" width="36" height="38"}. Nomeie o campo como **family\_name** e selecione **Incluir na declaração SAML** > **Salvar**. Em **Editar campo family\_name**, defina **Valor** como **Last Name** > **Salvar**.
   3. Clique em :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/WEWAs3z3CoqH82_iQzGsR_add-application.png" alt caption size="10" width="36" height="38"}. Nomeie o campo como **given\_name** e selecione **Incluir na declaração SAML** > **Salvar**. Em **Editar campo given\_name**, defina **Valor** como **First Name** > **Salvar**.

      :::hint{type="info"}
      Atualize a página se o campo **Valor** estiver refletido como **Sem predefinição**.
      :::
9. Navegue até **SSO** > **Mais ações.&#x20;**&#x43;lique em **Metadados SAML**.
   O arquivo de metadados é baixado.
10. Navegue até a página **Habilitar autenticação externa** da Plataforma Ivanti Neurons que estava aberta e clique em **Selecionar arquivo**.
11. Abra o arquivo de metadados baixado e clique em **Carregar**.
12. Clique em **Continuar** para validar as configurações.
::::

:::ExpandableHeading
## Etapa 3 - Validar as configurações de conexão (Plataforma Ivanti Neurons)

Você deve se conectar com as credenciais do OneLogin para validar as configurações de conexão.

1. Na página **Validar configurações de conexão**, clique em **Validar configurações**.
   A validação ocorre automaticamente. Você receberá uma tela de confirmação se o login for bem-sucedido.
2. Retorne à página **Validar configurações de conexão** e marque a caixa de seleção para confirmar o login bem-sucedido.
   O OneLogin agora está configurado, mas não habilitado. Para habilitar, você precisa converter as contas da Plataforma Ivanti Neurons em OneLogin.
3. Clique em **Continuar** para prosseguir para a página **Converta sua conta da plataforma Ivanti Neurons**.
:::

:::ExpandableHeading
## Solução de problemas de validação

- E2018 Falha na autenticação: o usuário não conseguiu autenticar com o OneLogin. Verifique se o nome de usuário e a senha estão corretos e se o usuário tem permissões no Registro de Aplicativo do OneLogin.
- E2019 Declarações opcionais ausentes: a etapa de validação falhou porque as declarações opcionais não estavam presentes no token retornado à Plataforma Ivanti Neurons a partir do OneLogin.
- E2020 Não é possível vincular à conta de usuário da plataforma Neurons: o login de usuário do OneLogin não corresponde ao usuário da plataforma Ivanti Neurons. O endereço de e-mail da conta de usuário da Plataforma Ivanti Neurons deve corresponder ao endereço de e-mail usado para logar no OneLogin.
:::

:::ExpandableHeading
## Etapa 4 - Habilitar contas da Plataforma Ivanti Neurons (Plataforma Ivanti Neurons)

1. Na página **Converta sua conta da plataforma Ivanti Neurons**, clique em **Sair e habilitar**. O Ivanti Neurons é desconectado.
2. Clique em **Entrar com OneLogin** para concluir o processo.
3. Agora você pode ver o aplicativo OneLogin, em **Administrador** > **Autenticação**, com o status **Habilitado**.
4. Clique em **Sair** na plataforma Neurons.
   Agora, ao fazer login novamente, você será direcionado ao OneLogin para escolher a conta e fazer login com as credenciais do OneLogin.
:::

## Configurar o autoprovisionamento

Habilitar o autoprovisionamento fará com que todos os membros no Registro de Aplicativo do OneLogin recebam automaticamente acesso ao Ivanti Neurons, sem que seja necessário passar pelo processo de convite manual. Quando um novo membro fizer login pela primeira vez, uma nova conta da Plataforma Ivanti Neurons será provisionada em Ivanti Neurons > Membros. Todos os novos membros autoprovisionados receberão as funções de controle de acesso definidas na configuração.

:::ExpandableHeading
## Habilitar autoprovisionamento

1. Na Plataforma Ivanti Neurons, navegue até **Configuração** > **Autenticação**.
   A página **Método de autenticação** aparece.
2. Na seção **Autenticação Externa (SSO)**, clique em **Ações** e selecione **Habilitar autoprovisionamento**.
3. No menu suspenso **Funções padrão**, selecione a função de controle de acesso que você deseja atribuir a todos os novos membros.
   Para configurar **Funções**, acesse **Ivanti Neurons** > **Administrador** > **Funções**.
4. Clique em **Habilitar Autoprovisionamento** para confirmar a seleção da função e habilitar o provisionamento automático de todos os novos membros.
:::

:::hint{type="info"}
Uma vez habilitado, você pode editar as funções padrão de controle de acesso e desabilitar o provisionamento automático. Essas alterações serão aplicadas somente aos membros provisionados após as modificações e não afetarão os membros existentes.
:::

:::hint{type="danger"}
Habilitar o provisionamento automático concede a todos os usuários do Registro de Aplicativo do OneLogin acesso ao Ivanti Neurons. Você pode restringir o acesso a determinados usuários ou grupos de dentro do Aplicativo OneLogin.
:::

## (Opcional)Atualizar metadados (Plataforma Ivanti Neurons)

1. Na Plataforma Ivanti Neurons, navegue até **Administrador** > **Autenticação**.
   A página **Autenticação** aparece.
2. Na seção **Autenticação externa**, clique em **Ações&#x20;**> **Atualizar metadados**.
   A tela **Atualizar metadados SAML** é exibida.
3. Em **Definições de Configuração OneLogin**, clique em **Selecionar arquivo**.
4. Abra o arquivo de metadados baixado e clique em **Carregar**.
5. Clique em **Continuar** para validar as configurações.
6. Na página **Validar novos metadados SAML**, clique em **Validar metadados SAML**.
7. Uma nova guia é aberta na página de login da sua organização. Insira suas credenciais e faça login.
   A validação ocorre automaticamente. Você receberá uma tela de confirmação se o login for bem-sucedido.
8. Retorne à página **Validar novos metadados SAML** e marque a caixa de seleção para confirmar o login bem-sucedido.
9. Clique em **Continuar** para prosseguir para a página Salvar novos metadados SAML.
10. Clique em **Salvar alterações&#x20;**&#x70;ara concluir o processo.
    Uma notificação confirmando a atualização bem-sucedida dos metadados é recebida.

## (Opcional) Excluir método de autenticação (Plataforma Ivanti Neurons)

1. Na Plataforma Ivanti Neurons, navegue até **Administrador** > **Autenticação**.
   A página **Autenticação** aparece.
2. Na seção **Autenticação externa**, clique em **Ações** > **Excluir método de autenticação**.
   A tela **Excluir autenticação externa** é exibida.
3. Clique em **Sair e reautenticar**.
   O Ivanti Neurons é desconectado.
4. Clique em **Entrar com e-mail e senha**.
5. Insira as credenciais e clique em **Entrar**.
6. Navegue até **Administrador** > **Autenticação** > **Autenticação** externa e clique em **Ações** > **Excluir método de autenticação**.
   A tela **Excluir autenticação externa&#x20;**&#xE9; exibida.
7. Clique em **Excluir método de autenticação**.
   O método de autenticação existente agora está excluído.
