actions - Anmeldung & Registrierung

Diese Seite enthält alle Aktionen, die den Anmeldungs- und Registrierungsprozess im Onlineshop betreffen. Hier sind alle Meldungen und E-Mail-Vorlagen dokumentiert, die beim Anmelden, Entsperren eines Kontos oder beim Zurücksetzen eines Passworts ausgegeben etc. werden.

---

Übersicht der Aktionen

Die hier aufgeführten Aktionen wurden thematisch gruppiert, um die zugehörigen Fehlermeldungen und E-Mail-Vorlagen übersichtlich darzustellen.

Aktionen, die inhaltlich zu einem anderen Themenbereich gehören, finden sich in den entsprechenden Abschnitten dieser Dokumentation oder in der alphabetischen Übersicht der Aktionen.

Auszug der Grundstruktur actions

{
    "actions": {
      ...
      "checkPasswordStrength": {...},
      "login": {...},
      "unlockLogin": {...},
      "passwordForgotten": {...},
      "resetPassword": {...},
      ...
    }
}

Aktionsübersicht

Aktion	Beschreibung
checkPasswordStrength	Steuert, ob der Shop die Stärke eines Passworts prüft.
login	Definiert die Fehlermeldungen, die beim Anmeldevorgang im Kundenkonto ausgegeben werden.
unlockLogin	Definiert die Fehlermeldungen, die beim Aufheben einer Login-Sperre ausgegeben werden.
passwordForgotten	Definiert die Fehlermeldungen, die beim “Passwort vergessen”-Vorgang ausgegeben werden, sowie die E-Mail, die versendet wird.
resetPassword	Definiert die Fehlermeldungen, die beim Ändern des Passworts ausgegeben werden.

---

actions.checkPasswordStrength - Passwortstärke resp. Passwortsicherheit

Mit der Aktion checkPasswordStrength wird gesteuert, ob das Shopsystem bei Aktionen wie Registrierung oder Passwortänderung die Stärke eines Passworts serverseitig prüft (z. B. Mindestlänge, Komplexität).

Beispielkonfiguration

{
  "active": true
}

Parameterübersicht

Parameter	Typ	Beschreibung
active	bool	Aktiviert bzw. deaktiviert die serverseitige Prüfung der Passwortstärke. Default: true

---

actions.login - Anmeldung

Mithilfe der Aktion login wird definiert, welche Fehlermeldungen beim Anmeldevorgang im Kundenkonto ausgegeben werden.

Beispielkonfiguration

{
  "errorCodes": {
    "missingId": "Bitte geben Sie Ihre E-Mail-Adresse ein.",
    "missingPassword": "Bitte geben Sie Ihr Passwort ein.",
    "emailCheckFailed": "Die angegebene E-Mail-Adresse ist ungültig.",
    "loginBlocked": "Ihr Konto wurde vorübergehend gesperrt. Bitte versuchen Sie es später erneut oder wenden Sie sich an den Support.",
    "invalidCredentials": "E-Mail-Adresse oder Passwort ist falsch.",
    "ipAddressBlocked": "Von Ihrer IP-Adresse sind aktuell keine Logins möglich."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	array	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingId	string	Fehlermeldung, die ausgegeben wird, wenn keine Login-ID (z.B. E-Mail-Adresse) übermittelt wurde.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wird.
loginBlocked	string	Fehlermeldung, die ausgegeben wird, wenn das Benutzerkonto vorübergehend gesperrt ist.
invalidCredentials	string	Fehlermeldung, die ausgegeben wird, wenn die Kombination aus E-Mail-Adresse und Passwort nicht stimmt.
ipAddressBlocked	string	Fehlermeldung, die ausgegeben wird, wenn die aktuelle IP-Adresse blockiert ist (Blacklist).

---

actions.unlockLogin - Anmeldung entsperren

Mit der Aktion unlockLogin können Fehlermeldungen definiert werden, die beim Aufheben einer Login-Sperre für ein Kundenkonto ausgegeben werden.

Beispielkonfiguration

{
  "errorCodes": {
    "unauthorized": "Die Login-Sperre konnte nicht aufgehoben werden."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
unauthorized	string	Fehlermeldung, die ausgegeben wird, wenn die Entsperrung nicht zulässig ist (z.B. ungültiger Link oder fehlende Berechtigung).

---

actions.passwordForgotten - Passwort vergessen

Mit der Aktion passwordForgotten werden die Fehlermeldungen definiert, die beim Vorgang „Passwort vergessen“ angezeigt werden.

Beispielkonfiguration

{
  "email": {
    "template": "password_forgotten.htm",
    "subject": "Passwort zurücksetzen",
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop"
  },
  "errorCodes": {
    "missingEmail": "Bitte geben Sie Ihre E-Mail-Adresse an.",
    "emailCheckFailed": "Die angegebene E-Mail-Adresse ist ungültig.",
    "passwordRecoveryFailed": "Das Zurücksetzen des Passworts ist fehlgeschlagen. Bitte versuchen Sie es später erneut."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
email	object	Konfiguriert die E-Mail, die beim Zurücksetzen des Passworts versendet wird. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mail Einstellungen
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde.
passwordRecoveryFailed	string	Fehlermeldung, die ausgegeben wird, wenn der Passwort-Reset fehlschlägt.

---

actions.resetPassword - Passwort zurücksetzen

Mithilfe der Aktion resetPassword wird festgelegt, welche Fehlermeldungen beim Ändern des Passworts für ein bestehendes Kundenkonto ausgegeben werden und welche Prüfungen/Aktionen ausgeführt werden.

Beispielkonfiguration

{
  "autoLogout": true,
  "checkOldPassword": true,
  "checkLoginID": false,
  "errorCodes": {
    "notLoggedIn": "Bitte melden Sie sich an, um Ihr Passwort zu ändern.",
    "missingEmail": "Bitte geben Sie Ihre E-Mail-Adresse an.",
    "emailMismatch": "Die angegebene E-Mail-Adresse stimmt nicht mit Ihrem Konto überein.",
    "missingPassword": "Bitte geben Sie ein neues Passwort ein.",
    "passwordMismatch": "Die eingegebenen Passwörter stimmen nicht überein.",
    "missingPasswordAuth": "Bitte geben Sie Ihr aktuelles Passwort zur Bestätigung ein.",
    "failedPasswordAuth": "Das eingegebene aktuelle Passwort ist nicht korrekt.",
    "passwordCheckFailed": "Das neue Passwort erfüllt nicht die Sicherheitsanforderungen."
  }
}

Parameterübersicht

Parameter	Typ	Beschreibung
autoLogout	bool	Legt fest, ob der Kunde nach einer erfolgreichen Passwortänderung automatisch ausgeloggt wird. Default: true
checkOldPassword	bool	Gibt an, ob zur Änderung des Passworts zusätzlich das bisherige Passwort abgefragt und geprüft werden soll. Default: true
checkLoginID	bool	Wenn true, wird zusätzlich geprüft, ob die angegebene Login-ID/E-Mail mit dem Konto übereinstimmt. Default: false
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde.
emailMismatch	string	Fehlermeldung, die ausgegeben wird, wenn die alte E-Mail-Adresse nicht korrekt übergeben wurde.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde.
passwordMismatch	string	Fehlermeldung, die ausgegeben wird, wenn Passwort und Passwort-Bestätigung nicht übereinstimmen.
missingPasswordAuth	string	Fehlermeldung, die ausgegeben wird, wenn das aktuelle Passwort als Bestätigung erforderlich, aber nicht angegeben ist.
failedPasswordAuth	string	Fehlermeldung, die ausgegeben wird, wenn das eingegebene, aktuelle Passwort, nicht korrekt ist.
passwordCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn das Passwort die Mindestanforderungen nicht erfüllt.