actions - Anmeldung & Registrierung

Aktionen rund um Anmeldung und Registrierung im Shop: Fehlertexte und E-Mail-Vorlagen für Login, Kontoentsperrung sowie Passwort-Zurücksetzen.

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": {
    "acceptInvitation": {...},
    "checkPasswordStrength": {...},
    "login": {...},
    "unlockLogin": {...},
    "passwordForgotten": {...},
    "resetPassword": {...}
  }
}

​

Aktionsübersicht

Aktion	Beschreibung
acceptInvitation	Definiert die Fehlermeldungen, die beim Annehmen einer Einladung zu einem B2B-Konto ausgegeben werden.
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.acceptInvitation - Einladung annehmen (B2B)

Mithilfe der Aktion acceptInvitation werden die Fehlermeldungen gesteuert, die ausgegeben werden, wenn ein eingeladener Nutzer eine B2B-Kontoeinladung über einen Double-Opt-In-Link annimmt.

​

Beispielkonfiguration

{
  "errorCodes": {
    "invalidAccountId": "<Textbaustein>",
    "actionNotAllowed": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
invalidAccountId	string	Fehlermeldung, die ausgegeben wird, wenn der Double-Opt-In-Token keinem Kundenkonto zugeordnet werden kann.
actionNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn der Double-Opt-In-Token ungültig ist.

---

​

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": "<Textbaustein>",
    "missingPassword": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "loginBlocked": "<Textbaustein>",
    "invalidCredentials": "<Textbaustein>",
    "ipAddressBlocked": "<Textbaustein>",
    "duplicatePendingReview": "<Textbaustein>"
  }
}

​

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).
duplicatePendingReview	string	Fehlermeldung, die ausgegeben wird, wenn eine Anmeldung nicht möglich ist, weil sich das Konto noch in der Duplettenprüfung befindet (siehe accounts.account → duplicate).

---

​

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": "<Textbaustein>"
  }
}

​

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": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "passwordRecoveryFailed": "<Textbaustein>"
  }
}

​

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": "<Textbaustein>",
    "missingEmail": "<Textbaustein>",
    "emailMismatch": "<Textbaustein>",
    "missingPassword": "<Textbaustein>",
    "passwordMismatch": "<Textbaustein>",
    "missingPasswordAuth": "<Textbaustein>",
    "failedPasswordAuth": "<Textbaustein>",
    "passwordCheckFailed": "<Textbaustein>"
  }
}

​

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.