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

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.

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) nicht auf Ihrer Website installieren oder möchten es nicht.

1

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 und Microsite-Layouts und -Seiten anpassen.

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

2

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.

3

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.

Beispiel: https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>

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) und Browser-Einschränkungen angemessen behandeln.

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, fügen Sie Ihrer Support-Anfrage Ihre Microsite-URL, Implementierungsdetails und eine Beispiel-JWT-Payload hinzu.