> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurare SSO e provisioning SCIM

> Collega il tuo identity provider ad AhaSlides per il single sign-on, richiedi l'SSO per il dominio e-mail e crea i membri con SCIM 2.0.

Il single sign-on (SSO) permette al tuo team di accedere ad AhaSlides tramite l'identity provider della tua organizzazione invece che con una password AhaSlides, e il provisioning SCIM crea e disattiva i loro account dallo stesso provider. Usali insieme quando il tuo team IT ha bisogno di un unico posto per controllare chi può accedere ad AhaSlides.

## Prima di iniziare con SSO e SCIM

SSO e SCIM non sono disponibili su tutti i piani. Per aggiungerli al tuo team, contattaci tramite il [modulo Enterprise](https://ahaslides.com/enterprise/) o all'indirizzo [hi@ahaslides.com](mailto:hi@ahaslides.com).

Nelle impostazioni del tuo team non c'è nessuna schermata SSO o SCIM. Tu configuri il tuo identity provider e il nostro team completa per te la parte di AhaSlides:

| Passaggio | Tu | AhaSlides |
| - | - | - |
| Collega il tuo identity provider | Crea l'app AhaSlides nel tuo identity provider e inviaci i dettagli | Invia il nome del tuo provider e attiva l'SSO per il tuo team |
| Collega i tuoi domini e-mail | Dicci con quali domini accede il tuo team | Li collega al tuo team |
| Richiedi l'accesso solo con SSO | Chiedici di attivarlo | Lo attiva o disattiva per i tuoi domini collegati |
| Provisioning SCIM | Inserisci l'URL SCIM e il token nel tuo identity provider | Genera il tuo token SCIM |

Ti serve l'accesso come amministratore al tuo identity provider e un [team](/it/teams-and-enterprise/managing-your-team-members) di AhaSlides a cui si uniranno i tuoi membri.

## Collega il tuo identity provider

AhaSlides funziona con qualsiasi identity provider SAML 2.0, come Okta, e con Microsoft Entra ID.

<Steps>
  <Step title="Chiedici di attivare l'SSO">
    Contattaci indicando il nome del tuo team e i domini e-mail che usi. Ti rispondiamo con il tuo **nome del provider**, un identificativo breve della tua organizzazione che compare nei tuoi indirizzi SSO.
  </Step>

  <Step title="Crea l'app AhaSlides nel tuo identity provider">
    Per un provider SAML 2.0, crea un'app SAML con questi valori:

    | Campo | Valore |
    | - | - |
    | Single sign-on URL (ACS URL) | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | Audience URI (SP entity ID) | Il valore che ti inviamo insieme al nome del provider |
    | Name ID | L'indirizzo e-mail dell'utente |

    Puoi anche scaricare i metadati del nostro service provider da `https://presenter.ahaslides.com/p/saml/your-provider-name/metadata`.

    Per Microsoft Entra ID, registra invece un'applicazione. Ti inviamo il redirect URI da aggiungere.
  </Step>

  <Step title="Inviaci i dettagli del tuo identity provider">
    Per SAML, inviaci l'URL di accesso dell'identity provider, l'issuer e il certificato di firma X.509, oppure il file di metadati che li contiene. Se vuoi che nome e cognome vengano compilati, dicci quali attributi li contengono.

    Per Microsoft Entra ID, inviaci il tenant ID, il client ID e un client secret.
  </Step>

  <Step title="Assegna le persone e fai una prova">
    Assegna l'app alle persone che devono usare AhaSlides. Quando ti confermiamo che la connessione è attiva, provala seguendo i passaggi in Accedere con SSO.
  </Step>
</Steps>

## Collega i tuoi domini e-mail al tuo team

L'SSO funziona solo per gli indirizzi e-mail di un dominio collegato al tuo team, e i domini li colleghiamo noi per te. Inviaci tutti i domini con cui accedono i tuoi membri.

* Un dominio può essere collegato a un solo team.
* Chi ha un'e-mail su un dominio non collegato non può accedere tramite il tuo SSO.

## Accedere con SSO

<Steps>
  <Step title="Apri la pagina SSO">
    Nella [pagina di login di AhaSlides](https://presenter.ahaslides.com/pages/login), clicca su **Accedi con SSO** (Log in with SSO).
  </Step>

  <Step title="Inserisci la tua e-mail di lavoro">
    Scrivi il tuo indirizzo e-mail e clicca su **Login** (Log in). AhaSlides ti porta alla pagina di accesso della tua organizzazione.
  </Step>

  <Step title="Accedi con la tua organizzazione">
    Dopo aver effettuato l'accesso lì, arrivi in AhaSlides.
  </Step>
</Steps>

La prima volta che qualcuno accede con SSO, AhaSlides crea il suo account se non ne ha uno e lo aggiunge al tuo team con il ruolo di **membro** (Member). Non imposta mai una password AhaSlides.

## Richiedi l'SSO per il tuo dominio

Per impostazione predefinita, configurare l'SSO aggiunge un modo per accedere, ma non toglie gli altri. Chi ha già una password AhaSlides può continuare a usarla. Se la tua organizzazione ha bisogno che l'SSO sia l'unico modo di accesso, chiedici di attivare l'accesso solo con SSO per i tuoi domini collegati. Serve prima una connessione SSO funzionante.

Una volta attivato, chiunque usi un indirizzo e-mail di un dominio collegato vede questo:

| Dove | Cosa vede |
| - | - |
| Pagine di login, iscrizione e password dimenticata | Una finestra intitolata **La tua organizzazione richiede l'accesso unico (SSO)** (Your organisation requires single sign-on) dopo aver inserito l'e-mail. **Continua con SSO** (Continue with SSO) lo porta alla pagina SSO; **Usa un altro indirizzo email** (Use a different email) svuota il campo. |
| La pagina SSO | Il messaggio "Your organisation requires single sign-on. Please continue below to sign in." con la sua e-mail già inserita |
| Impostazioni account | Nessuna sezione **Password** (Password), e il suo indirizzo e-mail non può essere modificato |

Questo vale per ogni indirizzo del dominio collegato, comprese le persone che non si sono ancora unite al tuo team.

## Configurare il provisioning utenti SCIM

SCIM permette al tuo identity provider di creare, aggiornare e disattivare gli account AhaSlides per te. AhaSlides supporta SCIM 2.0 per gli utenti.

<Steps>
  <Step title="Chiedici un token SCIM">
    Generiamo il token e te lo inviamo. Conservalo in un posto sicuro: ne teniamo solo un hash, quindi non possiamo mostrartelo di nuovo. Se lo perdi, o se potrebbe essere stato esposto, chiedici un nuovo token.
  </Step>

  <Step title="Inserisci i dettagli di connessione nel tuo identity provider">
    | Impostazione | Valore |
    | - | - |
    | URL base SCIM | `https://presenter.ahaslides.com/api/scim/v2` |
    | Autenticazione | Bearer token, inviato come `Authorization: Bearer your-token` |
    | Identificativo univoco | `userName` |
  </Step>

  <Step title="Associa gli attributi utente">
    Associa gli attributi elencati in Attributi SCIM supportati, poi attiva la creazione, l'aggiornamento e la disattivazione degli utenti. Lascia disattivata la sincronizzazione della password.
  </Step>

  <Step title="Assegna gli utenti">
    Assegna persone o gruppi all'app AhaSlides. Il tuo identity provider crea poi i loro account.
  </Step>
</Steps>

### Attributi SCIM supportati

| Attributo SCIM | Usato per |
| - | - |
| `userName` | L'indirizzo e-mail del membro. Identifica l'utente ed è salvato in minuscolo. |
| `name.givenName`, `name.familyName` | Nome e cognome |
| `displayName` | Usato per il nome solo quando `name` non viene inviato: la prima parola diventa il nome e il resto il cognome |
| `active` | `true` mantiene l'account attivo; `false` lo disattiva e disconnette il membro |
| `externalId` | Restituito invariato nella risposta |

### Operazioni SCIM supportate

| Metodo | Endpoint | Cosa fa |
| - | - | - |
| `GET` | `/Users` | Elenca gli utenti del tuo team. Accetta `filter=userName eq "name@example.com"`, `startIndex` e `count` (10 per impostazione predefinita). |
| `GET` | `/Users/{id}` | Restituisce un utente |
| `POST` | `/Users` | Crea un utente |
| `PATCH` | `/Users/{id}` | Aggiorna alcuni attributi, ad esempio `active` |
| `PUT` | `/Users/{id}` | Sostituisce gli attributi di un utente |

I gruppi e `DELETE` non sono supportati. Per togliere l'accesso a qualcuno, imposta `active` su `false`, che è ciò che la maggior parte degli identity provider invia quando rimuovi l'assegnazione di un utente.

Un utente creato tramite SCIM si unisce al tuo team con il ruolo di **membro** (Member). Se l'e-mail appartiene già a un account AhaSlides che non è in un team, quell'account viene aggiunto al tuo team invece di crearne uno nuovo.

### Cosa cambia nella pagina del tuo team

Finché SCIM è attivo, il tuo identity provider è il posto in cui gestire l'appartenenza al team. Nella pagina del team il pulsante **Invita** (Invite) non compare più, e i membri non possono modificare il proprio indirizzo e-mail nelle impostazioni dell'account.

## Risoluzione dei problemi di SSO e SCIM

### Il test di connessione SCIM restituisce 401

Il token manca, è scritto male o non è più attivo. Controlla che venga inviato come bearer token senza nulla aggiunto intorno. Se continua a non funzionare, chiedici un nuovo token.

### Il nome di un membro creato tramite provisioning è sbagliato o vuoto

Invia `name.givenName` e `name.familyName`. Quando viene inviato solo `displayName`, AhaSlides lo divide al primo spazio, il che sistema male i nomi con più di due parti.

### Un membro non riesce ad accedere con SSO

Controlla che il membro sia assegnato all'app AhaSlides nel tuo identity provider e che il suo dominio e-mail sia uno di quelli che ci hai chiesto di collegare. Se hai aggiunto un nuovo dominio, dicci quale, così possiamo collegarlo.

## Domande frequenti

<AccordionGroup>
  <Accordion title="Un dominio e-mail può essere collegato a due team?">
    No. Ogni dominio appartiene a un solo team, quindi tutti i membri di quel dominio accedono allo stesso team.
  </Accordion>

  <Accordion title="SCIM elimina gli account AhaSlides?">
    No. SCIM disattiva un account e disconnette il membro. Le sue presentazioni restano nell'account.
  </Accordion>

  <Accordion title="Uso l'SSO e ho dimenticato la password. Cosa faccio?">
    Non hai una password AhaSlides da reimpostare. Accedi con **Accedi con SSO** (Log in with SSO) e consulta [Cambiare o reimpostare la password](/it/account-management/change-or-reset-your-password) per sapere come la reimpostazione della password tratta gli account SSO.
  </Accordion>
</AccordionGroup>

**Hai una domanda?**

Contatta il nostro team di assistenza: se hai effettuato l'accesso, usa l'icona della chat in basso a destra nella dashboard; altrimenti [contattaci qui](https://ahaslides.com/contact-us/) o scrivi a [hi@ahaslides.com](mailto:hi@ahaslides.com).

Vuoi entrare in contatto con altri utenti? Unisciti alla [community di AhaSlides](https://community.ahaslides.com/) per condividere consigli, richiedere nuove funzionalità e scoprire come gli altri coinvolgono il loro pubblico.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.