> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/invite-and-manage-users/enable-saml-single-sign-on.md).
# Ativar SSO com SAML
Os administradores da conta podem ativar [login único por SAML (SSO)](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) para que os usuários da conta acessem a conta do impact.com da sua marca por meio de um provedor de identidade (IDP) compatível, ou por um link de acesso exclusivo. Escolha o método de sua preferência.
O SAML SSO usa uma conexão do impact.com com o seu provedor de identidade. Atualmente, o impact.com oferece suporte aos seguintes provedores:
* AD FS
* Okta
* OneLogin
* Microsoft Entra ID
#### Ativar SAML SSO
{% hint style="warning" %}
**Aviso:** Se você já tiver o SAML SSO ativado e quiser trocar de provedor, você precisará da ajuda da nossa equipe de Serviços Técnicos. Antes de [abrir um chamado](https://impact.atlassian.net/servicedesk/customer/portal/6/group/1088), certifique-se de salvar o arquivo de metadados do seu IDP atual no seu dispositivo local e preparar uma lista de nomes de usuário que precisam ser migrados.
{% endhint %}
{% stepper %}
{% step %}
#### **Etapa 1: Carregue o arquivo de metadados do IDP**
Antes de começar, certifique-se de ter o seu **arquivo de metadados do IDP** em formato .XML em mãos — este arquivo precisa ser enviado para o impact.com.
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na coluna da esquerda, em *Geral,* selecione **Autenticação do usuário da conta**.
3. Ao lado do *Tipo de autenticação* item, selecione  **\[Caixa de seleção] SAML** e use o  **\[menu suspenso]** para selecionar seu provedor de identidade.
4. Use o seletor de arquivos para localizar e **carregar seu arquivo de metadados .XML**.
5. Na parte inferior da tela, selecione **Salvar**.
{% endstep %}
{% step %}
#### **Etapa 2: Ative o SAML SSO para os usuários da conta**
As instruções a seguir precisam ser concluídas para cada usuário individual que usará o SAML SSO:
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na coluna da esquerda, vá para *Geral* e selecione **Usuários da conta**.
3. Passe o cursor sobre um usuário e selecione **\[Mais] → Editar direitos de acesso**
4. No *Método de cadastro do usuário* , selecione **SAML**.
5. Na parte inferior do painel deslizante, selecione **Salvar**.
{% endstep %}
{% step %}
#### **Etapa 3: Configure o login do usuário via SAML SSO**
Há 2 maneiras para os usuários acessarem o impact.com com SAML SSO:
* **Por meio do seu provedor de identidade (IDP)** — Configure uma conexão/conector no seu IDP e use-o para autenticar os usuários.
* **Por meio do link de login exclusivo da sua marca** — Para usuários que não fazem login por meio da conexão com o IDP.
**Opção A: Login pelo provedor de identidade**
* **OneLogin** — No OneLogin, encontre a *Impact Partnership Cloud* conexão no *Catálogo de aplicativos do OneLogin* e siga as instruções na tela para ativar e configurar o aplicativo.
* **ADFS, Okta e Microsoft Entra ID** — Crie uma nova conexão personalizada com estes valores exatos:
| Campo | Valor a ser inserido |
| ---------------------------------------------- | --------------------------------- |
| URL de login único / URL de resposta / URL ACS | |
| URL do destinatário | |
| URL de destino | |
| Restrição de público | |
| Formato do ID de nome | EmailAddress |
| Resposta | Assinada |
| Assinatura da asserção | Assinada |
| Algoritmo de assinatura | RSA\_SHA1 |
| Assinatura do resumo | SHA1 |
| Criptografia da asserção | Sem criptografia |
| Logout único do SAML | Desativado |
| AuthnContextClassRef | PasswordProtectedTransport |
* **Microsoft Entra ID** — Crie uma nova conexão personalizada com estes valores exatos:
| Campo | Valor a ser inserido |
| ----------------------------------------------------------------------------------------------- | --------------------------------- |
| URL de resposta (URL do Serviço Consumidor de Asserção) | |
| URL de resposta (implicitamente) | |
| Identificador (ID da entidade) | |
| Formato do identificador de nome (Configurações avançadas → “Formato do identificador de nome”) | EmailAddress |
| Opção de assinatura da resposta (assinar resposta SAML) | Assinada |
| Assinar asserção SAML (opção) | Assinada |
| Algoritmo de assinatura | RSA\_SHA1 |
| Algoritmo de resumo | SHA1 |
| Certificado de criptografia (opcional) | Sem criptografia |
| URL de logout único | Desativado |
| AuthnContextClassRef padrão (não exposto diretamente) | PasswordProtectedTransport |
Os valores que você inserir devem corresponder exatamente aos valores fornecidos acima. Por exemplo, não adicione uma barra final ao *URL de login único / URL de resposta / URL ACS* campo assim: `https://app.impact.com/saml/SSO`**`/`**, e não insira vários valores de URL. Certifique-se também de que o endereço de e-mail do usuário no seu IDP corresponda exatamente ao endereço de e-mail do usuário no impact.com.
**Opção B: Login pelo link da marca**
Se um usuário não estiver fazendo login por meio do seu IDP, ele poderá usar um link de login exclusivo da marca para acessar sua conta impact.com. Para obter esse link de login:
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na coluna da esquerda, em *Marca*, selecione **Branding de login do anunciante**.
* Seu link de marca ficará parecido com este: `https://app.impact.com/abe/Stark-Industries12345678912345/login.user?preview=t`
3. A partir do *Link de login* campo, copie e salve o *Link de login* para distribuí-lo aos membros da sua conta impact.com.
{% hint style="warning" %}
**Importante:** A única finalidade desse link de login com a marca é permitir que os usuários façam login diretamente no impact.com quando não estiverem usando seu IDP. Não insira esse link na *URL de login único / URL de resposta / URL ACS* campo.
{% endhint %}
{% 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://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/invite-and-manage-users/enable-saml-single-sign-on.md?ask=&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.
