# Lizenzverwaltung

## Lizenz- & Berechtigungsverwaltung

Damit Benutzer Avonni-Komponenten anzeigen und mit ihnen interagieren können, insbesondere auf Experience Cloud-Seiten, müssen Sie einen zweistufigen Konfigurationsprozess abschließen.

<mark style="color:Standard;background-color:orange;">**⚠️ Konfigurationsanforderung:**</mark> Damit ein Benutzer erfolgreich auf Avonni-Komponenten zugreifen kann, müssen Sie BEIDES zuweisen:

1. **Eine Paketlizenz** (Weist dem Benutzer einen Sitzplatz zu).
2. **Ein Berechtigungsset** (Erteilt technischen Zugriff auf die Komponenten).

{% hint style="warning" %}

#### Wichtig

Wenn ein Benutzer eine Lizenz, aber kein Berechtigungsset hat (oder umgekehrt), werden die Komponenten nicht geladen und der Benutzer sieht eine Fehlermeldung.
{% endhint %}

***

## Schritt 1: Paketlizenzen zuweisen

Die Paketlizenz gewährt dem Benutzer das grundlegende Recht, die Software innerhalb von Salesforce zu verwenden.

Lizenzverfügbarkeit:

* Produktion: Enthält 10 Freemium-Lizenzen.
* Sandbox: Enthält eine Site-Lizenz (unbegrenzte Benutzer/keine Ablaufzeit).

So weisen Sie zu:

1. Navigieren Sie zu **Setup**.
2. Suchen Sie nach und wählen Sie **Installierte Pakete**.
3. Suchen Sie **Avonni Experience Components** und klicken Sie **Lizenzen verwalten**.
4. Klicken Sie **Benutzer hinzufügen**.
5. Wählen Sie alle Benutzer aus, die Zugriff benötigen, und klicken Sie **Speichern**.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FBDKTTwhvu3t0ImAOVjkx%2Fimage%20-%202025-12-11T152901.759.avif?alt=media&#x26;token=1f2777ff-1066-4ff9-86e8-ef42eaea5d0b" alt=""><figcaption></figcaption></figure>

***

## Schritt 2: Berechtigungssets zuweisen

Sobald die Lizenz zugewiesen ist, müssen Sie das richtige Berechtigungsset basierend auf der Rolle des Benutzers zuweisen. Das Avonni-Paket enthält drei verschiedene Berechtigungssets.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FTGmfthAFHbjNRuCBeb9j%2Fimage%20-%202025-12-11T152644.009.avif?alt=media&#x26;token=6728ac59-3b3c-435f-8740-0ae500aa4d4c" alt=""><figcaption></figcaption></figure>

Wählen Sie das richtige Berechtigungsset für Ihren Benutzer:

| Rolle                                                                                       | Name des Berechtigungssets              | Funktion                                                                                                                                                         |
| ------------------------------------------------------------------------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Endbenutzer</strong></p><p><strong>(Experience Cloud & App Builder)</strong></p> | Avonni Experience Cloud Components User | Erforderlich für Benutzer, die Komponenten auf Experience-Sites oder auf Standardseiten des Lightning App Builders anzeigen.                                     |
| <p><strong>Endbenutzer</strong></p><p><strong>(Dynamische Komponenten)</strong></p>         | Avonni Dynamic Components User          | Erforderlich für Benutzer, die mit dynamischen Komponenten (z. B. benutzerdefinierte Datentabellen, Aktionsschaltflächen) innerhalb von Salesforce interagieren. |
| **Administratoren & Entwickler**                                                            | Avonni Experiences Admin                | Erforderlich für Benutzer, die Layouts mit dem Avonni Component Builder erstellen, bearbeiten oder gestalten müssen.                                             |

So weisen Sie zu:

1. Navigieren Sie zu **Setup** > **Berechtigungssets**.
2. Wählen Sie das passende Berechtigungsset aus der obigen Tabelle.
3. Klicken Sie **Zuweisungen verwalten** > **Zuweisung hinzufügen**.
4. Wählen Sie die Benutzer aus, denen Sie in Schritt 1 Lizenzen zugewiesen haben.
5. Klicken Sie **Zuweisen**.

***

## Konfiguration für Gastbenutzer

Gastbenutzer (nicht authentifizierte Besucher auf öffentlichen Seiten) benötigen keine Standard-Paketlizenz, benötigen jedoch Berechtigungen.

{% hint style="warning" %}

#### Hinweis

Der Gastbenutzerzugriff für Produktionsumgebungen ist ein Zusatzfeature. Bitte [kontaktieren Sie den Support](mailto:support@avonni.app) für Details.
{% endhint %}

Um den Gastzugriff zu aktivieren:

1. Öffnen Sie Ihre Experience Cloud-Site im Builder.
2. Gehen Sie zu Einstellungen > Allgemein und klicken Sie auf den Link zum Gastbenutzerprofil.
3. Scrollen Sie in den Profileinstellungen zu Berechtigungsset-Zuweisungen.
4. Fügen Sie dem Profil das Berechtigungsset Avonni Experience Cloud Components hinzu.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F6yGKn0t0cQmnKmvKYcrY%2Fimage%20-%202025-12-11T152750.122.avif?alt=media&#x26;token=32ad5907-e2f6-43fc-a706-03cd5422d86f" alt=""><figcaption></figcaption></figure>

#### Fehlerbehebung bei Zugriffsproblemen

Wenn ein Benutzer den Fehler meldet *"Sie haben keinen Zugriff auf diese Avonni-Komponente,"* prüfen Sie Folgendes:

| Problem                   | Lösung                                                                                                                                                                           |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fehlende Lizenz**       | Stellen Sie sicher, dass der Benutzer aufgeführt ist in *Installierte Pakete > Lizenzen verwalten*.                                                                              |
| **Fehlende Berechtigung** | Stellen Sie sicher, dass dem Benutzer das *Avonni Experience Cloud Components* Berechtigungsset zugewiesen ist.                                                                  |
| **LWS deaktiviert**       | Stellen Sie sicher, dass [*Lightning Web Security* in Setup aktiviert ist](https://developer.salesforce.com/docs/platform/lightning-components-security/guide/lws-enable.html) . |