# Ativar SAML Single Sign-On

Os administradores da conta podem ativar [SAML single sign-on (SSO)](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) para que os usuários da conta acessem a conta da sua marca no impact.com por meio de um provedor de identidade (IDP) compatível, ou via um link de acesso único. Escolha um método de sua preferência.

O SAML SSO usa uma conexão para o impact.com com seu provedor de identidade. O impact.com atualmente 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 mudar 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), certifique-se de salvar seu arquivo de metadata do IDP no seu dispositivo local e prepare uma lista de nomes de usuário que precisam ser migrados.
{% endhint %}

{% stepper %}
{% step %}

#### **Passo 1: Fazer upload do arquivo de metadata do IDP**

Antes de começar, certifique-se de ter seu **arquivo de metadata do IDP** em formato .XML à mão — este arquivo precisa ser carregado no 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] → Configurações**.&#x20;
2. Na coluna da esquerda, em *Geral,* selecione **Autenticação de Usuário 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 **carregar seu arquivo de metadata .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%2Fgit-blob-d95efdb6cd2b7d870e402a7245be6d5b30d6b542%2F8c68969149f47881e416573435b0f7fdd6067e71b50b8d7ab87fe78b9c070d5b.png?alt=media" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

#### **Passo 2: Ativar SAML SSO para 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 ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] → Configurações**.&#x20;
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. 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%2Fgit-blob-a2b902e77831e90a91fd00189da9380f553b8a2c%2Ff13eaf5a71eeffb85357cca2e1c6326ce8b5c61d50e1c6e93d167b79b848a59e.png?alt=media" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

#### **Passo 3: Configurar o login de usuário via SAML SSO**

Existem 2 maneiras para os usuários acessarem o impact.com com SAML SSO:

* **Através do seu provedor de identidade (IDP)** — Configure uma conexão/conector no seu IDP e use-o para autenticar os usuários.
* **Através do link de login exclusivo da sua marca** — Para usuários que não fazem login por meio da conexão do IDP.

**Opção A: Login via provedor de identidade**

* **OneLogin** — No OneLogin, encontre a *Impact Partnership Cloud* conexão no *Catálogo de Aplicativos OneLogin* e siga as instruções na tela para habilitar 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              |
  | ---------------------------------------- | --------------------------------- |
  | Single Sign On URL / Reply URL / ACS URL | <https://app.impact.com/saml/SSO> |
  | Recipient URL                            | <https://app.impact.com/saml/SSO> |
  | Destination URL                          | <https://app.impact.com/saml/SSO> |
  | Audience Restriction                     | <https://app.impact.com>          |
  | Name ID Format                           | EmailAddress                      |
  | Response                                 | Signed                            |
  | Assertion Signature                      | Signed                            |
  | Signature Algorithm                      | RSA\_SHA1                         |
  | Digest Signature                         | SHA1                              |
  | Assertion Encryption                     | Não criptografado                 |
  | SAML Single Logout                       | Desativado                        |
  | AuthnContextClassRef                     | PasswordProtectedTransport        |
* **Microsoft Entra ID** — Crie uma nova conexão personalizada com estes valores exatos:

  | Campo                                                                                           | Valor a ser inserido              |
  | ----------------------------------------------------------------------------------------------- | --------------------------------- |
  | Reply URL (Assertion Consumer Service URL)                                                      | <https://app.impact.com/saml/SSO> |
  | Reply URL (implicitamente)                                                                      | <https://app.impact.com/saml/SSO> |
  | Identifier (Entity ID)                                                                          | <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)                                         | Signed                            |
  | Assinar Assertion SAML (opcional)                                                               | Signed                            |
  | Algoritmo de Assinatura                                                                         | RSA\_SHA1                         |
  | Algoritmo de Hash                                                                               | SHA1                              |
  | Certificado de Criptografia (opcional)                                                          | Não criptografado                 |
  | Single Logout URL                                                                               | Desativado                        |
  | AuthnContextClassRef padrão (não exposto diretamente)                                           | PasswordProtectedTransport        |

{% hint style="warning" %}
**Aviso:** Os valores que você inserir devem corresponder exatamente aos valores fornecidos acima. Por exemplo, não adicione uma barra no final ao *Single Sign On URL / Reply URL / ACS URL* campo assim: `https://app.impact.com/saml/SSO`**`/`**, e não insira múltiplos valores de URL. Por favor, também certifique-se 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.
{% endhint %}

**Opção B: Login por link com marca**

Se um usuário não estiver entrando via seu IDP, ele pode usar um link de login com marca exclusivo para acessar sua conta no 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil do usuário] → Configurações**.&#x20;
2. Na coluna da esquerda, em *Branding*, selecione **Branding de Login do Anunciante**.
   * Seu link com marca ficará parecido com este: `https://app.impact.com/abe/Stark-Industries12345678912345/login.user?preview=t`
3. No campo *Login Link* , copie e salve o *Login Link* para distribuir aos membros da sua conta no impact.com.

{% hint style="warning" %}
**Importante:** A única finalidade deste link de login com 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 no campo *Single Sign-On URL / Reply URL / ACS URL* do seu IDP.
{% endhint %}
{% endstep %}
{% endstepper %}
