> 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/it/what-would-you-like-to-learn-about/account-administration/account-settings/invite-and-manage-users/enable-saml-single-sign-on.md).
# Abilita il Single Sign-On SAML
Gli amministratori dell'account possono abilitare [l'accesso unico SAML (SSO)](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) per consentire agli utenti dell'account di accedere all'account impact.com del tuo brand tramite un provider di identità (IDP) supportato, oppure tramite un link di accesso univoco. Scegli il metodo che preferisci.
SAML SSO utilizza una connessione per impact.com con il tuo provider di identità. Attualmente impact.com supporta i seguenti provider:
* AD FS
* Okta
* OneLogin
* Microsoft Entra ID
#### Abilita SAML SSO
{% hint style="warning" %}
**Avviso:** Se hai già abilitato SAML SSO e vuoi cambiare provider, avrai bisogno dell'aiuto del nostro team di Servizi tecnici. Prima di [aprire un ticket](https://impact.atlassian.net/servicedesk/customer/portal/6/group/1088), assicurati di salvare il file di metadati IDP esistente sul tuo dispositivo locale e prepara un elenco di nomi utente che devono essere migrati.
{% endhint %}
{% stepper %}
{% step %}
#### **Passaggio 1: carica il file di metadati IDP**
Prima di iniziare, assicurati di avere a disposizione il tuo **file di metadati IDP** in formato .XML — questo file deve essere caricato su impact.com.
1. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra, sotto *Generale,* seleziona **Autenticazione utente dell'account**.
3. Accanto al *tipo di autenticazione* elemento, seleziona  **\[Casella di controllo] SAML** e usa il  **\[Menu a discesa]** per selezionare il tuo provider di identità.
4. Usa il selettore file per trovare e **caricare il tuo file di metadati .XML**.
5. Nella parte inferiore della schermata, seleziona **Salva**.
{% endstep %}
{% step %}
#### **Passaggio 2: abilita SAML SSO per gli utenti dell'account**
Le seguenti istruzioni devono essere completate per ciascun utente che utilizzerà SAML SSO:
1. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra, vai a *Generale* e seleziona **Utenti dell’account**.
3. Passa il cursore su un utente e seleziona **\[Altro] → Modifica diritti di accesso**
4. Nel *Metodo di registrazione dell'utente* sezione, seleziona **SAML**.
5. In fondo al pannello a comparsa, seleziona **Salva**.
{% endstep %}
{% step %}
#### **Passaggio 3: configura l'accesso dell'utente tramite SAML SSO**
Esistono 2 modi per gli utenti di accedere a impact.com con SAML SSO:
* **Attraverso il tuo provider di identità (IDP)** — Configura una connessione/un connettore nel tuo IDP e usalo per autenticare gli utenti.
* **Attraverso il link di accesso univoco del tuo brand** — Per gli utenti che non accedono tramite la connessione IDP.
**Opzione A: accesso tramite provider di identità**
* **OneLogin** — In OneLogin, trova la *Impact Partnership Cloud* connessione nel *catalogo app di OneLogin* e segui le istruzioni visualizzate sullo schermo per abilitare e configurare l'app.
* **ADFS, Okta e Microsoft Entra ID** — Crea una nuova connessione personalizzata con questi valori esatti:
| Campo | Valore da inserire |
| ------------------------------------------------- | --------------------------------- |
| URL di Single Sign-On / URL di risposta / URL ACS | |
| URL destinatario | |
| URL di destinazione | |
| Restrizione audience | |
| Formato Name ID | EmailAddress |
| Risposta | Firmato |
| Firma dell'asserzione | Firmato |
| Algoritmo di firma | RSA\_SHA1 |
| Firma digest | SHA1 |
| Crittografia dell'asserzione | Non crittografato |
| Single Logout SAML | Disabilitata |
| AuthnContextClassRef | PasswordProtectedTransport |
* **Microsoft Entra ID** — Crea una nuova connessione personalizzata con questi valori esatti:
| Campo | Valore da inserire |
| ------------------------------------------------------------------------------------------- | --------------------------------- |
| URL di risposta (URL del servizio consumer dell'asserzione) | |
| URL di risposta (implicitamente) | |
| Identificatore (ID entità) | |
| Formato identificatore del nome (Impostazioni avanzate → “Formato identificatore del nome”) | EmailAddress |
| Opzione di firma della risposta (firma della risposta SAML) | Firmato |
| Firma dell'asserzione SAML (opzione) | Firmato |
| Algoritmo di firma | RSA\_SHA1 |
| Algoritmo digest | SHA1 |
| Certificato di crittografia (opzionale) | Non crittografato |
| URL di Single Logout | Disabilitata |
| AuthnContextClassRef predefinito (non esposto direttamente) | PasswordProtectedTransport |
I valori che inserisci devono corrispondere esattamente ai valori forniti sopra. Ad esempio, non aggiungere una barra finale al *URL di Single Sign-On / URL di risposta / URL ACS* campo in questo modo: `https://app.impact.com/saml/SSO`**`/`**, e non inserire più valori URL. Assicurati inoltre che l'indirizzo email dell'utente nel tuo IDP corrisponda esattamente all'indirizzo email dell'utente in impact.com.
**Opzione B: accesso tramite link brandizzato**
Se un utente non accede tramite il tuo IDP, può utilizzare un link di accesso brandizzato univoco per accedere al tuo account impact.com. Per ottenere questo link di accesso:
1. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra, sotto *Branding*, seleziona **Branding dell'accesso inserzionista**.
* Il tuo link brandizzato apparirà simile a questo: `https://app.impact.com/abe/Stark-Industries12345678912345/login.user?preview=t`
3. Dalla *Link di accesso* campo, copia e salva il *Link di accesso* da distribuire ai membri del tuo account impact.com.
{% hint style="warning" %}
**Importante:** L'unico utilizzo di questo link di accesso brandizzato è consentire agli utenti di accedere direttamente a impact.com quando non utilizzano il tuo IDP. Non inserire questo link nel tuo *URL di Single Sign-On / URL di risposta / 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/it/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.
