> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-it/per-iniziare/license-management.md).

# Gestione licenze

## Gestione licenze e autorizzazioni

Per garantire che gli utenti possano visualizzare e interagire con i Componenti Avonni, in particolare nei siti Experience Cloud, è necessario completare un processo di configurazione in due passaggi.

<mark style="background-color:orange;">**⚠️ Requisito di configurazione:**</mark> Affinché un utente possa accedere correttamente ai Componenti Avonni, devi assegnare ENTRAMBI:

1. **Una licenza del pacchetto** (Assegna una postazione all'utente).
2. **Un set di autorizzazioni** (Concede l'accesso tecnico ai componenti).

{% hint style="warning" %}

#### Importante

Se un utente ha una licenza ma non un set di autorizzazioni (o viceversa), i componenti non verranno caricati e l'utente visualizzerà un messaggio di errore.
{% endhint %}

***

## Passaggio 1: assegnare le licenze del pacchetto

La licenza del pacchetto garantisce all'utente il diritto fondamentale di utilizzare il software all'interno di Salesforce.

Disponibilità licenze:

* Produzione: include 10 licenze Freemium.
* Sandbox: include una licenza sito (utenti illimitati/Nessuna scadenza).

Come assegnare:

1. Vai a **Setup**.
2. Cerca e seleziona **Pacchetti installati**.
3. Individua **Avonni Experience Components** e fai clic su **Gestisci licenze**.
4. Clic **Aggiungi utenti**.
5. Seleziona tutti gli utenti che necessitano dell'accesso e fai clic su **Salva**.

<figure><img src="/files/e8c5fbed30c4f394b5d059586bc4d560d1f11d2d" alt=""><figcaption></figcaption></figure>

***

## Passaggio 2: assegnare i set di autorizzazioni

Una volta assegnata la licenza, devi assegnare il set di autorizzazioni corretto in base al ruolo dell'utente. Il pacchetto Avonni include tre set di autorizzazioni distinti.

<figure><img src="/files/7bfcf6e427d3a9988002d0a1d5059d0d5f420fca" alt=""><figcaption></figcaption></figure>

Scegli il set di autorizzazioni corretto per il tuo utente:

| Ruolo                                                                                         | Nome del set di autorizzazioni            | Funzione                                                                                                                                                  |
| --------------------------------------------------------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Utenti finali</strong></p><p><strong>(Experience Cloud e App Builder)</strong></p> | Utente Avonni Experience Cloud Components | Necessario per gli utenti che visualizzano i componenti su siti Experience o pagine standard di Lightning App Builder.                                    |
| <p><strong>Utenti finali</strong></p><p><strong>(Componenti dinamici)</strong></p>            | Utente Avonni Dynamic Components          | Necessario per gli utenti che interagiscono con i Componenti dinamici (ad es. tabelle dati personalizzate, pulsanti di azione) all'interno di Salesforce. |
| **Amministratori e builder**                                                                  | Amministratore Avonni Experiences         | Necessario per gli utenti che devono creare, modificare o costruire layout utilizzando l'Avonni Component Builder.                                        |

Come assegnare:

1. Vai a **Setup** > **Set di autorizzazioni**.
2. Seleziona il set di autorizzazioni appropriato dalla tabella sopra.
3. Clic **Gestisci assegnazioni** > **Aggiungi assegnazione**.
4. Seleziona gli utenti a cui hai assegnato le licenze nel passaggio 1.
5. Clic **Assegna**.

***

## Configurazione per utenti guest

Gli utenti guest (visitatori non autenticati sui siti pubblici) non richiedono una licenza del pacchetto standard, ma richiedono autorizzazioni.

{% hint style="warning" %}

#### Nota

L'accesso degli utenti guest per gli ambienti di produzione è una funzione aggiuntiva. Per favore [contatta il supporto](mailto:support@avonni.app) per i dettagli.
{% endhint %}

Per abilitare l'accesso guest:

1. Apri il tuo sito Experience Cloud nel Builder.
2. Vai a Impostazioni > Generale e fai clic sul link al profilo dell'utente guest.
3. Nelle impostazioni del profilo, scorri fino a Assegnazioni set di autorizzazioni.
4. Aggiungi il set di autorizzazioni Avonni Experience Cloud Components al profilo.

<figure><img src="/files/f921b3eec4d94ecf754bf52fabb30f3fed9ea5c4" alt=""><figcaption></figcaption></figure>

#### Risoluzione dei problemi di accesso

Se un utente segnala l'errore *"Non hai accesso a questo componente Avonni,"* controlla quanto segue:

| Problema                    | Soluzione                                                                                                                                                         |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Licenza mancante**        | Assicurati che l'utente sia elencato in *Pacchetti installati > Gestisci licenze*.                                                                                |
| **Autorizzazione mancante** | Assicurati che all'utente sia assegnato il *Avonni Experience Cloud Components* set di autorizzazioni.                                                            |
| **LWS disattivato**         | Assicurati [*Lightning Web Security* sia abilitato](https://developer.salesforce.com/docs/platform/lightning-components-security/guide/lws-enable.html) in Setup. |


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-it/per-iniziare/license-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
