SSO für eine impact.com-Microsite über 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 Prämiendetails zugreifen können. Als erweiterte Alternative können Sie Benutzer jedoch stattdessen authentifizieren, indem Sie serverseitig ein JSON Web Token (JWT) erstellen und es über einen URL-Parameter an die Microsite übergeben.

Mit dieser Methode haben Teilnehmer keine Anmeldedaten für die Microsite. Stattdessen erhalten sie Zugriff, indem sie sich bei Ihrem bestehenden Kundenportal anmelden, das sie dann mithilfe des JWT zur Identifizierung und Anzeige ihrer personalisierten Inhalte zur Microsite weiterleitet.

Bevor Sie beginnen

Wichtig: Dies ist eine erweiterte Implementierung, die den standardmäßigen Managed Identity Service für die Microsite umgeht und die Unterstützung Ihres Entwicklerteams für die Einrichtung erfordert.

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

• Sie möchten eine Single-Sign-On-(SSO)-Erfahrung simulieren, indem Teilnehmer automatisch bei der Microsite Ihres Programms angemeldet werden.

• Sie können JWTs serverseitig erzeugen.

• Sie können den Universal Tracking Tag (UTT) nicht auf Ihrer Website installieren oder möchten dies nicht tun.

1

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 die Teilnehmeranmeldung Option.

1. Wählen Sie im linken Navigationsmenü [Engage] → Inhalt.

2. Auf der Microsite Karte, wählen Sie Einstellungen bearbeiten.

3. Anschließend werden Sie zu Ihren neuen Microsite-Einstellungen Seite.

4. Innerhalb des Anmelden Abschnitt, [Deaktivieren] Teilnehmeranmeldung.

5. Wählen Sie Einstellungen speichern.

Konfigurieren Sie die Dashboard-Seite

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ü [Engage] → Inhalt → Inhalte einrichten oder Inhalte bearbeiten.

   • In der Microsite Tab Dashboard im Layout für angemeldete Benutzer Abschnitt.

   • Wählen Sie [Menü] → Einstellungen.

   • In der Zugelassene Benutzer 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.

   • Link teilen

   • 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 zur Verwendung des Editors, um Ihre Seiten- und Komponenteneinstellungen zu finden und anzupassen, finden Sie unter Microsite-Editor erklärt und Layouts und Seiten der Microsite anpassen.

Nicht benötigte Seiten entfernen

Entfernen Sie das Layout und die Seiten, die Ihre Microsite 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 Benutzer.

4. Entfernen Sie die folgenden Seiten:

   • Profil bearbeiten

   • E-Mail-Bestätigung

   • Passwort vergessen

   • Anmelden

   • Abmelden

   • Registrieren

   • Passwort zurücksetzen

   • E-Mail bestätigen

2

Schritt 2: Erzeugen Sie das JWT

Die JWT-Struktur folgt den standardmäßigen Advocate-Anforderungen für die Benutzerauthentifizierung. Wenn Sie Advocate bereits integriert haben, generieren Sie wahrscheinlich schon ähnliche Token für UTT.

Sie müssen das JWT sicher auf Ihrem Server oder einem anderen vertrauenswürdigen Backend-System generieren — niemals im Browser.

Erfahren Sie, wie Sie ein JWT und die Anforderungen an die Payload erzeugen.

3

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

Sobald der Benutzer bei Ihrer Plattform angemeldet ist, leiten Sie ihn mit dem in der URL-Abfragezeichenfolge enthaltenen JWT zur 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 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) und Browser-Einschränkungen entsprechend behandeln.

Notizen

• Wenn Sie diese Authentifizierungsmethode verwenden, haben Benutzer keine Anmeldedaten für die Microsite.

• Der JWT-basierte Zugriff muss streng kontrolliert werden. Geben Sie ihn nicht in clientseitigem JavaScript preis 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 Supportbenötigen, fügen Sie Ihrer Supportanfrage Ihre Microsite-URL, Implementierungsdetails und eine Beispiel-JWT-Payload bei.