---
title: Autenticação com Entra ID (OIDC)
slug: help/neurons/pt_br/autenticacao-com-entra-id-oidc
createdAt: 2026-09-08T07:53:21.456Z
---

O Ivanti Neurons atualmente oferece a opção de selecionar o Entra ID como provedor de autenticação externa para o seu locatário. Essa é uma boa opção se você quer centralizar a experiência de logon do usuário final, reduzir a ocorrência de chamadas relacionadas a senha para o suporte técnico e ter controles granulares sobre políticas e trilhas de auditoria.

:::hint{type="info"}
Para usar o Entra ID, todos os membros devem aceitar a solicitação para que a Ivanti acesse seus dados básicos de perfil do Azure.
:::

## 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 **Entra ID**.
   As **Configurações do Entra ID** aparecem.

:::hint{type="info"}
Antes de dar continuidade à configuração do Ivanti Neurons, você deve primeiro realizar algumas etapas no Portal do Microsoft Azure.
:::
::::

::::ExpandableHeading
## Etapa 2 - Configuração do Entra ID (Portal do Microsoft Azure)

Antes de dar continuidade à configuração do Ivanti Neurons, você deve primeiro realizar as etapas a seguir no Portal do Microsoft Azure.

### Etapa A - Crie seu aplicativo do Entra ID

1. Faça login no **Centro de Administração do Entra ID** como administrador do Office 365.
2. No menu da barra lateral, clique em **Entra ID > Registros de aplicativo**.
   O **dashboard de registros de aplicativo** aparece.
3. Clique em **Novo registro**.
4. Insira um nome para o aplicativo e aceite a predefinição para os tipos de conta suportados: **Contas somente neste diretório organizacional**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/IRB8W7j4PcOChqE8ojyCL_azureadappregsettings.png" alt="Tela de registro de aplicativo do Microsoft Azure" position="flex-start" size="80" width="894" height="778" initialPath="Images/AzureADAppRegSettings.png" githubPath="PTB/Images/AzureADAppRegSettings.png" showCaption="false"}

5. Na seção **URI de redirecionamento**, selecione **Web** no menu **Selecione uma plataforma**. Insira o **URI de redirecionamento**, conforme exibido nas Configurações do Entra ID da Plataforma Neurons.
6. Clique em **Registrar** na parte inferior da caixa de diálogo.
7. Quando o registro do aplicativo estiver concluído, uma mensagem de sucesso será exibida e redirecionada para a página de visão geral do aplicativo registrado.

:::hint{type="danger"}
Você precisa registrar o **ID do aplicativo (cliente)** e o **ID do diretório (locatário)**, pois eles são necessários no próximo estágio da configuração no Ivanti Neurons.
:::

### Etapa B - Defina as configurações de autenticação

1. No aplicativo criado, navegue até **Gerenciar** > **Autenticação (prévia)**.
2. Navegue até **Configurações**.
3. Na seção **Concessão implícita e fluxos híbridos**, confirme se a caixa de seleção **Tokens de ID** está marcada.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/-q9cFp-2tRSGDiCy40C2h_azureadidtoken.png" alt="Tela de concessão implícita e fluxos híbridos mostrando tokens de ID selecionados" position="flex-start" size="73" width="734" height="195" initialPath="Images/AzureADidToken.png" githubPath="PTB/Images/AzureADidToken.png" showCaption="false"}

4. Insira o **URL de Logout** no campo **URL de logout do canal frontal**, conforme exibido em Configurações do Entra ID na Plataforma Neurons.
5. Clique em **Salvar**.

### Etapa C - Crie um segredo

1. No aplicativo criado, navegue até **Gerenciar** > **Certificados e segredos**.
2. Na guia **Segredos do cliente**, clique em **Novo segredo do cliente**.
3. Adicione uma descrição.
4. Selecione a duração da expiração de acordo com os padrões da sua empresa.
5. Clique em **Adicionar**.
6. Um valor é criado; você deve copiá-lo em algum lugar seguro, pois esta é a única vez que ele poderá ser visualizado.

:::hint{type="success"}
Certifique-se de copiar o **Valor Secreto**, e não o **ID Secreto**.
:::

A configuração do Entra ID agora está completa, e você pode retornar à Plataforma Ivanti Neurons.

:::hint{type="danger"}
O tempo de vida do Segredo é finito, portanto sua empresa deve tomar medidas para garantir que ele seja substituído antes de expirar, para evitar interrupções no Ivanti Neurons. Saiba como [Atualizar segredo do cliente](https://docs.ivanti.com/help/neurons/pt_br/autenticacao-com-entra-id-oidc#Clientsecret).
:::

### Etapa D - Configuração do token

Defina a configuração do token para poder usar o provisionamento automático.

1. No aplicativo criado, navegue até **Gerenciar** > **Configuração do token**.
2. Selecione **Adicionar Declaração Opcional** para abrir o painel lateral.
3. Para o **Tipo de token**, selecione **ID**.
4. Na lista **Declarações**, selecione **email**, **family\_name** e **given\_name**. Isso permite que se obtenham e-mail, nome e sobrenome para os novos membros do Ivanti Neurons, o que é um requisito ao se usar o provisionamento automático.
5. Clique em **Adicionar**.
   Um pop-up de permissões do Microsoft Graph é exibido.
6. No pop-up de permissões do Microsoft Graph, marque a caixa de seleção e clique em **Adicionar**.

### Etapa E - Conceder permissões

Se o usuário que está configurando o SSO não é administrador do Azure, então o administrador do Azure precisa logar no Azure e aprovar a solicitação de aplicativos para as permissões User-Read\Signin.

1. Selecione **Gerenciar** > **Permissões de API** para o aplicativo EntraID. Você deve estar logado como administrador do Azure.
2. Se a caixa de seleção tiver sido marcada durante a Configuração do Token, algumas permissões — incluindo User.Read — já terão sido adicionadas ao Microsoft Graph como permissões delegadas.
3. Se User.Read não estiver listada como permissão delegada, você precisará adicionar a permissão. Para fazer isso:
   - Selecione **Adicionar uma permissão**.
   - Selecione **Microsoft Graph > Permissões delegadas**.
   - Selecione a permissão **User.Read**.
4. Selecione **Conceder consentimento de administrador para \<entraid\_tenant>**.
::::

:::ExpandableHeading
## Etapa 3 - Definições de configuração do Entra ID (Plataforma Ivanti Neurons)

Depois de criar o aplicativo (cliente), o diretório (locatário) e o segredo do Entra ID, você pode continuar a configuração da Plataforma Ivanti Neurons.

1. Retorne à página **Configurações do Entra ID** (**Plataforma Ivanti Neurons** > **Autenticação&#x20;**> **Autenticação Externa (SSO)** > **Configurar e Habilitar**.
2. Insira o **ID do Diretório (locatário)** oriundo do registro de aplicativo do Entra ID.
3. Insira o **ID do aplicativo (cliente)**: oriundo do registro de aplicativo do Entra ID.
4. Insira o **Valor do segredo do cliente** que foi gerado e salvo.
5. Insira a **Data de expiração do segredo do cliente**; ela deve ser igual à data de expiração especificada durante a criação do segredo do cliente. Consulte Atualizar Segredo do Cliente para obter mais detalhes.
6. Clique em **Continuar&#x20;**&#x70;ara exibir a página Validar Configurações de Conexão.
:::

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

Você precisa se conectar com as credenciais do Entra ID para validar as configurações de conexão.

1. Na página Validar Configurações de Conexão, clique em **Validar Configurações** para acessar a página de login da sua organização em uma nova guia, insira suas credenciais do Entra ID e faça login. Se você já estiver conectado, as credenciais não serão necessárias e a validação ocorrerá automaticamente, portanto, certifique-se de estar conectado à conta que deseja autenticar.
   Você receberá uma tela de confirmação se o login for bem-sucedido.

:::hint{type="info"}
O nome de usuário do Azure deve corresponder exatamente ao nome de usuário do Ivanti Neurons.
:::

Retorne a esta guia (Validar Configurações de Conexão).

3. Marque a caixa de seleção **Confirmo que validei com êxito minhas configurações de conexão** para confirmar que você fez login corretamente.
4. Clique em **Continuar** e siga para converter as contas da Plataforma Ivanti Neurons.
   A página **Habilitar contas da Plataforma Ivanti Neurons** é exibida.

:::ExpandableHeading{customAnchorSlug="Validationtroubleshooting"}
## Solução de problemas de validação

- **E2018 Falha na autenticação**: o usuário não conseguiu autenticar com o Entra ID. 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 Entra ID.
- **E2019 Faltando declarações opcionais**: a etapa de validação falhou porque as declarações opcionais não estavam presentes no token retornado à Plataforma Ivanti Neurons a partir do Entra ID.
- **E2020 Não é possível vincular à conta de usuário da plataforma Neurons**: o logon de usuário do Entra ID 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 Entra ID.
:::
::::

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

O Entra ID agora está configurado, mas não habilitado.

Para habilitar, você precisa converter as contas da Plataforma Ivanti Neurons para usar o Entra ID.

1. Na págin&#x61;**&#x20;Habilitar contas da Plataforma Ivanti Neurons**, clique em **Sair e habilitar**.
   A págin&#x61;**&#x20;Login do Ivanti Neurons** é exibida.
2. Selecione **Entrar com Entra ID** e insira suas credenciais do Entra ID; a conversão será então concluída.

:::hint{type="info"}
O mesmo usuário deve configurar a autenticação do Entra ID e entrar e validar as credenciais no Ivanti Neurons para evitar erro de acesso negado.
:::

Todos os membros receberão um e-mail para confirmar que a conta foi convertida e que eles devem acessar o locatário com as credenciais do Entra ID daqui em diante. Se o membro não tiver credenciais do Entra ID, não conseguirá acessar o Ivanti Neurons.

:::hint{type="info"}
A Autenticação Externa (SSO) agora será exibida com o status **Ativado**.
:::
::::

## Configurar o autoprovisionamento

Habilitar o autoprovisionamento fará com que todos os membros no Registro de Aplicativo do Entra ID 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.

:::hint{type="info"}
Depois que o provisionamento automático for habilitado, todos que tenham acesso ao **Registro de Aplicativo do Entra ID** também terão acesso ao **Ivanti Neurons**. Você pode restringir o acesso a determinados usuários ou grupos de dentro do **Portal do Entra ID**. Para obter mais informações, consulte a [documentação do Microsoft Azure](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/assign-user-or-group-access-portal).
:::

:::ExpandableHeading{customAnchorSlug="Enable"}
## 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 as **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.
:::

Uma vez habilitado, as opções para **Editar** as funções padrão de controle de acesso e **Desabilitar** o autoprovisionamento tornam-se disponíveis. A edição de funções ou a desabilitação do autoprovisionamento não afetará membros que já estejam autoprovisionados, aplicando-se apenas àqueles que venham a ser provisionados após a conclusão das alterações.

:::hint{type="info"}
Você deve configurar as Declarações Opcionais da [Etapa D - Configuração do token](https://docs.ivanti.com/help/neurons/pt_br/autenticacao-com-entra-id-oidc#Step4) para que o provisionamento automático funcione.
:::

:::hint{type="info"}
**Importante**: depois que o provisionamento automático for habilitado, todos que tenham acesso ao Registro de Aplicativo do Entra ID terão acesso ao Ivanti Neurons. Você pode restringir o acesso a determinados usuários ou grupos de dentro do Portal do Entra ID. Consulte a [documentação do Microsoft Azure](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/assign-user-or-group-access-portal) para obter mais detalhes.
:::

## Atualizar segredo do cliente

Se o segredo do cliente do Entra ID está prestes a expirar, você precisa definir outro para continuar usando este método de autenticação.

1. Na Plataforma Ivanti Neurons, navegue até **Configuração** > **Autenticação**.
2. Clique em **Ações&#x20;**&#x65; selecione **Atualizar segredo do cliente**.
   A página **Atualizar segredo do cliente** é exibida.
3. Insira o novo **Segredo do Cliente** do seu aplicativo Entra ID.
4. Insira a data para receber um lembrete de quando o segredo do cliente estiver prestes a expirar. Um banner de lembrete será exibido na IU, e um lembrete por e-mail será enviado aos usuários com a função de administrador, 28 dias antes da expiração. Lembretes posteriores serão enviados 7 dias antes e 1 dia antes da expiração.
   Se o segredo do cliente expirar e um novo não for definido, o acesso ao serviço será interrompido, e você precisará entrar em contato com o Suporte da Ivanti para recuperar o acesso.
5. Clique em **Continuar**.
   A página **Validar segredo do cliente** é exibida.
6. Clique em **Validar Segredo do Cliente**, isso abre sua página de entrada do Entra ID.
   Digite seu nome de usuário e senha — serão iguais às credenciais de login da Plataforma Ivanti Neurons. Quando você fizer login, o novo segredo do cliente será validado. Se der certo, retorne ao assistente e continue a atualizar o segredo do cliente. Se não der certo, volte e verifique se o novo segredo do cliente que você inseriu está correto. Para ver outros motivos de falha, consulte [Solução de problemas de validação](https://docs.ivanti.com/help/neurons/pt_br/autenticacao-com-entra-id-oidc#Validationtroubleshooting)
7. Depois de ter validado corretamente o novo segredo do cliente, marque a caixa **Confirmo ter validado com sucesso meu novo segredo de cliente** e clique em **Continuar**.
8. Clique em **Salvar Alterações** para concluir o processo. Isso atualiza o segredo do cliente e o lembrete de expiração, com efeito imediato, e você não precisa fazer mais nada.
