> 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 habilitar [o logon único SAML (SSO)](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) para que os usuários da conta da sua marca no impact.com acessem a plataforma por meio de um provedor de identidade (IDP) compatível ou de um link exclusivo de acesso. Escolha o método de sua preferência.

O SSO SAML usa uma conexão entre o impact.com e seu provedor de identidade. Atualmente, o impact.com é compatível com os seguintes provedores:

* AD FS
* Okta
* OneLogin
* Microsoft Entra ID

#### Habilitar o SSO SAML

{% hint style="warning" %}
**Aviso:** Se o SSO SAML já estiver habilitado e você quiser trocar de provedor, 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), salve o arquivo de metadados do IDP atual no seu dispositivo local e prepare uma lista dos nomes de usuário que precisam ser migrados.
{% endhint %}

{% stepper %}
{% step %}

#### **Etapa 1: Fazer upload do arquivo de metadados do IDP**

Antes de começar, tenha em mãos o **arquivo de metadados do IDP** no formato .XML — esse arquivo precisa ser enviado para o impact.com.

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. Na coluna à esquerda, em *Geral,* selecione **Autenticação de usuários da conta**.
3. Ao lado do item *Tipo de autenticação* , selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Caixa de seleção] SAML** e use o ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Menu suspenso]** para selecionar seu provedor de identidade.
4. Use o seletor de arquivos para localizar e **fazer upload do arquivo de metadados .XML**.
5. Na parte inferior da tela, selecione **Salvar**.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FxmP4vAfVX0qeE1RNgLUv%2FScreenshot%202026-04-16%20at%2010.52.21.png?alt=media&amp;token=cb6aa481-a1cd-4d11-8d00-30ca4d1dc5d7" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **Etapa 2: Habilitar o SSO SAML para os usuários da conta**

As instruções a seguir devem ser concluídas para cada usuário que usará o SSO SAML:

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. Na coluna à esquerda, acesse *Geral* e selecione **Usuários da conta**.
3. Passe o cursor sobre um usuário e selecione **\[Mais] → Editar direitos de acesso**
4. Na seção *Método de cadastro do usuário* , selecione **SAML**.
5. Na parte inferior do painel lateral, selecione **Salvar**.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FsnYUet3HzxHTSStNVDx9%2FScreenshot%202026-04-16%20at%2011.03.26.png?alt=media&amp;token=087a8479-7021-4f86-94ca-037090e216b0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **Etapa 3: Configurar o acesso dos usuários via SSO SAML**

Há duas maneiras de os usuários acessarem o impact.com com o SSO SAML:

* **Por meio do seu provedor de identidade (IDP)** — Configure uma conexão/conector no seu IDP e use-o para conectar os usuários.
* **Por meio do link de acesso exclusivo da sua marca** — Para usuários que não acessam pela conexão do IDP.

**Opção A: Acesso pelo provedor de identidade**

* **OneLogin** — No OneLogin, encontre a conexão *Impact Partnership Cloud* na *OneLogin App Catalog* e siga as instruções na tela para ativar e configurar o app.
* **ADFS, Okta e Microsoft Entra ID** — Crie uma nova conexão personalizada com estes valores exatos:

  | Campo                                             | Valor a inserir                   |
  | ------------------------------------------------- | --------------------------------- |
  | URL de logon único / URL de resposta / URL do ACS | <https://app.impact.com/saml/SSO> |
  | URL do destinatário                               | <https://app.impact.com/saml/SSO> |
  | URL de destino                                    | <https://app.impact.com/saml/SSO> |
  | Restrição de público                              | <https://app.impact.com>          |
  | Formato do ID do nome                             | EmailAddress                      |
  | Resposta                                          | Assinada                          |
  | Assinatura da asserção                            | Assinada                          |
  | Algoritmo de assinatura                           | RSA\_SHA1                         |
  | Assinatura do resumo criptográfico                | SHA1                              |
  | Criptografia da asserção                          | Não criptografada                 |
  | Logout único SAML                                 | Desativado                        |
  | AuthnContextClassRef                              | PasswordProtectedTransport        |
* **Microsoft Entra ID** — Crie uma nova conexão personalizada com estes valores exatos:

  | Campo                                                                                           | Valor a inserir                   |
  | ----------------------------------------------------------------------------------------------- | --------------------------------- |
  | URL de resposta (URL do serviço do consumidor de asserção)                                      | <https://app.impact.com/saml/SSO> |
  | URL de resposta (implicitamente)                                                                | <https://app.impact.com/saml/SSO> |
  | Identificador (ID da entidade)                                                                  | <https://app.impact.com>          |
  | 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 criptográfico                                                               | SHA1                              |
  | Certificado de criptografia (opcional)                                                          | Não criptografada                 |
  | URL de logout único                                                                             | Desativado                        |
  | AuthnContextClassRef padrão (não exposto diretamente)                                           | PasswordProtectedTransport        |

Os valores inseridos devem corresponder exatamente aos valores fornecidos acima. Por exemplo, não adicione uma barra no final ao campo *URL de logon único / URL de resposta / URL do ACS* da seguinte forma: `https://app.impact.com/saml/SSO`**`/`**, e não insira vários valores de URL. Verifique também se o endereço de e-mail do usuário no seu IDP corresponde exatamente ao endereço de e-mail desse usuário no impact.com.

**Opção B: login por link personalizado**

Se um usuário não fizer login pelo seu IDP, ele poderá usar um link de login personalizado e exclusivo para acessar sua conta do impact.com. Para obter esse link de login:

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. Na coluna à esquerda, em *Identidade visual*, selecione **Identidade visual do login do anunciante**.
   * Seu link personalizado será parecido com este: `https://app.impact.com/abe/Stark-Industries12345678912345/login.user?preview=t`
3. No campo *Link de login* , copie e salve o *Link de login* para distribuir aos membros da sua conta impact.com.

{% hint style="warning" %}
**Importante:** Este link de login personalizado serve apenas para permitir que os usuários entrem diretamente no impact.com quando não estiverem usando seu provedor de identidade (IDP). Não insira este link no campo *URL de logon único / URL de resposta / URL ACS* do seu IDP.
{% 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=<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.
