> 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-de/erste-schritte/license-management.md).

# Lizenzverwaltung

## Lizenz- und Berechtigungsverwaltung

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

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

1. **Eine Paketlizenz** (Weist dem Benutzer eine Lizenz zu).
2. **Ein Berechtigungssatz** (Gewährt technischen Zugriff auf die Komponenten).

{% hint style="warning" %}

#### Wichtig

Wenn ein Benutzer eine Lizenz, aber keinen Berechtigungssatz 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/kein Ablaufdatum).

### Wie viele Lizenzen benötigen Sie?

Weisen Sie jedem Benutzer, der sich auf der Site anmelden muss, eine Avonni-Lizenz zu. Es gibt nichts zu berechnen.

Dies gilt auch dann, wenn Ihre Salesforce Experience Cloud-Lizenzen login-basiert sind. Avonni-Lizenzen werden nicht gegen Logins, Sitzungen oder die Besuchshäufigkeit angerechnet, daher können Sie sie nicht anhand des erwarteten Traffics dimensionieren. Entscheidend ist die Anzahl der Benutzer, die die Lizenz in Ihrer Organisation besitzen.

Der Grund ist eine Plattformbeschränkung und keine Entscheidung unsererseits: Salesforce teilt uns nicht mit, ob sich ein login-basierter Benutzer tatsächlich mit einer Site verbunden hat, daher gibt es keine Nutzung, die gemessen werden könnte. Wenn Sie jedem Benutzer, der sich anmelden kann, eine Lizenz zuweisen, verhindern Sie, dass einer von ihnen auf einen Zugriffsfehler stößt.

Um Ihren aktuellen Stand zu sehen, öffnen Sie **Setup** > **Installierte Pakete**, suchen Sie **Avonni Experience Components** und klicken Sie auf **Lizenzen verwalten**. Die Seite listet die Benutzer auf, die eine Lizenz besitzen, und zeigt, wie viele Ihrer Lizenzen verwendet werden.

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 auf **Lizenzen verwalten**.
4. Klick **Benutzer hinzufügen**.
5. Wählen Sie alle Benutzer aus, die Zugriff benötigen, und klicken Sie auf **Speichern**.

<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>

***

## Schritt 2: Berechtigungssätze zuweisen

Sobald die Lizenz zugewiesen ist, müssen Sie basierend auf der Rolle des Benutzers den richtigen Berechtigungssatz zuweisen. Das Avonni-Paket enthält drei verschiedene Berechtigungssätze.

<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>

Wählen Sie den richtigen Berechtigungssatz für Ihren Benutzer aus:

| Rolle                                                                                       | Name des Berechtigungssatzes                | Funktion                                                                                                                                                    |
| ------------------------------------------------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Endbenutzer</strong></p><p><strong>(Experience Cloud & App Builder)</strong></p> | Avonni Experience Cloud Components-Benutzer | Erforderlich für Benutzer, die Komponenten auf Experience Sites oder standardmäßigen Lightning App Builder-Seiten anzeigen.                                 |
| <p><strong>Endbenutzer</strong></p><p><strong>(Dynamic Components)</strong></p>             | Avonni Dynamic Components-Benutzer          | Erforderlich für Benutzer, die innerhalb von Salesforce mit Dynamic Components interagieren (z. B. benutzerdefinierte Datentabellen, Aktionsschaltflächen). |
| **Administratoren & Ersteller**                                                             | Avonni Experiences-Administrator            | Erforderlich für Benutzer, die mit dem Avonni Component Builder Layouts erstellen, bearbeiten oder aufbauen müssen.                                         |

So weisen Sie zu:

1. Navigieren Sie zu **Setup** > **Berechtigungssätze**.
2. Wählen Sie den passenden Berechtigungssatz aus der obigen Tabelle aus.
3. Klick **Zuweisungen verwalten** > **Zuweisung hinzufügen**.
4. Wählen Sie die Benutzer aus, denen Sie in Schritt 1 Lizenzen zugewiesen haben.
5. Klick **Zuweisen**.

***

## Konfiguration für Gastbenutzer

Gastbenutzer (nicht authentifizierte Besucher auf öffentlichen Sites) benötigen keine Standard-Paketlizenz, aber sie benötigen Berechtigungen.

{% hint style="warning" %}

#### Hinweis

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

So aktivieren Sie den Gastzugriff:

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 Berechtigungssatz-Zuweisungen.
4. Fügen Sie dem Profil den Berechtigungssatz Avonni Experience Cloud Components hinzu.

<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>

#### 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 unter *Installierte Pakete > Lizenzen verwalten*.                                                                                    |
| **Fehlende Berechtigung** | Stellen Sie sicher, dass dem Benutzer der *Avonni Experience Cloud Components* Berechtigungssatz zugewiesen ist.                                                                          |
| **LWS deaktiviert**       | Stellen Sie sicher, dass [*Lightning Web Security* aktiviert ist](https://developer.salesforce.com/docs/platform/lightning-components-security/guide/lws-enable.html) in der Einrichtung. |


---

# 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-de/erste-schritte/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.