> 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 via JWT einrichten
Die Microsite Ihres Advocate-Programms erfordert in der Regel, dass sich Ihre Kunden-Advocates mit einem Benutzernamen und Passwort registrieren, bevor sie auf ihre Freigabelinks und Belohnungsdetails zugreifen können. Als fortgeschrittene Alternative können Sie Benutzer stattdessen authentifizieren, indem Sie ein [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) serverseitig erstellen und es über einen URL-Parameter an die Microsite übergeben.
Bei dieser Methode verfügen die Teilnehmer nicht über Anmeldedaten für die Microsite. Stattdessen erhalten sie Zugriff, indem sie sich in Ihr bestehendes Kundenportal einloggen, das sie dann mithilfe des JWT zur Identifizierung und Anzeige ihrer personalisierten Inhalte zur Microsite weiterleitet.
#### Bevor Sie beginnen
{% hint style="warning" %}
**Wichtig:** Dies ist eine fortgeschrittene Implementierung, die den Standard-Managed-Identity-Service für die Microsite umgeht und bei der Einrichtung Unterstützung von Ihrem Entwicklerteam erfordert.
{% endhint %}
Sie sollten diese Methode nur verwenden, wenn alle der folgenden Punkte zutreffen:
* Sie möchten eine Single-Sign-on-(SSO)-Erfahrung simulieren, indem Sie Teilnehmer automatisch an der Microsite Ihres Programms anmelden.
* Sie können JWTs serverseitig generieren.
* Sie können nicht oder möchten nicht die [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 installieren.
{% stepper %}
{% step %}
#### Schritt 1: Erstellen Sie eine Microsite ohne Managed Identity
Wenn Sie Ihre Microsite 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 Microsite zu laden.
Erstellen Sie die Microsite
Passen Sie zunächst die Einstellungen an, um den *Teilnehmer-Login* Option.
1. Wählen Sie im linken Navigationsmenü  **\[Engage]** **→ Inhalt**.
2. Auf der *Microsite* Karte, wählen Sie **Einstellungen bearbeiten**.
3. Sie werden dann zu Ihrer neuen *Microsite-Einstellungen* Seite.
4. Innerhalb des *Anmeldung* Abschnitt, .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Deaktivieren]** **Teilnehmer-Login**.
5. Wählen Sie **Einstellungen speichern**.
Konfigurieren Sie die Dashboard-Seite
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 Ihrer Website an.
* Wählen Sie im linken Navigationsmenü  **\[Engage]** **→ Inhalt** → **Einrichtungsinhalte** oder **Inhalt bearbeiten**.
* In der *Microsite* Registerkarte, wählen Sie **Dashboard** im *Layout für angemeldete Teilnehmende* Abschnitt.
* Wählen Sie  **\[Menü] → Einstellungen**.
* In der *Zugelassene Nutzer* 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.
* Freigabelink
* Empfehlungscode
* Social-Media-Schaltflächen — Sie müssen die ID zu jeder einzelnen Social-Media-Teilen-Schaltfläche hinzufügen, die Sie einbeziehen möchten.
3. Wählen Sie oben rechts **Speichern**.
Wenn Sie Hilfe bei der Verwendung des Editors zum Finden und Anpassen Ihrer Seiten- und Komponenteneinstellungen benötigen, lesen Sie [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 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
* Registrierung
* Passwort zurücksetzen
* E-Mail bestätigen
{% endstep %}
{% step %}
#### Schritt 2: Erstellen Sie das JWT
Die JWT-Struktur folgt den standardmäßigen Advocate-Anforderungen für die Benutzerauthentifizierung. Wenn Sie Advocate bereits zuvor integriert haben, generieren Sie wahrscheinlich bereits ä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 generieren und die Anforderungen an die Nutzdaten](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}
{% step %}
#### Schritt 3: Fügen Sie das JWT an die URL der Microsite an
Sobald der Benutzer in Ihrer Plattform angemeldet ist, leiten Sie ihn mit dem in der URL-Abfragezeichenfolge enthaltenen JWT zur 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 sie 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 entsprechend behandeln.
{% endstep %}
{% endstepper %}
#### Notizen
* Wenn Sie diese Authentifizierungsmethode verwenden, haben Benutzer keine Anmeldedaten für die Microsite.
* Der Zugriff per JWT muss streng kontrolliert werden. Machen Sie es in clientseitigem JavaScript nicht sichtbar und manipulieren Sie es nicht.
* Dies ist ein nicht standardmäßiger Ansatz – testen Sie ihn vor der Einführung Ihres Programms gründlich in Ihrer Staging-Umgebung.
* Wenn Sie [Support](mailto:saasquatch-support@impact.com)benötigen, geben Sie in Ihrer Supportanfrage die URL Ihrer Microsite, Implementierungsdetails und ein Beispiel für die JWT-Nutzdaten an.
---
# 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.
