> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-saml/microsoft-entra-id-saml-configuracao.md).

# Microsoft Entra ID - SAML - Configuração

{% hint style="success" %}

#### Credenciais de Usuário Obrigatórias

\[**Usuário Flosum**] - **Administrador do Sistema** Função
{% endhint %}

{% hint style="success" %}

#### Aviso importante

As instruções neste artigo cobrem um aplicativo de terceiros e podem não refletir a versão mais recente. Use estas instruções como um guia para concluir a tarefa, mas esteja ciente de que algumas telas, nomes de campos e etapas podem ter sido alterados.
{% endhint %}

## ![](https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d) Visão geral

Este artigo explica como integrar o Microsoft Entra ID com os aplicativos em nuvem da Flosum usando autenticação SAML para habilitar o Single Sign-On (SSO), permitindo que os usuários acessem a plataforma de forma contínua com suas credenciais existentes. Se você preferir integrar o Entra ID via OIDC, consulte o artigo a seguir.

* [Microsoft Entra ID - OIDC - Configuração](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-oidc/microsoft-entra-id-oidc-configuracao.md)

{% hint style="info" %}
Para instruções mais gerais sobre como adicionar um Provedor de Identidade, consulte o artigo a seguir.

* [Adicionando um provedor de identidade (SSO)](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/adicionando-um-provedor-de-identidade-sso.md)
  {% endhint %}

{% hint style="warning" %}

#### Hospedado pelo Cliente

Clientes que hospedam os Aplicativos Flosum em sua própria infraestrutura terão uma URL personalizada para fazer login em seus aplicativos. Ao usar esta documentação, substitua qualquer **URLs Hospedadas pelo Flosum** pelas suas próprias URLs.
{% endhint %}

## Configurar o Entra ID

{% stepper %}
{% step %}

### Criar aplicativo

1. Faça login na sua **Centro de administração do Entra** conta.
2. Selecione **Aplicativos corporativos**.
3. Clique em **Novo aplicativo**.
4. Selecione **Criar seu próprio aplicativo**.
5. Digite **Nome do aplicativo**.
6. Selecione **Integrar qualquer outro aplicativo que você não encontre na galeria (fora da galeria)**.
7. Clique em **Criar**.
   {% endstep %}

{% step %}

### Configurar o Single Sign-On

1. Clique em **Logon único** em **Gerenciar** seção no menu lateral esquerdo.
2. Clique em **SAML**.

#### Configuração básica do SAML

1. Clique em **Editar** para **Configuração básica do SAML**.
2. Clique em **Adicionar identificador** e insira uma identidade exclusiva para este SSO. Pode ser qualquer valor de string exclusivo.
3. Clique em **Adicionar URL de resposta** e insira a URL SAML da sua região na tabela abaixo.

<table><thead><tr><th width="159.6666259765625">Região</th><th>URL SAML</th></tr></thead><tbody><tr><td>Estados Unidos</td><td>https://global-us.flosum.app/api/v1/saml/acs</td></tr><tr><td>Alemanha</td><td>https://global-de.flosum.app/api/v1/saml/acs</td></tr><tr><td>Japão</td><td>https://global-jp.flosum.app/api/v1/saml/acs</td></tr><tr><td>Austrália</td><td>https://global-au.flosum.app/api/v1/saml/acs</td></tr></tbody></table>

4. Clique em **Salvar**.

#### Atributos e declarações

1. Clique em **Editar** para **Atributos e declarações**.
2. Clique em **Adicionar nova declaração** para adicionar cada uma das seguintes declarações.

| Nome         | Atributo de origem     |
| ------------ | ---------------------- |
| firstName    | user.givenname         |
| lastName     | user.surname           |
| email        | user.mail              |
| uniqueUserId | user.userprincipalname |

{% hint style="info" %}
A **uniqueUserId** declaração pode ser mapeada para qualquer atributo de usuário que seja exclusivo e constante.
{% endhint %}

#### Certificados SAML

**Certificado de assinatura do token**

1. Não edite o **Certificado de assinatura do token**.

{% hint style="info" %}
Um certificado de assinatura personalizado pode ser usado para o **Certificado de assinatura do token** se exigido por políticas de segurança ou conformidade.
{% endhint %}

**Certificados de verificação (opcional)**

(Opcional) Os certificados de verificação não são necessários para funcionar com o SSO da Flosum. Configure esta definição somente se exigido por suas políticas de segurança ou conformidade.

Se você ativar **Exigir certificados de verificação:**

1. Gere um par de chaves privada/pública.
2. Envie o certificado público do Provedor de Serviço usando o **botão Enviar certificado** .
3. Clique em **Salvar**.
   {% endstep %}

{% step %}

### Criar Provedor de Identidade em Configurações Globais

Siga as instruções gerais no artigo abaixo para começar a criar um provedor de identidade SAML.

1. [Adicionando um provedor de identidade (SSO)](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/adicionando-um-provedor-de-identidade-sso.md)
2. Complete a **Informações básicas** seção.
   1. Selecione **SAML** para o provedor de identidade **Tipo**.
3. Complete a **Informações do botão** seção.
4. (Opcional) Complete as **Informações do grupo** seção.

#### **Preencher os campos de informações SAML 2.0**

Copie as informações do seu aplicativo Entra ID para a seção Informações SAML 2.0. A primeira captura de tela abaixo mostra quais campos do aplicativo Entra ID devem ser copiados. A tabela explica onde inserir essas informações. A captura de tela final mostra um provedor de identidade concluído para um aplicativo SAML do Entra ID.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FFVORKklF8j3k3WkdkKEv%2FMsEntraId-Saml-Config-EntraIdApp-01.png?alt=media&amp;token=74ead72f-f919-4c86-8076-33e7e1349c91" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="179.6666259765625">Campo da Flosum</th><th>Campo do Entra ID</th><th>Instruções</th></tr></thead><tbody><tr><td><strong>Emissor</strong></td><td>Configuração básica do SAML → <strong>Identificador (ID da entidade)</strong></td><td></td></tr><tr><td><strong>ID da entidade</strong></td><td>Configurar {application name} → <strong>Identificador da Microsoft Entra</strong></td><td>Clique no <strong>Copiar</strong> ícone para copiar este link.</td></tr><tr><td><strong>Certificado de assinatura do provedor de identidade</strong></td><td>Certificados SAML → Certificado de assinatura do token → <strong>Certificado (Base64)</strong></td><td>Clique em <strong>Baixar</strong> para baixar o certificado. Depois de baixado, clique em <strong>Certificado de assinatura do provedor de identidade</strong> e faça o upload dele.</td></tr><tr><td><strong>Formato do Name ID</strong></td><td></td><td>Deixe em branco</td></tr><tr><td><strong>URL de login do provedor de identidade</strong></td><td>Configurar {application name} → <strong>URL de login</strong></td><td>Clique no <strong>Copiar</strong> ícone para copiar este link.</td></tr></tbody></table>

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F694JLGosuv0mFqqv1w7p%2FMsEntraId-Saml-Config-IdentityProvider-01.png?alt=media&amp;token=afd9221a-0a03-4518-a88a-71b4116fb43f" alt="" width="563"><figcaption></figcaption></figure></div>

#### Solicitação assinada SAML ativada

Se Certificados SAML → Certificados de verificação (opcional) → **Obrigatório** é **Sim:**

1. Marque a **Solicitação assinada SAML ativada** caixa de seleção.
2. Preencha os campos na tabela abaixo.

<table><thead><tr><th width="180.33331298828125">Campo da Flosum</th><th>Valor</th></tr></thead><tbody><tr><td><strong>Certificado de assinatura de autenticação</strong></td><td>Clique para enviar o certificado público que corresponde ao certificado de verificação.</td></tr><tr><td><strong>Chave privada de autenticação</strong></td><td>Clique para enviar a chave privada que corresponde ao certificado público.</td></tr><tr><td><strong>Senha da chave privada de autenticação</strong></td><td>Digite a frase-senha da chave privada, se estiver criptografada.</td></tr><tr><td><strong>Algoritmo de assinatura de autenticação</strong></td><td>Deixe em branco (ou especifique, se necessário).</td></tr></tbody></table>

#### Criptografia de asserção ativada

Se a criptografia de asserção estiver ativada no Entra ID:

1. Marque a **Criptografia de asserção ativada** caixa de seleção.
2. Preencha os campos na tabela abaixo.

<table><thead><tr><th width="180.33331298828125">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Certificado de criptografia</strong></td><td>Clique para enviar o certificado público usado para a criptografia de asserção.</td></tr><tr><td><strong>Chave privada de criptografia</strong></td><td>Clique para enviar a chave privada que corresponde ao certificado público.</td></tr><tr><td><strong>Senha da chave privada de criptografia</strong></td><td>Digite a frase-senha da chave privada, se estiver criptografada.</td></tr></tbody></table>
{% endstep %}

{% step %}

### Salvar e testar

{% hint style="info" %}
Para instruções sobre como fazer login com SSO, veja o artigo a seguir.

* [Fazendo login com SSO](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/fazendo-login-com-sso.md)
  {% endhint %}

1. Clique **Salvar** para salvar o provedor de identidade.
2. Para testar, abra uma janela anônima.
3. Comece a fazer login nas Configurações Globais com o nome do seu locatário.
4. Se o provedor de identidade foi configurado com sucesso, você deverá ver o botão SSO que você criou.&#x20;

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FyjADhD5WtXcsx5Z2ipai%2FMsEntraId-Saml-Config-Login-01.png?alt=media&amp;token=7a7861dc-2779-420d-88cc-0335a56b1002" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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.flosum.com/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-saml/microsoft-entra-id-saml-configuracao.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.