# SSO für eine impact.com-Microsite via JWT einrichten

Die Microsite Ihres Advocate-Programms erfordert normalerweise, dass sich Ihre Kundenbefürworter mit einem Benutzernamen und Kennwort anmelden, bevor sie auf ihre Teilen-Links und Belohnungsdetails zugreifen können. Als fortgeschrittene Alternative können Sie Benutzer stattdessen serverseitig durch die Generierung eines [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) erstellen und es über einen URL-Parameter an die Microsite übergeben.

Bei dieser Methode erhalten Teilnehmer keine 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 weiter zur Microsite weiterleitet und ihnen personalisierte Inhalte anzeigt.

#### Bevor Sie beginnen

{% hint style="warning" %}
**Wichtig:** Dies ist eine fortgeschrittene Implementierung, die den standardmäßigen Managed Identity Service für die Microsite umgeht und die Unterstützung Ihres Entwicklerteams für die Einrichtung erfordert.
{% endhint %}

Sie sollten diese Methode nur verwenden, wenn alle der folgenden Bedingungen zutreffen:

* Sie möchten ein Single-Sign-On-(SSO)-Erlebnis simulieren, indem Teilnehmer automatisch in die Microsite Ihres Programms eingeloggt werden.
* Sie können JWTs serverseitig generieren.
* Sie können oder möchten das [Universal Tracking Tag (UTT)](https://help.impact.com/brand/de/was-mochten-sie-lernen/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt) nicht 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 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.

<details>

<summary>Erstellen Sie die Microsite</summary>

Passen Sie zunächst die Einstellungen an, um die *Teilnehmeranmeldung* Option auszuschalten.

1. Wählen Sie im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fh35M3mMIl7XP42pqh7Ls%2Fimage.png?alt=media\&token=bf6b6ba2-295c-4cdb-8c77-f171416c13e1) **\[Engage]** **→ Inhalt**.
2. Auf der *Microsite* Karte wählen Sie **Einstellungen bearbeiten**.
3. Sie werden dann zu Ihrer neuen *Microsite-Einstellungen* Seite weitergeleitet.
4. Innerhalb des *Login* Abschnitts, ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-2c3a3c392d640f7b79d44c16f21c2c4f0ec3dcca%2F80381ca112cfb2757e97b8669cc0b5c98c8ce8d60ed9e3048b4a86a52e76719f.svg?alt=media) **\[Umschalten aus]** **Teilnehmeranmeldung**.
5. Wählen Sie **Einstellungen speichern**.

</details>

<details>

<summary>Konfigurieren Sie die Dashboard-Seite</summary>

Konfigurieren Sie als Nächstes die *Dashboard* Seite Ihrer Microsite 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ü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F8AYI7cAhXQWYRoQlKHte%2Fimage.png?alt=media\&token=d2b5a01e-c7b4-4a71-a6a0-0cea5a4b7ac4) **\[Engage]** **→ Inhalt** → **Inhalte einrichten** oder **Inhalte bearbeiten**.
   * Wählen Sie im *Microsite* Tab, **Dashboard** im Bereich *Eingeloggt-Layout* aus.
   * Wählen Sie ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c746d936c908b9090325464502f7c10acda0e993%2F2a92939e8e78dd7e0c0416b1a250d5ef1d7ab0dec966fb5ed320ca62acfc06c5.svg?alt=media) **\[Menü] → Einstellungen**.
   * Wählen Sie im *Zugelassene Benutzer* Wählen Sie in der Dropdown-Liste **Unverifiziert**.
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.
   * Teilen-Link
   * Empfehlungscode
   * Social-Media-Buttons — Sie müssen die ID zu jedem einzelnen Social-Media-Share-Button hinzufügen, den Sie einbinden möchten.
3. Wählen Sie oben rechts **Speichern**.

   <div data-with-frame="true"><figure><img src="https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-7314ab2d13689a218d7b2ab0ff0ae784aecc169d%2Fe489a23c2242c41439531bebcaa74a7caac8de79b22b4e423c11194933156962.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

Für Hilfe bei der Verwendung des Editors zum Finden und Anpassen Ihrer Seiten- und Komponenteneinstellungen, beziehen Sie sich auf [Microsite-Editor erklärt](https://help.impact.com/brand/de/was-mochten-sie-lernen/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained) und [Microsite-Layouts & Seiten anpassen](https://help.impact.com/brand/de/was-mochten-sie-lernen/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages).

</details>

<details>

<summary>Entfernen Sie unnötige Seiten</summary>

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 ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Mehr]** **→ Löschen**.
3. Entfernen Sie die *Eingeloggt-Layout*.
4. Entfernen Sie die folgenden Seiten:
   * Profil bearbeiten
   * E-Mail-Verifizierung
   * Passwort vergessen
   * Login
   * Abmelden
   * Registrieren
   * Passwort zurücksetzen
   * E-Mail verifizieren

</details>
{% endstep %}

{% step %}

### Schritt 2: Generieren Sie das JWT

Die JWT-Struktur folgt den standardmäßigen Advocate-Anforderungen für die Benutzerauthentifizierung. Wenn Sie Advocate zuvor integriert haben, erzeugen Sie wahrscheinlich bereits ä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 [ein JWT generieren und welche Nutzlastanforderungen bestehen](https://integrations.impact.com/impact-brand/docs/json-web-tokens).
{% endstep %}

{% step %}

### Schritt 3: Hängen Sie das JWT an die Microsite-URL an

Sobald der Benutzer in Ihrer Plattform angemeldet ist, leiten Sie ihn mit dem in die URL-Abfragezeichenfolge eingeschlossenen JWT zur Microsite weiter.

{% hint style="info" %}
**Beispiel:** `https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_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 fürs Einbetten entscheiden, stellen Sie sicher, dass Sie [Cross-Origin Resource Sharing (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) und Browsereinschränkungen entsprechend handhaben.
{% endstep %}
{% endstepper %}

#### Hinweise

* Wenn Sie diese Authentifizierungsmethode verwenden, haben Benutzer keine Anmeldedaten für die Microsite.
* Der auf JWT basierende Zugriff muss streng kontrolliert werden. Setzen Sie ihn nicht clientseitigem JavaScript aus und manipulieren Sie ihn nicht dort.
* Dies ist ein nicht standardmäßiger Ansatz — testen Sie ihn gründlich in Ihrer Staging-Umgebung, bevor Sie Ihr Programm einführen.
* Wenn Sie [Support](mailto:saasquatch-support@impact.com), fügen Sie in Ihrer Supportanfrage Ihre Microsite-URL, Implementierungsdetails und ein Beispiel für eine JWT-Nutzlast bei.
