> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md).
# SSO für eine impact.com-Microsite über JWT einrichten
Ihr Microwebsite-Programm „Advocate“ erfordert in der Regel, dass sich Ihre Kundenbefürworter mit einem Benutzernamen und einem Passwort anmelden, bevor sie auf ihre Freigabelinks und Prämiendetails zugreifen können. Als fortgeschrittene Alternative können Sie Benutzer jedoch stattdessen authentifizieren, indem Sie ein [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) serverseitig generieren und ihn über einen URL-Parameter an die Microwebsite übergeben.
Mit dieser Methode verfügen die Teilnehmer nicht über Anmeldedaten für die Microwebsite. Stattdessen erhalten sie Zugriff, indem sie sich in Ihr bestehendes Kundenportal einloggen, das sie dann mithilfe des JWT zur Microwebsite weiterleitet, um sie zu identifizieren und ihre personalisierten Inhalte anzuzeigen.
#### Bevor Sie beginnen
{% hint style="warning" %}
**Wichtig:** Dies ist eine fortgeschrittene Implementierung, die den standardmäßigen Managed Identity Service für die Microwebsite umgeht und bei der Einrichtung Unterstützung durch Ihr Entwicklerteam erfordert.
{% endhint %}
Sie sollten diese Methode nur verwenden, wenn alle der folgenden Punkte zutreffen:
* Sie möchten ein Single-Sign-on-(SSO)-Erlebnis simulieren, indem Sie die Teilnehmer automatisch in der Microwebsite Ihres Programms anmelden.
* Sie können JWTs serverseitig generieren.
* Sie können das nicht installieren oder möchten es nicht installieren [Universal Tracking Tag (UTT)](/brand/de/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) auf Ihrer Website.
{% stepper %}
{% step %}
#### Schritt 1: Erstellen Sie eine Microwebsite ohne verwaltete Identität
Wenn Sie Ihre Microwebsite erstellen, müssen Sie den Managed Identity Service deaktivieren und dann alle Ihre Seiten so einstellen, dass sie für „unverifizierte“ Benutzer zugänglich sind. Die *Dashboard* Seite verwendet das JWT, um den Benutzer zu authentifizieren und die Microwebsite zu laden.
Microwebsite erstellen
Passen Sie zunächst die Einstellungen an, um den *Teilnehmer-Login* Option.
1. Wählen Sie im linken Navigationsmenü  **\[Engage]** **→ Inhalt**.
2. Auf dem *Microsite* Karte auswählen **Einstellungen bearbeiten**.
3. Anschließend werden Sie zu Ihren neuen *Microwebsite-Einstellungen* Seite.
4. Im *Anmeldung* Abschnitt, .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Deaktivieren]** **Teilnehmer-Login**.
5. Wählen Sie **Einstellungen speichern**.
Dashboard-Seite konfigurieren
Konfigurieren Sie als Nächstes die *Dashboard* Seite so, dass sie für unverifizierte Benutzer sichtbar ist. Verbinden Sie dann die Komponenten auf der Seite mit Ihrem Empfehlungsprogramm, damit die richtigen Informationen angezeigt werden.
1. Passen Sie die *Dashboard* Seiteneinstellungen an.
* Wählen Sie im linken Navigationsmenü  **\[Engage]** **→ Inhalt** → **Inhalte einrichten** oder **Inhalte bearbeiten**.
* Von der *Microsite* Registerkarte, wählen Sie **Dashboard** im *Layout für angemeldete Teilnehmende* Bereich auswählen.
* Wählen Sie  **\[Menü] → Einstellungen**.
* Von der *Zugelassene Benutzer* in der Dropdown-Liste auswählen **Unverifiziert**.
2. Fügen Sie die Programm-ID zu den Komponenten auf der *Dashboard*.
* Benutzerstatistiken — Sie müssen die ID zu jeder einzelnen Benutzerstatistik hinzufügen, die Sie anzeigen möchten.
* Share-Link
* Empfehlungscode
* Social-Media-Buttons — Sie müssen die ID zu jeder einzelnen Social-Media-Teilen-Schaltfläche hinzufügen, die Sie einfügen möchten.
3. Wählen Sie in der oberen rechten Ecke **Speichern**.
Wenn Sie Hilfe dabei benötigen, mit dem Editor Ihre Seiten- und Komponenteneinstellungen zu finden und anzupassen, wenden Sie sich an [Microsite-Editor erklärt](/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) und [Microwebsite-Layouts und -Seiten anpassen](/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
Nicht benötigte Seiten entfernen
Entfernen Sie das Layout und die Seiten, die Ihre Microwebsite nicht verwendet.
1. Bewegen Sie den Mauszeiger über die Seite oder das Layout.
2. Wählen Sie  **\[Mehr]** **→ Löschen**.
3. Entfernen Sie die *Layout für angemeldete Teilnehmende*.
4. Entfernen Sie die folgenden Seiten:
* Profil bearbeiten
* E-Mail-Verifizierung
* Passwort vergessen
* Anmeldung
* Abmelden
* Registrieren
* Passwort zurücksetzen
* E-Mail bestätigen
{% endstep %}
{% step %}
#### Schritt 2: Generieren Sie das JWT
Die JWT-Struktur entspricht den standardmäßigen Advocate-Anforderungen für die Benutzerauthentifizierung. Wenn Sie Advocate bereits integriert haben, generieren Sie wahrscheinlich schon ähnliche Tokens für UTT.
Sie müssen das JWT sicher auf Ihrem Server oder einem vertrauenswürdigen Backend-System generieren – niemals im Browser.
Erfahren Sie, wie Sie [JWT generieren und die Payload-Anforderungen](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}
{% step %}
#### Schritt 3: Hängen Sie das JWT an die URL der Microwebsite an
Sobald der Benutzer auf Ihrer Plattform angemeldet ist, leiten Sie ihn mit dem JWT im Query-String der URL zur Microwebsite weiter.
{% hint style="info" %}
**Beispiel:** `https://your-microsite.squatch.app/?jwt=`
{% endhint %}
Sie können die Microwebsite entweder in einem neuen Browser-Tab öffnen oder sie mithilfe eines iFrames in Ihre App einbetten. Wenn Sie sich dafür entscheiden, die Microwebsite einzubetten, stellen Sie sicher, dass Sie [Cross-Origin Resource Sharing (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) und die Browser-Einschränkungen angemessen berücksichtigen.
{% endstep %}
{% endstepper %}
#### Hinweise
* Wenn Sie diese Authentifizierungsmethode verwenden, haben Benutzer keine Anmeldedaten für die Microwebsite.
* Der auf JWT basierende Zugriff muss streng kontrolliert werden. Machen Sie ihn nicht in clientseitigem JavaScript zugänglich und manipulieren Sie ihn nicht darin.
* Dies ist ein nicht standardmäßiger Ansatz – testen Sie ihn gründlich in Ihrer Staging-Umgebung, bevor Sie Ihr Programm ausrollen.
* Wenn Sie Hilfe benötigen [Support](mailto:saasquatch-support@impact.com), fügen Sie Ihrer Support-Anfrage Ihre Microwebsite-URL, Implementierungsdetails und eine Beispiel-JWT-Payload hinzu.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
