> 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-fr/premiers-pas/license-management.md).

# Gestion des licences

## Gestion des licences et des autorisations

Pour garantir que les utilisateurs peuvent consulter et interagir avec les composants Avonni, en particulier sur les sites Experience Cloud, vous devez effectuer une configuration en deux étapes.

<mark style="background-color:orange;">**⚠️ Exigence de configuration :**</mark> Pour qu'un utilisateur accède correctement aux composants Avonni, vous devez attribuer LES DEUX :

1. **Une licence de package** (Attribue un poste à l'utilisateur).
2. **Un ensemble d'autorisations** (Accorde un accès technique aux composants).

{% hint style="warning" %}

#### Important

Si un utilisateur dispose d'une licence mais d'aucun ensemble d'autorisations (ou inversement), les composants ne se chargeront pas et l'utilisateur verra un message d'erreur.
{% endhint %}

***

## Étape 1 : attribuer les licences de package

La licence de package accorde à l'utilisateur le droit fondamental d'utiliser le logiciel dans Salesforce.

Disponibilité des licences :

* Production : inclut 10 licences Freemium.
* Sandbox : inclut une licence de site (utilisateurs illimités / sans expiration).

### De combien de licences avez-vous besoin ?

Attribuez une licence Avonni à chaque utilisateur qui doit se connecter au site. Il n'y a rien à calculer.

Cela reste vrai lorsque vos licences Salesforce Experience Cloud sont basées sur la connexion. Les postes Avonni ne sont pas comptabilisés en fonction des connexions, des sessions ou de la fréquence des visites ; vous ne pouvez donc pas les dimensionner à partir du trafic attendu. Le nombre qui compte est celui des utilisateurs qui détiennent la licence dans votre organisation.

La raison est une limite de la plateforme, et non un choix de notre part : Salesforce ne nous indique pas si un utilisateur basé sur la connexion s'est réellement connecté à un site, donc il n'y a aucune utilisation à mesurer. Attribuer une licence à chaque utilisateur pouvant se connecter est ce qui évite à chacun d'entre eux de rencontrer une erreur d'accès.

Pour voir votre situation actuelle, ouvrez **Configuration** > **Packages installés**, recherchez **Avonni Experience Components** et cliquez sur **Gérer les licences**. La page répertorie les utilisateurs qui détiennent une licence et le nombre de licences utilisées.

Comment attribuer :

1. Accédez à **Configuration**.
2. Recherchez et sélectionnez **Packages installés**.
3. Repérez **Avonni Experience Components** et cliquez sur **Gérer les licences**.
4. Clic **Ajouter des utilisateurs**.
5. Sélectionnez tous les utilisateurs qui ont besoin d'un accès et cliquez sur **Enregistrer**.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-78db93c54f54bde5ab1b0194266b15eab2ee9df7%2Fimage%20-%202025-12-11T152901.759.avif?alt=media" alt=""><figcaption></figcaption></figure>

***

## Étape 2 : attribuer des ensembles d'autorisations

Une fois la licence attribuée, vous devez attribuer l'ensemble d'autorisations approprié en fonction du rôle de l'utilisateur. Le package Avonni comprend trois ensembles d'autorisations distincts.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-0a00c03a72b97827756d452f5a243caf1cec5ac1%2Fimage%20-%202025-12-11T152644.009.avif?alt=media" alt=""><figcaption></figcaption></figure>

Choisissez l'ensemble d'autorisations approprié pour votre utilisateur :

| Rôle                                                                                                 | Nom de l'ensemble d'autorisations                  | Fonction                                                                                                                                                             |
| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Utilisateurs finaux</strong></p><p><strong>(Experience Cloud et App Builder)</strong></p> | Utilisateur des composants Avonni Experience Cloud | Requis pour les utilisateurs qui consultent des composants sur des sites Experience ou sur des pages standard de Lightning App Builder.                              |
| <p><strong>Utilisateurs finaux</strong></p><p><strong>(Composants dynamiques)</strong></p>           | Utilisateur des composants dynamiques Avonni       | Requis pour les utilisateurs interagissant avec les composants dynamiques (par exemple, des tables de données personnalisées, des boutons d'action) dans Salesforce. |
| **Administrateurs et créateurs**                                                                     | Administrateur Avonni Experiences                  | Requis pour les utilisateurs qui doivent créer, modifier ou concevoir des mises en page à l'aide du générateur de composants Avonni.                                 |

Comment attribuer :

1. Accédez à **Configuration** > **Ensembles d'autorisations**.
2. Sélectionnez l'ensemble d'autorisations approprié dans le tableau ci-dessus.
3. Clic **Gérer les attributions** > **Ajouter une attribution**.
4. Sélectionnez les utilisateurs auxquels vous avez attribué des licences à l'étape 1.
5. Clic **Attribuer**.

***

## Configuration pour les utilisateurs invités

Les utilisateurs invités (visiteurs non authentifiés sur les sites publics) n'ont pas besoin d'une licence de package standard, mais ils ont besoin d'autorisations.

{% hint style="warning" %}

#### Remarque

L'accès des utilisateurs invités pour les environnements de production est une fonctionnalité complémentaire. Veuillez [contacter l'assistance](mailto:support@avonni.app) pour plus de détails.
{% endhint %}

Pour activer l'accès invité :

1. Ouvrez votre site Experience Cloud dans Builder.
2. Accédez à Paramètres > Général et cliquez sur le lien vers le profil de l'utilisateur invité.
3. Dans les paramètres du profil, faites défiler jusqu'à Affectations d'ensembles d'autorisations.
4. Ajoutez l'ensemble d'autorisations Avonni Experience Cloud Components au profil.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-9b4cc640c218ad835c496ceb0530c3dbfdfa9bec%2Fimage%20-%202025-12-11T152750.122.avif?alt=media" alt=""><figcaption></figcaption></figure>

#### Résolution des problèmes d'accès

Si un utilisateur signale l'erreur *"Vous n'avez pas accès à ce composant Avonni,"* vérifiez les points suivants :

| Problème                   | Solution                                                                                                                                                                          |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Licence manquante**      | Assurez-vous que l'utilisateur est répertorié dans *Packages installés > Gérer les licences*.                                                                                     |
| **Autorisation manquante** | Assurez-vous que l'utilisateur dispose de *Avonni Experience Cloud Components* l'ensemble d'autorisations attribué.                                                               |
| **LWS désactivé**          | Assurez-vous que [*Lightning Web Security* est activé](https://developer.salesforce.com/docs/platform/lightning-components-security/guide/lws-enable.html) dans la configuration. |


---

# 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-fr/premiers-pas/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.