> 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 per JWT einrichten
Die Microsite Ihres Advocate-Programms erfordert in der Regel, dass sich Ihre Kundenbefürworter mit einem Benutzernamen und Passwort registrieren, bevor sie auf ihre Freigabelinks und Prämiendetails zugreifen können. Als fortgeschrittene Alternative können Sie Benutzer jedoch stattdessen authentifizieren, indem Sie serverseitig ein [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) generieren und es über einen URL-Parameter an die Microsite übergeben.
Mit dieser Methode verfügen die Teilnehmer nicht über Anmeldedaten für die Microsite. Stattdessen erhalten sie Zugriff, indem sie sich in Ihr bestehendes Kundenportal anmelden, das sie dann mithilfe des JWT zur Identifizierung und Anzeige ihrer personalisierten Inhalte an die Microsite weiterleitet.
#### Bevor Sie beginnen
{% hint style="warning" %}
**Wichtig:** Dies ist eine fortgeschrittene Implementierung, die den Standarddienst für verwaltete Identität der Microsite umgeht und Unterstützung durch Ihr Entwicklungsteam zur Einrichtung erfordert.
{% endhint %}
Sie sollten diese Methode nur verwenden, wenn alle folgenden Punkte zutreffen:
* Sie möchten eine Single-Sign-On-(SSO)-Erfahrung simulieren, indem Sie Teilnehmer automatisch bei der Microsite Ihres Programms anmelden.
* Sie können JWTs serverseitig generieren.
* Sie können den [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) nicht auf Ihrer Website installieren oder möchten es nicht.
{% stepper %}
{% step %}
#### Schritt 1: Erstellen Sie eine Microsite ohne verwaltete Identität
Wenn Sie Ihre Microsite erstellen, müssen Sie den Managed Identity Service deaktivieren und dann alle Ihre Seiten so einstellen, dass sie für „nicht verifizierte“ Benutzer zugänglich sind. Die *Dashboard* Seite verwendet das JWT, um den Benutzer zu authentifizieren und die Microsite zu laden.
Microsite erstellen
Passen Sie zunächst die Einstellungen an, um die *Teilnehmer-Login* Option zu deaktivieren.
1. Wählen Sie im linken Navigationsmenü  **\[Engage]** **→ Inhalt**.
2. Auf der *Microsite* Karte, wählen Sie **Einstellungen bearbeiten**.
3. Sie werden dann zu Ihren neuen *Microsite-Einstellungen* Seite.
4. Innerhalb des *Anmeldung* Bereich,  **\[Ausschalten]** **Teilnehmer-Login**.
5. Wählen Sie **Einstellungen speichern**.
Dashboard-Seite konfigurieren
Konfigurieren Sie als Nächstes die *Dashboard* Seite Ihrer Microsite so, dass sie für nicht verifizierte 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 Ihrer Website an.
* Wählen Sie im linken Navigationsmenü  **\[Engage]** **→ Inhalt** → **Einrichtungsinhalte** oder **Inhalt bearbeiten**.
* In der *Microsite* Registerkarte, wählen Sie **Dashboard** in das *Layout für angemeldete Nutzer* .
* Wählen Sie  **\[Menü] → Einstellungen**.
* In der *Zulässige Benutzer* Dropdown-Liste, wählen Sie **Nicht verifiziert**.
2. Fügen Sie Ihre 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
* Schaltflächen für soziale Medien — Sie müssen die ID zu jeder einzelnen Schaltfläche zum Teilen in sozialen Medien hinzufügen, die Sie einbeziehen möchten.
3. Wählen Sie oben rechts **Speichern**.
Hilfe bei der Verwendung des Editors zum Finden und Anpassen Ihrer Seiten- und Komponenteneinstellungen finden Sie unter [Der 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 [Microsite-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 Microsite nicht verwenden wird.
1. Bewegen Sie den Cursor über die Seite oder das Layout.
2. Wählen Sie  **\[Mehr]** **→ Löschen**.
3. Entfernen Sie die *Layout für angemeldete Nutzer*.
4. Entfernen Sie die folgenden Seiten:
* Profil bearbeiten
* E-Mail-Verifizierung
* Passwort vergessen
* Anmeldung
* Abmelden
* Registrierung
* Passwort zurücksetzen
* E-Mail verifizieren
{% endstep %}
{% step %}
#### Schritt 2: Das JWT generieren
Die JWT-Struktur folgt 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 anderen vertrauenswürdigen Backendsystem generieren — niemals im Browser.
Erfahren Sie, wie Sie [ein JWT und die Anforderungen an die Payload generieren](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}
{% step %}
#### Schritt 3: Das JWT an die URL der Microsite anhängen
Sobald der Benutzer in Ihrer Plattform angemeldet ist, leiten Sie ihn mit dem JWT in der URL-Query-Zeichenfolge an die Microsite weiter.
{% hint style="info" %}
**Beispiel:** `https://your-microsite.squatch.app/?jwt=`
{% endhint %}
Sie können die Microsite entweder in einem neuen Browser-Tab öffnen oder die Microsite mithilfe eines Iframes in Ihre App einbetten. Wenn Sie sich dafür entscheiden, die Microsite einzubetten, stellen Sie sicher, dass Sie [Cross-Origin Resource Sharing (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) und Browser-Einschränkungen angemessen behandeln.
{% endstep %}
{% endstepper %}
#### Hinweise
* Wenn Sie diese Authentifizierungsmethode verwenden, haben Benutzer keine Anmeldedaten für die Microsite.
* Der JWT-basierte Zugriff muss streng kontrolliert werden. Machen Sie ihn in clientseitigem JavaScript nicht sichtbar und manipulieren Sie ihn dort nicht.
* 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 [den Support](mailto:saasquatch-support@impact.com), fügen Sie Ihrer Support-Anfrage Ihre Microsite-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 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://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 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.