# Gestion des licences

## Gestion des licences et des autorisations

Pour permettre aux utilisateurs de visualiser et d'interagir avec les composants Avonni, en particulier sur les sites Experience Cloud, vous devez effectuer un processus de configuration en deux étapes.

<mark style="color:par défaut;background-color:orange;">**⚠️ Exigence de configuration :**</mark> Pour qu'un utilisateur puisse accéder aux composants Avonni, vous devez attribuer LES DEUX éléments suivants :

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

{% hint style="warning" %}

#### Important

Si un utilisateur a une licence mais pas de jeu 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 : Comprend 10 licences Freemium.
* Sandbox : Comprend une licence de site (utilisateurs illimités / sans expiration).

Comment attribuer :

1. Accédez à **Configuration**.
2. Recherchez et sélectionnez **Packages installés**.
3. Localisez **Avonni Experience Components** et cliquez sur **Gérer les licences**.
4. Cliquez sur **Ajouter des utilisateurs**.
5. Sélectionnez tous les utilisateurs qui nécessitent l'accès et cliquez sur **Enregistrer**.

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

***

## Étape 2 : Attribuer les jeux d'autorisations

Une fois la licence attribuée, vous devez attribuer le bon jeu d'autorisations en fonction du rôle de l'utilisateur. Le package Avonni inclut trois jeux d'autorisations distincts.

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

Choisissez le jeu d'autorisations approprié pour votre utilisateur :

| Rôle                                                                                                 | Nom du jeu d'autorisations              | Fonction                                                                                                                                                              |
| ---------------------------------------------------------------------------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Utilisateurs finaux</strong></p><p><strong>(Experience Cloud et App Builder)</strong></p> | Avonni Experience Cloud Components User | Requis pour les utilisateurs visualisant des composants sur les sites Experience ou les pages standard de Lightning App Builder.                                      |
| <p><strong>Utilisateurs finaux</strong></p><p><strong>(Composants dynamiques)</strong></p>           | Avonni Dynamic Components User          | Requis pour les utilisateurs interagissant avec les composants dynamiques (par ex., tableaux de données personnalisés, boutons d'action) à l'intérieur de Salesforce. |
| **Administrateurs et concepteurs**                                                                   | Avonni Experiences Admin                | Requis pour les utilisateurs qui doivent créer, modifier ou concevoir des mises en page à l'aide du constructeur de composants Avonni.                                |

Comment attribuer :

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

***

## Configuration pour les utilisateurs invités

Les utilisateurs invités (visiteurs non authentifiés sur des 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é supplémentaire. Veuillez [contacter le support](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. Allez dans 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'à Attributions de jeux d'autorisations.
4. Ajoutez le jeu d'autorisations Avonni Experience Cloud Components au profil.

<figure><img src="/files/63819ea89de7a57965aabd78f28e5261b0da109e" 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 éléments suivants :

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


---

# Agent Instructions: 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:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/prise-en-main/gestion-des-licences.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
