> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/microsoft-entra-id.md).

# Microsoft Entra ID

Use o Microsoft Entra ID (anteriormente Azure AD) como seu provedor de identidade para que os usuários façam login no Dispel com suas credenciais da Microsoft via OAuth (OIDC) ou SAML.

## Visão geral

Conecte o Microsoft Entra ID — a plataforma de identidade em nuvem da Microsoft, anteriormente conhecida como Azure AD — como provedor de identidade da sua organização. Depois de conectado, seus usuários entram no Dispel com suas credenciais da Microsoft por meio de logon único. Você pode conectar o Entra via **OAuth (OIDC)** ou **SAML**.

Esta página cobre a configuração específica do Entra. Para o comportamento compartilhado que se aplica a todos os provedores — como os usuários entram, o mapeamento de grupos, MFA e a desconexão — veja [Provedores de identidade](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md).

{% hint style="info" %}
**Onde encontrá-lo.** Entre como administrador da organização e abra **Configurações → Integrações** (ou a dedicada **Configurações → Autenticação** página). O Microsoft Entra ID aparece na **seção Identidade e Autenticação (IdP / SSO)** . Clique em **Conectar** no card dele para começar.
{% endhint %}

## Antes de começar

* Você configurará o lado do IdP em **Microsoft Entra admin center** (ou portal do Azure), então você precisará de acesso administrativo lá.
* Decida um protocolo — **OAuth (OIDC)** ou **SAML**. Veja [Escolhendo um protocolo](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#choosing-a-protocol).
* Certifique-se de que os usuários que farão login via Entra já estejam **convidados para sua organização** no Dispel. O SSO autentica usuários, mas não cria acesso por si só.

{% hint style="warning" %}
**Um provedor por vez.** Se sua organização já estiver conectada a outro provedor de identidade, desconecte-o antes de conectar o Entra.
{% endhint %}

## Conectar com OAuth (OIDC)

#### No Microsoft Entra ID

1. No Microsoft Entra admin center, vá para **Registros de aplicativo → Novo registro** e crie um app para o Dispel.
2. Adicione uma **Web** URI de redirecionamento do seu endereço Dispel seguida de `/oauth/login-callback` — por exemplo `https://app.dispel.com/oauth/login-callback`. Confirme o endereço exato do seu ambiente com seu representante do Dispel se tiver dúvidas.
3. Em **Certificados e segredos**, crie um **segredo do cliente** e copie o valor dele.
4. Anote seu **ID da Aplicação (cliente)** e o endpoint OAuth/OIDC do seu tenant.

#### No Dispel

1. Clique em **Conectar** no card do Microsoft Entra ID e **Selecione Protocolo de Autenticação → OAuth**.
2. Preencha os campos:

| Campo                            | Valor do Entra                                                                       |
| -------------------------------- | ------------------------------------------------------------------------------------ |
| **URL do Cliente**               | O endpoint OAuth/OIDC do seu tenant (onde os tokens são emitidos).                   |
| **ID do Cliente**                | As **ID da Aplicação (cliente)** do registro do seu app.                             |
| **Segredo do Cliente**           | O valor do segredo do cliente que você criou.                                        |
| **Identificador da Organização** | Um identificador exclusivo que você escolhe; os usuários o digitam na tela de login. |

3. Clique em **Salvar configurações**.

## Conectar com SAML

#### No Microsoft Entra ID

1. No Microsoft Entra admin center, vá para **Aplicativos empresariais → Novo aplicativo → Criar seu próprio aplicativo**, depois abra **Logon único → SAML**.
2. Em **Configuração básica do SAML**, cole os valores que o Dispel mostra no topo do formulário SAML:
   * **Identificador (ID da Entidade)** ← ID da Entidade do **Provedor de Serviços (SP)**.
   * **URL de Resposta (URL do Serviço de Consumidor de Asserção)** ← ID da Entidade do **URL do Serviço de Consumidor de Asserção**.
3. Na configuração SAML do Entra, colete:
   * **URL de Login** → SSO do **URL de SSO**.
   * **Identificador do Microsoft Entra** → SSO do **ID da Entidade do Provedor de Identidade**.
   * Baixe o **Certificado (Base64)** → SSO do **Certificado de Assinatura Base64**.

#### No Dispel

1. Clique em **Conectar** no card do Microsoft Entra ID e **Selecione Protocolo de Autenticação → SAML**.
2. Copie o **Provedor de Serviços (SP)** e **URL do Serviço de Consumidor de Asserção** mostrado no topo do formulário (use **Copiar ID** / **Copiar URL**) no Entra, conforme acima.
3. Preencha os campos:

| Campo                                        | Valor do Entra                                                                       |
| -------------------------------------------- | ------------------------------------------------------------------------------------ |
| **URL de SSO**                               | O Entra **URL de Login**.                                                            |
| **ID da Entidade do Provedor de Identidade** | As **Identificador do Microsoft Entra**.                                             |
| **Certificado de Assinatura Base64**         | O certificado Base64 baixado. Cole-o ou use **Fazer upload do certificado**.         |
| **Identificador da Organização**             | Um identificador exclusivo que você escolhe; os usuários o digitam na tela de login. |

4. Clique em **Salvar configurações**.
5. Clique em **Testar conexão**. O Dispel redireciona você para o Entra para entrar e, em seguida, mostra o e-mail e o nome recebidos. Se o teste falhar, confirme se os valores correspondem ao seu app no Entra e se o usuário de teste foi convidado para sua organização.

## Após conectar

* **Os usuários entram** digitando o Identificador da Organização na tela de login do Dispel e autenticando com a Microsoft. Veja [Como os usuários entram](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#how-users-sign-in).
* **Mapear grupos do Entra para grupos do Dispel** para que a associação permaneça sincronizada — veja [Mapeamento de Grupos OIDC](/documentation/documentation-pt-br/integre-e-administre/integrations/oidc-group-mapping.md).
* **MFA** enforçada no Entra aplica-se durante o login; os códigos de uso único por e-mail do Dispel não se aplicam a usuários de SSO. Veja [SSO e autenticação multifator](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#sso-and-multi-factor-authentication).
* **Para trocar de protocolo ou provedor**, desconecte primeiro. Veja [Trocando ou desconectando um provedor](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#switching-or-disconnecting-a-provider).

## Perguntas frequentes

<details>

<summary>Isso é o mesmo que "Azure AD"?</summary>

Sim. A Microsoft renomeou o Azure Active Directory para Microsoft Entra ID. Se o seu console do Entra ainda mostrar rótulos "Azure AD" em alguns lugares, a configuração é a mesma.

</details>

<details>

<summary>Qual protocolo devo usar com o Entra?</summary>

Ambos funcionam. Use aquele que corresponder à forma como seu app no Entra está configurado — um registro de aplicativo OIDC para OAuth ou um aplicativo empresarial com logon único SAML para SAML.

</details>

<details>

<summary>Minha conexão de teste SAML falhou. O que devo verificar?</summary>

Confirme se a URL de SSO, o ID da Entidade e o certificado correspondem exatamente ao seu app SAML no Entra, se você colou o ID da Entidade SP e a URL ACS do Dispel na Configuração básica do SAML do Entra, e se o usuário de teste existe no Entra e foi convidado para sua organização Dispel.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/microsoft-entra-id.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.