Der Konfigurationsknoten accounts umfasst alle Einstellungen rund um die Verwaltung von Benutzerkonten im Onlineshop.

Er definiert, wie sich Kundinnen und Kunden registrieren, anmelden, eingeloggt bleiben und welche Daten sie im Kundenkonto einsehen oder bearbeiten können. Darüber hinaus enthält er sicherheitsrelevante Parameter wie Passwortprüfungen, Login-Sperren, Auto-Login-Regeln sowie die Verwaltung von Zahlungs- und Adressdaten.

Über diese Konfiguration lässt sich das Verhalten des Kundenkontos individuell an die Anforderungen des Shops anpassen – von der einfachen Anmeldung bis zur detaillierten Steuerung von Berechtigungen und Datenfeldern.

Inhaltsverzeichnis

1 1. accounts* - Grundstruktur
2 2. accounts.account - Benutzerkonto
3 3. accounts.accountRestrictions - Subshopbeschränkungen für Benutzerkonten
4 4. accounts.addressFieldsSettings - Allgemeine Adressfelder-Einstellungen
5 5. accounts.addressField - Einzelne Adressfelder definieren
6 6. accounts.autoLogin - Angemeldet bleiben
7 7. accounts.bankInfoField - Bankdaten
8 8. accounts.creditCardField - Kreditkarten
9 9. accounts.customAddressField - Weitere Adressdatenfelder
10 10. accounts.watchListField - Merkliste

1. `accounts*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens accounts:

{
    "accounts": {
      "account": {...},
      "accountRestrictions": {...},
      "addressFieldsSettings":{...},
      "addressField":{...},
      "autoLogin": {...},
      "bankInfoField": {...},
      "creditCardField": {...},
      "customAddressField": {...},
      "watchListField": {...}
    }
}

Parameterbeschreibungen

Parameter	Beschreibung

Parameter	Beschreibung
`account`	Allgemeine Kontoeinstellungen resp. Benutzerkonten wie Passwortprüfungen, Login-Schutzmechanismen und Sicherheitsregeln. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Login & Anmeldung“.
`accountRestrictions`	Beschränkungen der Konten auf bestimmte Subshops oder Mandanten. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Login & Anmeldung“.
`addressFieldsSettings`	Enthält die konfigurierbaren Einstellungen für Adressfelder, wie individuelle Beschriftungen, Standardwerte, Sichtbarkeiten und Schreibschutzregeln. Über diese Definitionen kann gesteuert werden, welche Adressfelder angezeigt, vorausgefüllt oder schreibgeschützt sind. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Addressdaten“.
`addressField`	Definiert einzelne Adressfelder mit eindeutiger ID, Name und Beschriftung sowie optionalen Validierungen. Wird verwendet, um Struktur und Prüfregeln der Adressdaten im Shop festzulegen. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Addressdaten“.
`autoLogin`	Steuerung der Funktion „Angemeldet bleiben“ inkl. Ablaufzeiten und erlaubter Aktionen ohne erneute Passwortabfrage. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Login & Anmeldung“.
`bankInfoField`	Definiert Felder für Bankverbindungen, die Kundinnen und Kunden im Shop eingeben und speichern können. Diese Bankdaten stehen im Bestellprozess für SEPA-Lastschriftzahlungen zur Verfügung. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Zahlungsarten“.
`creditCardField`	Dient der Anzeige pseudonymisierter Kreditkarteninformationen im Kundenkonto (sofern vom Payment-Provider erlaubt). Enthält vordefinierte Systemfelder wie `holder`, `number`, `type` usw. Keine Eingabe oder Änderung im Shop möglich. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Zahlungsarten“.
`customerAddressField`	Definition zusätzlicher, individueller freier Adressfelder, die bei Rechnungs- und/oder Lieferadressen gespeichert werden können. Konfiguration im Admin Interface unter Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten“.
`watchListField`	Definiert Felder der Merk- bzw. Beobachtungsliste mit eindeutiger ID und Namen. Diese Felder sind ausschließlich über die API ansprechbar und besitzen keine Konfigurationsmöglichkeit im Admin Interface.

2. `accounts.account` - Benutzerkonto

Steuert die zentralen Kontoeinstellungen für Kundinnen und Kunden.
Hier werden Sicherheitsprüfungen, Passwortregeln, Login-Schutzmechanismen und weitere Kontofunktionen festgelegt.

Die Konfiguration beeinflusst das Verhalten beim Anlegen, Anmelden und Verwalten von Kundenkonten im Shop.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Login & Anmeldung.

Beispielkonfiguration für alle Subshops (`accounts.account`)

{
  "additionalPasswordCheckLevels": [
    {
      "checks": [
        {
          "options": {
            "len": 8
          },
          "service": "dataChecker.minLength"
        }
      ]
    },
    {
      "checks": [
        {
          "options": {
            "minChars": 1
          },
          "service": "dataChecker.digitClass"
        },
        {
          "options": {
            "minChars": 1
          },
          "service": "dataChecker.specialClass"
        }
      ]
    }
  ],
  "errorCodes": {
    "passwordResetRequired": ""
  },
  "login": {
    "ipBlockCount": 3,
    "ipBlockCountDuration": 1,
    "ipBlockDuration": 10,
    "ipBlockEnabled": true,
    "loginBlockCount": 5,
    "loginBlockDuration": 180,
    "loginBlockEmail": {
      "fromAddress": "noreply@websale.de",
      "fromName": "Mein Onlineshop",
      "subject": "Mein Onlineshop | Ihr Login wurde gesperrt",
      "template": "loginBlocked.htm"
    },
    "loginCountDuration": 60
  },
  "newCustomerRules": null,
  "passwordChecks": [
    {
      "options": {
        "len": 64
      },
      "service": "dataChecker.maxLength"
    },
    {
      "options": {
        "len": 4
      },
      "service": "dataChecker.minLength"
    }
  ],
  "saveCreditCardData": false,
  "subAccountsEnabled": false
}

Parameterbeschreibungen

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`additionalPasswordCheckLevels`	list	Zusätzliche Prüfungen für Passwörter. Ermöglicht gestaffelte Sicherheitsanforderungen, etwa Mindestlänge oder bestimmte Zeichengruppen (Zahlen, Sonderzeichen).
`checks`	multiService	Liste von Prüfregeln innerhalb eines Levels; alle enthaltenen Checks müssen erfüllt sein.
`service`	string	Prüftyp (z. B. `dataChecker.minLength`, `dataChecker.maxLength`, `dataChecker.digitClass`, `dataChecker.specialClass`).
`options`	array	Optionsobjekt für den jeweiligen Prüftyp.
`len`	int	Länge in Zeichen für `minLength`/`maxLength`.
`minChars`	int	Minimale Anzahl geforderter Zeichen einer Klasse (z. B. Ziffern/Sonderzeichen).
`passwordChecks`	array	Basis-Passwortprüfungen (werden immer angewendet). Aufbau identisch zu `additionalPasswordCheckLevels`.
`service`	string	Prüftyp (z. B. `addressCheck.minLength`, `dataChecker.minLength` für Prüfung einer Mindestangabe `addressCheck.maxLength`, `dataChecker.maxLength` für Prüfung maximale Zeichenangebe etc. Übersicht der verfügbaren Validierungs- und Prüfregeln für Adressdatenfelder finden Sie hier.
`options`	array	Optionsobjekt für den jeweiligen Prüftyp.
`len`	int	Länge in Zeichen für `minLength`/`maxLength`.
`minChars`	int	Minimale Anzahl geforderter Zeichen einer Klasse (z. B. Ziffern/Sonderzeichen).
`errorCodes`	array	Sammelobjekt für besondere Fehlerzustände.
`passwordResetRequired`	string	Schlüssel/Code für den Zustand „Passwortzurücksetzung erforderlich“; Wert kann leer bleiben oder auf einen Textbaustein/Key verweisen.
`login`	array	Einstellungen für Anmelde-Schutzmechanismen.
`ipBlockEnabled`	bool	Aktiviert (`true`) / deaktiviert (`false`) die IP-basierte Sperre.
`ipBlockCount`	int	Anzahl fehlgeschlagener Versuche pro IP, bevor die IP gesperrt wird. Default: 10
`ipBlockCountDuration`	int	Zeitfenster in Minuten, in dem IP-Versuche gezählt werden. Default: 1
`ipBlockDuration`	int	Sperrdauer der IP in Minuten.
`loginBlockCount`	int	Anzahl fehlgeschlagener Logins pro Konto, bevor das Konto gesperrt wird. Default: 5
`loginCountDuration`	int	Zeitfenster in Minuten, in dem Konto-Versuche gezählt werden. Default: 60
`loginBlockDuration`	int	Kontosperrdauer in Minuten. Default: 180
`loginBlockEmail`	array	E-Mail-Benachrichtigung bei Kontosperre.
`fromAddress`	string	Absenderadresse (E-Mail).
`fromName`	string	Anzeigename des Absenders.
`subject`	string	Betreff der E-Mail
`template`	string	Vorlagenname/Datei (z. B. `loginBlocked.htm`).
`newCustomerRules`	array	Regeln für Neuregistrierungen (derzeit `null`; vorbereitet für Erweiterungen).
`saveCreditCardData`	bool	Speicherung von Kreditkartendaten im Konto erlauben (`true`/`false`).
`subAccountsEnabled`	bool	Unterkontenfunktion aktivieren (`true`/`false`) — z. B. für Firmenkonten.

3. `accounts.accountRestrictions` - Subshopbeschränkungen für Benutzerkonten

Begrenzt die Verfügbarkeit von Kundenkonten auf definierte Subshops, z.B. B2B-Konten nur für einen Länder-Shop freigeben, exklusive Bereiche je Mandant oder Region.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Login & Anmeldung.

Beispielkonfiguration für alle Subshops (`accounts.accountRestrictions`)

{
  "subshopRestrictionList": [],
  "subshopRestrictionsEnabled": false,
  "subshopRestrictionsFallback": "onlySelf"
}

Parameterbeschreibungen

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`subshopRestrictionsEnabled`	bool	Aktiviert (`true`) oder deaktiviert (`false`) die Subshop-Beschränkungen für Kundenkonten.
`subshopRestrictionsFallback`	enum	Fallback-Verhalten, wenn keine explizite Zuordnung greift (z. B. leere Liste oder fehlende Kennung). Standard: `onlySelf` – Konto ist nur im „eigenen/aktuell adressierten“ Subshop nutzbar.
`subshopRestrictionList`	list	Liste der zulässigen Subshops (Allowlist) für das Konto. Einträge müssen den in Ihrer Umgebung verwendeten Subshop-Kennungen entsprechen (z. B. den Schlüsseln in der Subshop-Konfiguration). Ist die Liste leer, greift das Verhalten gemäß `subshopRestrictionsFallback`.

4. `accounts.addressFieldsSettings` - Allgemeine Adressfelder-Einstellungen

Steuert die zentralen Konfigurationen für Adressfelder im Shop.
Hier werden individuelle Beschriftungen, Standardwerte, Sichtbarkeiten und Schreibschutzregeln für Rechnungs- und Lieferadressen festgelegt.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Adressdaten.

Beispielkonfiguration für alle Subshops (`accounts.addressFieldsSettings`)

{
  "customLabelsDefinition": [],
  "defaultValuesDefinition": [],
  "inputVisibilityDefinition": null,
  "readOnlyFields": null
}

Parameterübersicht

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`customLabelsDefinition`	list	Definition der Feldbeschriftungen für Adressfelder.
`defaultValuesDefinition`	list	Definiert Standardwerte / Vorbelegungen für Adressfelder.
`inputVisibilityDefinition`	list	Definiert die Sichtbarkeit einzelner Adressfelder.
`readOnlyFields`	list	Definiert, welche Adressfelder nur sichtbar und nicht bearbeitbar sind.

5. `accounts.addressField` - Einzelne Adressfelder definieren

Steuert die Struktur und Eigenschaften einzelner Adressfelder im Shop.
Über Validierungen können Eingaben überprüft und formale Anforderungen (z. B. Pflichtfelder, Formatprüfungen) festgelegt werden.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Adressdaten.

Beispielkonfiguration für alle Subshops (`accounts.addressField.firstName`)

{
  "label": "",
  "name": "firstName",
  "validations": [
    {
      "options": {
        "len": 255
      },
      "service": "addressCheck.maxLength"
    }
  ]
}

Parameterübersicht

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`label`	string	Definition der Feldbeschriftung.
`name`	string	Anzeigename (in diesem Beispiel des Kundens, in anderen Fällen z.B. der Name der Stadt, in der der Kunde wohnt).
`validations`	array	Definiert die Liste der Validierungsregeln, die auf das jeweilige Adressfeld angewendet werden
`options`	array	Definiert die Parameter oder Einstellungen, die eine Validierungsregel benötigt – z. B. Grenzwerte, erlaubte Zeichen oder Bedingungen.
`len`	int	Gibt im Beispiel die maximal zulässige Zeichenlänge für die Validierung an.
`service`	string	Bezeichnet den verwendeten Validierungsdienst, der die eigentliche Prüfung durchführt – hier z. B. `addressCheck.maxLength` zur Kontrolle der maximalen Feldlänge.

6. `accounts.autoLogin` - Angemeldet bleiben

Steuert das „Angemeldet bleiben“-Verhalten (Auto-Login) für Kundenkonten: Aktivierung, Ablaufzeiten und Reaktionen auf Sonderfälle.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter Einstellungen → Shop-Konfiguration und der Gruppe Login & Anmeldung.

Beispielkonfiguration für alle Subshops (`accounts.autoLogin`)

{
  "actions": null,
  "active": true,
  "errorCodes": {
    "actionRequiresLogin": ""
  },
  "expireTimesInDays": {
    "cookie": 30,
    "noAutoLogin": 10,
    "noPasswordLogin": 20
  },
  "restriction": "notAllowed"
}

Parameterbeschreibung

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`active`	bool	Aktiviert (`true`) oder deaktiviert (`false`) die Auto-Login-Funktion insgesamt.
`restriction`	enum	Richtlinie für Auto-Login. Wert `notAllowed`: Auto-Login ist untersagt (keine dauerhafte Sitzung). Weitere Werte sind systemspezifisch vorbelegt.
`expireTimesInDays`	object	Sammelobjekt mit Ablaufzeiten (in Tagen) für unterschiedliche Szenarien.
`cookie`	uint	Gültigkeitsdauer des Auto-Login-Cookies in Tagen. Nach Ablauf ist ein regulärer Login erforderlich. Default: 30
`noAutoLogin`	uint	Maximale Inaktivitätsdauer in Tagen ohne Auto-Login; nach Ablauf wird keine automatische Anmeldung mehr versucht. Default: 10
`noPasswordLogin`	uint	Zeitraum in Tagen, nach dem trotz bestehendem Auto-Login eine Passwort-Eingabe erzwungen wird (z. B. als Re-Auth). Default: 20
`errorCodes`	object	Objekt für spezielle Fehlerzustände.
`actionRequiresLogin`	string	Schlüssel/Code für den Fall, dass eine Aktion eine erneute Anmeldung erfordert.
`actions`	list	Liste der Aktionen, die während eines automatischen Logins ohne erneute Passwortabfrage erlaubt sind. Damit lässt sich gezielt festlegen, was Kunden im angemeldeten Zustand nutzen dürfen, ohne sich erneut anzumelden. Beispielsweise kann so der Zugriff auf unkritische Funktionen wie die Merkliste erlaubt werden, während sicherheitsrelevante Aktionen (z. B. Warenkorb- oder Bestellvorgänge) weiterhin eine erneute Anmeldung erfordern. Beispiele für erlaubte Aktionen: `WatchListAdd` → neue Merkliste anlegen `WatchListDelete` → Merkliste löschen

accounts - Benutzerkonten

Inhaltsverzeichnis

1. accounts* - Grundstruktur

Parameterbeschreibungen

2. accounts.account - Benutzerkonto

Beispielkonfiguration für alle Subshops (accounts.account)

Parameterbeschreibungen

3. accounts.accountRestrictions - Subshopbeschränkungen für Benutzerkonten

Beispielkonfiguration für alle Subshops (accounts.accountRestrictions)

Parameterbeschreibungen

4. accounts.addressFieldsSettings - Allgemeine Adressfelder-Einstellungen

Beispielkonfiguration für alle Subshops (accounts.addressFieldsSettings)

Parameterübersicht

5. accounts.addressField - Einzelne Adressfelder definieren

Beispielkonfiguration für alle Subshops (accounts.addressField.firstName)

Parameterübersicht

6. accounts.autoLogin - Angemeldet bleiben

Beispielkonfiguration für alle Subshops (accounts.autoLogin)

Parameterbeschreibung

1. `accounts*` - Grundstruktur

2. `accounts.account` - Benutzerkonto

Beispielkonfiguration für alle Subshops (`accounts.account`)

3. `accounts.accountRestrictions` - Subshopbeschränkungen für Benutzerkonten

Beispielkonfiguration für alle Subshops (`accounts.accountRestrictions`)

4. `accounts.addressFieldsSettings` - Allgemeine Adressfelder-Einstellungen

Beispielkonfiguration für alle Subshops (`accounts.addressFieldsSettings`)

5. `accounts.addressField` - Einzelne Adressfelder definieren

Beispielkonfiguration für alle Subshops (`accounts.addressField.firstName`)

6. `accounts.autoLogin` - Angemeldet bleiben

Beispielkonfiguration für alle Subshops (`accounts.autoLogin`)