Zum Inhalt springen

Jitterbit Registration Portal App

Übersicht

Jitterbit stellt die Registration Portal App über den Jitterbit Marketplace bereit. Sie wurde mit dem Jitterbit App Builder erstellt und ist ein Self-Service-Frontend für Registrierung und Authentifizierung, das auf der nativen Anwendungsauthentifizierung des App Builder basiert. Es bietet Kontoregistrierung, Anmeldung und Passwortwiederherstellung mit Zwei-Faktor-Authentifizierung (2FA) per E-Mail-Verifizierungscode, konfigurierbare Passwort- und Sperrrichtlinien sowie ein administratives Dashboard zur Verwaltung von Benutzern, Nachrichtenvorlagen und Einstellungen.

Du lädst die App als App-Builder-Release-Paket (eine .LP-Datei) aus dem Marketplace herunter und installierst sie in deiner eigenen App-Builder-Instanz, wo du sie für deinen Prozess konfigurieren und erweitern kannst.

Diese Seite beschreibt wie die App funktioniert, ihre Kernfunktionen und das Datenmodell, und behandelt die Voraussetzungen, wie man sie herunterlädt und installiert, wie man sie für deine Umgebung konfiguriert, wie der Zugriff kontrolliert wird, die Geschäftsregeln, die sie verwendet, und allgemeine Schritte zur Fehlerbehebung.

So funktioniert die App

Anonyme Besucher erreichen drei Einstiegspunkte: ein neues Konto registrieren, sich anmelden oder ein Passwort wiederherstellen. Registrierung und Wiederherstellung sind geführte Assistenten, die einen per E-Mail gesendeten Verifizierungscode verwenden:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart TD V["Anonymous visitor"] --> R["Register"] V --> L["Log in"] V --> F["Forgot password"] R --> R1["Enter email and password;
policy and duplicate checks"] R1 --> R2["Verification code emailed"] R2 --> R3["Verify code"] R3 --> A["Account created,
identity assigned"] L --> L1["Lockout checks
by email and IP"] L1 --> L2["Validate credentials"] L2 --> S["Authenticated session"] F --> F1["Enter email;
recovery code emailed"] F1 --> F2["Verify code"] F2 --> F3["Set new password"] F3 --> L

Kernfunktionen

Wenn du Registration Portal installierst und konfigurierst, stellt es die folgenden Funktionen bereit:

  • Self-Service-Registrierung: Ein zweistufiger Assistent erfasst E-Mail und Passwort, erzwingt die konfigurierte Passwortrichtlinie, bestätigt das Passwort und überprüft die Eindeutigkeit der E-Mail, ohne preiszugeben, ob die E-Mail bereits vorhanden ist.

  • Zwei-Faktor-Authentifizierung: Registrierung und Passwortwiederherstellung stellen einen zeitlich begrenzten Verifizierungscode per E-Mail aus. Ein neuer Code invalidiert alle vorherigen Codes.

  • Anmeldung mit Sperrschutz: Die Anmeldung validiert Anmeldeinformationen und erzwingt Schwellwerte für Sperren nach E-Mail-Adresse und ausgehender IP-Adresse.

  • Passwortwiederherstellung: Ein dreistufiger Assistent identifiziert das Konto, validiert einen per E-Mail gesendeten Code und ermöglicht es dem Benutzer, ein neues, richtlinienkonformes Passwort festzulegen.

  • Konfigurierbare Richtlinien: Administratoren verwalten Passortkomplexität, Schwellwerte für Sperren und Umgebungseinstellungen über gruppierte Richtlinienbereiche.

  • Anpassbare Nachrichten: E-Mail-Inhalte, Nachrichten auf dem Bildschirm und der Text der Nutzungsbedingungen werden als bearbeitbare Vorlagendatensätze gespeichert, sodass Administratoren die Formulierung ändern können, ohne die Logik der App zu ändern.

Datenmodell

Registration Portal verwendet von App Builder verwaltete Tabellen (managed tables) und erzwingt Datengrenzen nach Benutzersitzung statt nach physischen Fremdschlüsselbeschränkungen. Jede Tabelle hat einen Datennutzungstyp, der von ihrer Install Option festgelegt wird und steuert, wie ihre Daten behandelt werden, wenn die App in einer neuen Umgebung installiert wird.

Tabelle Nutzungstyp Zweck
User User Identitätsdatensätze für selbst registrierte Konten, einschließlich gehashte Anmeldeinformationen, Verifizierungscodes, Ablaufdaten und Identitätsgruppenabbildung.
LoginAttempt User Sicherheitsprotokoll von Authentifizierungsversuchen (E-Mail, IP-Adresse, Zeitstempel und Erfolg), das zur Überwachung und Sperrberechnung verwendet wird.
Session User Benutzersitzungszustand pro Benutzer, zwischengespeicherte Anmeldeinformationen und Zugriffstokens, begrenzt auf eine einzelne Browsersitzung.
Template User Lokalisiertes HTML für E-Mails, Nachrichten auf dem Bildschirm und Inhalte der Nutzungsbedingungen.
Parameter Shared Globale Konfiguration: Sicherheitsanbieter-Zuordnung, Passwortrichtlinie und Konto-/IP-Schwellwerte für Sperren.

Hinweis

Alle Tabellen außer Session werden überwacht.

Voraussetzungen

Um Registration Portal zu verwenden, benötigst du folgende Voraussetzungen:

  • Eine Jitterbit Harmony-Lizenz mit Zugriff auf App Builder. Dies ermöglicht den Download von Marketplace. Falls deine Organisation nicht für App Builder lizenziert ist, wird die Aktion App herunterladen durch eine Anforderungsaktion App anfordern ersetzt (siehe Herunterladen und Installieren).

  • Eine App Builder-Instanz, auf der App Builder 4.63 läuft – die Version, für die das aktuelle Paket erstellt wurde. Jedes Paket wird nur auf seiner exakten App Builder-Version installiert. Wenn die Instanz eine andere Version nutzt, kontaktiere den Jitterbit-Support, um ein passendes Paket anzufordern.

  • Eine PostgreSQL-Datenbank für die App Builder-Instanz.

  • Ein ausgehender E-Mail-Pfad von der App Builder-Instanz. Die App versendet Verifizierungs- und Wiederherstellungscodes per E-Mail. Ohne funktionierende Mail-Konfiguration werden diese Codes nicht versendet.

App herunterladen und installieren

App vom Marketplace herunterladen

  1. Melde dich beim Harmony Portal unter https://login.jitterbit.com an und öffne Marketplace.

  2. Suche die App mit dem Namen Registration Portal. Du kannst die Suchleiste nutzen oder im Filters-Bereich unter Type App auswählen, um nur Apps anzuzeigen.

  3. Klicke auf die App-Karte, um das Details-Panel zu öffnen. Überprüfe die Requirements der App (die benötigte App Builder-Version und Datenbank).

  4. Klicke auf den Go to documentation-Link der App, um diese Dokumentation in einem neuen Tab zu öffnen und halte ihn als Referenz offen.

  5. Führe je nachdem, ob deine Organisation lizenziert für App Builder ist, einen der folgenden Schritte aus:

    • App herunterladen: Wenn deine Organisation lizenziert für App Builder ist, klicke auf Download app – entweder auf der App-Karte oder im Details-Panel. Der Browser speichert die .LP-Datei an den Download-Speicherort, und eine App Builder file downloaded successfully-Benachrichtigung bestätigt den Download.

    • App erhalten: Wenn deine Organisation nicht lizenziert für App Builder ist, heißt die Aktion Get app. Das Details-Panel zeigt eine Meldung, dass eine App Builder-Lizenz erforderlich ist, mit einer Submit-Schaltfläche. Klicke auf Submit, um eine Anfrage zu senden, damit sich ein Vertreter mit dir über App Builder in Verbindung setzt. Eine Message successfully sent-Benachrichtigung bestätigt dies.

App in App Builder installieren

Installiere die heruntergeladene .LP-Datei in der App Builder-Instanz:

  1. Melde dich in App Builder an und öffne die IDE.

  2. Klicke unter Deploy auf Install Release.

  3. Klicke auf + Package, dann auf Browse und wähle die .LP-Datei aus, die du heruntergeladen hast.

  4. Klicke auf Save. Das Release-Panel zeigt die Paketinformationen an, dann schließt sich der Package-Dialog.

  5. Bestätige, dass die Details korrekt sind, und klicke auf Install.

Um den Inhalt eines Pakets vor der Installation anzusehen, klicke auf die Manifest-Schaltfläche.

App in einer Entwicklungsumgebung ändern

Die Datenquelle der App wird versiegelt installiert. Wenn du die App in einer Entwicklungsumgebung bereitstellst und die Anwendung ändern möchtest, entstiegle die Datenquelle, damit du die Objekte der App bearbeiten kannst. Lasse sie in QA und Produktion versiegelt, um die Konsistenz in allen Umgebungen zu bewahren. Siehe Datenquelle versiegeln oder entstiegeln.

Konfiguration und Setup

Nach der Installation der App in einer neuen Umgebung führe die folgenden Schritte durch, um sie einsatzbereit zu machen:

  1. Zugriffsgruppen zuweisen. Füge die Benutzer, die die App konfigurieren werden, zur Registration Portal Administrator-Gruppe hinzu, die Zugriff auf alle Setup- und Verwaltungsaufgaben gewährt. Füge den anonymen Benutzer von App Builder zur Registration Portal Anonymous-Gruppe hinzu, damit nicht authentifizierte Besucher die Registrierungs-, Login- und Passwort-Wiederherstellungsseiten aufrufen können. Siehe Security and access.

  2. Sicherheitsanbieter festlegen. Aktualisiere in den Parameter-Einstellungen den ProviderId-Wert, um ihn an den Authentifizierungshost deiner Umgebung anzupassen. Informationen zum Erstellen dieses Anbieters findest du unter Create the Application Authentication security provider.

  3. Standardidentität festlegen. Lege den DefaultIdentityName-Wert auf einen gültigen Sicherheitskontext in der Host-Umgebung fest. Neue Konten werden gegen diese Identität bereitgestellt. Informationen zum Einrichten des generischen Benutzerkontos, auf das es abgebildet wird, findest du unter Configure a generic user account. Informationen dazu, wie die Identität den Zugriff steuert, findest du unter Security and access.

  4. Überprüfen Sie die Sicherheitsrichtlinien. Vergewissern Sie sich, dass die Sperrschwellen, Sperrzeiträume und Anforderungen an die Passwort-Komplexität in den Bereichen Lockout Policy, Password Policy und Environment Settings korrekt eingestellt sind. Die App wird mit diesen Standardwerten installiert:

    • Lockout Policy: IP Attempts 50, IP Duration 60 Minuten, Email Attempts 10 und Email Duration 5 Minuten.

    • Password Policy: Mindestlänge von 8 Zeichen mit mindestens einem Großbuchstaben und einer Zahl.

  5. Passen Sie die Vorlagen an. Bearbeiten Sie die E-Mail-Betreffzeilen, Nachrichteninhalte und Nutzungsbedingungen in den Template-Datensätzen.

Sicherheit und Zugriff

Registration Portal nutzt die rollenbasierte Sicherheit von App Builder mit zwei Zugriffsgruppen:

  • Registration Portal Anonymous: Gewährt nicht authentifizierten Besuchern Zugriff auf die Seiten zum Registrieren, Anmelden und Passwort-Wiederherstellen. Weisen Sie den anonymen Benutzer von App Builder dieser Gruppe zu, damit diese öffentlichen Einstiegspunkte erreichbar sind.

  • Registration Portal Administrator: Gewährt vollständigen Zugriff auf die Setup- und Verwaltungsfunktionen der App, einschließlich Richtlinien, Vorlagen und des Benutzergitters. Weisen Sie die Benutzer, die die App verwalten, dieser Gruppe zu.

Die App stellt Konten nach einem semi-anonymen Muster bereit. Neue Benutzer erhalten eine Basis-Identität, die durch die Einstellung DefaultIdentityName in der Tabelle Parameter definiert ist. Sobald sich ein Benutzer authentifiziert, bestimmt die zugeordnete Identität, worauf dieser Benutzer zugreifen kann. Administratoren können den Zugriff eines Benutzers im Verwaltungsgitter erhöhen oder ändern.

Anonyme Besucher haben nur Zugriff auf die Einstiegspunkte zur Registrierung, Anmeldung und Passwort-Wiederherstellung sowie auf die Seite mit den Nutzungsbedingungen. Die App implementiert mehrere Sicherheitsmaßnahmen als Geschäftsregeln:

  • Sperrung nach E-Mail-Adresse und IP-Adresse mit Schwellen, die in Parameter konfiguriert sind.

  • Schutz vor Account-Harvesting: Anmeldefehler geben eine generische Meldung zurück, und Registrierung und Wiederherstellung geben generisches Feedback, sodass die App nicht offenbart, ob ein Konto existiert. Wenn jemand versucht, sich mit einer E-Mail-Adresse zu registrieren, die bereits ein Konto hat, sieht der Registrant die gleiche generische Bestätigung, aber die App sendet dem vorhandenen Kontoinhaber eine E-Mail über den Registrierungsversuch, damit dieser sich anmelden oder die Nachricht ignorieren kann, falls diese nicht von ihm stammt.

  • Ablauf des Verifizierungscodes: Codes verfallen nach einem konfigurierten Zeitfenster, und die Ausgabe eines neuen Codes macht den vorherigen ungültig.

Geschäftsregeln

Die Logik von Registration Portal wird als App Builder Geschäftsregeln implementiert. Regelnamen folgen der Konvention Target (Purpose or Subtype) Descriptor von App Builder, sodass das erste Wort die Tabelle angibt, auf die die Regel angewendet wird.

Anmelde- und Sperr-Regeln

Regel Zweck
LoginAttempt (Validation) Email Address Lockout Stoppt die Anmeldung, wenn fehlgeschlagene Versuche für die E-Mail den konfigurierten Schwellenwert überschreiten.
LoginAttempt (Validation) IP Address Lockout Stoppt die Anmeldung, wenn fehlgeschlagene Versuche von der IP-Adresse den konfigurierten Schwellenwert überschreiten.
Session (Validation) Valid Email and Password Validiert Anmeldeinformationen und gibt eine generische Fehlermeldung zurück, um zu vermeiden, dass Kontodaten offengelegt werden.

Die Sperr-Validierungen verwenden zwei unterstützende Unterabfragen, Count Email Attempts und Count IP Attempts, die fehlgeschlagene Versuche im Schwellenfenster zählen, das in Parameter definiert ist.

Registrierungs- und Identitäts-Regeln

Regel Zweck
User (Validation) Duplicate Email Prüft während der Registrierung auf eine bestehende E-Mail-Adresse, ohne offenzulegen, ob diese existiert.
User (Update) Default Identity Name Weist die Standard-Identität bei der Registrierung einem neuen Konto zu.

Zwei-Faktor-Regeln

Regel Zweck
User (Validation) Email Verification Code Expired Bestimmt, ob ein Verifizierungscode seine Ablaufzeit überschritten hat.
User (Update) Email Verification Code Gibt einen neuen Verifizierungscode aus und macht alle früheren Codes ungültig.

Fehlerbehebung

Ein Benutzer kann sich nicht anmelden

  • Symptom: Ein Benutzer kann sich nicht anmelden und erhält eine Sperrmeldung, auch mit dem korrekten Passwort.

  • Mögliche Ursache: Die Anzahl fehlgeschlagener Anmeldeversuche für diese E-Mail-Adresse oder IP-Adresse hat die in Parameter konfigurierte Sperrgrenze überschritten.

  • Lösung: Warten Sie, bis die konfigurierte Sperrfrist abläuft, oder bitten Sie einen Administrator, die Schwellenwerte in den Einstellungen für Lockout Policy anzupassen.

Die Anmeldefehlermeldung gibt nicht an, was falsch war

  • Symptom: Eine fehlgeschlagene Anmeldung gibt eine generische Meldung zurück, statt anzugeben, ob die E-Mail oder das Passwort falsch war.

  • Mögliche Ursache: Dies ist beabsichtigt. Um Account Harvesting zu verhindern, gibt die App einen generischen Fehler zurück, anstatt zu bestätigen, welcher Wert falsch war.

  • Lösung: Es ist keine Aktion erforderlich. Bitten Sie Benutzer, sowohl ihre E-Mail als auch ihr Passwort zu überprüfen.

Ein Verifizierungscode wird als abgelaufen abgelehnt

  • Symptom: Ein Benutzer gibt einen Registrierungs- oder Wiederherstellungscode ein und dieser wird als abgelaufen abgelehnt.

  • Mögliche Ursache: Der Code hat sein Ablauffenster überschritten, oder ein neuer Code wurde ausgestellt, wodurch der vorherige ungültig wird.

  • Lösung: Fordern Sie einen neuen Code an und verwenden Sie den aktuellsten.

Weitere Hilfe erhalten Sie, wenn Sie Ihre App Builder-Protokolle überprüfen und den Jitterbit-Support kontaktieren.