> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# actions - Anmeldung & Registrierung

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

export const TextbausteinHinweis = () => <>
    Dieser Text wird über einen Textbaustein realisiert.<br />
    Alles zu Textbausteinen in Konfigurationen finden Sie{" "}
    <a href="https://dokumentation.websale.de/konfiguration#verwendung-von-textbausteinen-in-konfigurationen">hier</a>.
  </>;

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](/konfiguration/actions-fehlertexte-e-mails/actions-alphabetische-ubersicht).

#### Auszug der Grundstruktur `actions`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "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**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "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. <br /><br /><TextbausteinHinweis /> |
| `actionNotAllowed` | string | Fehlermeldung, die ausgegeben wird, wenn der Double-Opt-In-Token ungültig ist. <br /><br /><TextbausteinHinweis />                              |

***

## `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

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "active": true
}
```

#### Parameterübersicht

| **Parameter** | **Typ** | **Beschreibung**                                                                                |
| ------------- | ------- | ----------------------------------------------------------------------------------------------- |
| `active`      | bool    | Aktiviert bzw. deaktiviert die serverseitige Prüfung der Passwortstärke.  <br />Default: `true` |

***

## `actions.login` - Anmeldung

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

#### Beispielkonfiguration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "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. <br /><br /><TextbausteinHinweis />                                                                                                                       |
| `missingPassword`        | string  | Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde. <br /><br /><TextbausteinHinweis />                                                                                                                                              |
| `emailCheckFailed`       | string  | Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wird. <br /><br /><TextbausteinHinweis />                                                                                                                     |
| `loginBlocked`           | string  | Fehlermeldung, die ausgegeben wird, wenn das Benutzerkonto vorübergehend gesperrt ist. <br /><br /><TextbausteinHinweis />                                                                                                                                 |
| `invalidCredentials`     | string  | Fehlermeldung, die ausgegeben wird, wenn die Kombination aus E-Mail-Adresse und Passwort nicht stimmt. <br /><br /><TextbausteinHinweis />                                                                                                                 |
| `ipAddressBlocked`       | string  | Fehlermeldung, die ausgegeben wird, wenn die aktuelle IP-Adresse blockiert ist (Blacklist). <br /><br /><TextbausteinHinweis />                                                                                                                            |
| `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](/konfiguration/accounts-benutzerkonten) → `duplicate`). <br /><br /><TextbausteinHinweis /> |

***

## `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

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "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). <br /><br /><TextbausteinHinweis /> |

***

## `actions.passwordForgotten` - Passwort vergessen

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

#### Beispielkonfiguration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "email": {
    "template": "password_forgotten.htm",
    "subject": "Passwort zurücksetzen",
    "fromAddress": "noreply@meinshop.de",
    "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](/konfiguration/e-mails-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. <br /><br /><TextbausteinHinweis />                                                                                                                                  |
| `emailCheckFailed`       | string  | Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde. <br /><br /><TextbausteinHinweis />                                                                                                               |
| `passwordRecoveryFailed` | string  | Fehlermeldung, die ausgegeben wird, wenn der Passwort-Reset fehlschlägt. <br /><br /><TextbausteinHinweis />                                                                                                                                          |

***

## `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

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "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.   <br />Default: `true`                                     |
| `checkOldPassword`    | bool    | Gibt an, ob zur Änderung des Passworts zusätzlich das bisherige Passwort abgefragt und geprüft werden soll.   <br />Default: `true`                        |
| `checkLoginID`        | bool    | Wenn `true`, wird zusätzlich geprüft, ob die angegebene Login-ID/E-Mail mit dem Konto übereinstimmt.   <br />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. <br /><br /><TextbausteinHinweis />                                            |
| `missingEmail`        | string  | Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde. <br /><br /><TextbausteinHinweis />                                       |
| `emailMismatch`       | string  | Fehlermeldung, die ausgegeben wird, wenn die alte E-Mail-Adresse nicht korrekt übergeben wurde. <br /><br /><TextbausteinHinweis />                        |
| `missingPassword`     | string  | Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde. <br /><br /><TextbausteinHinweis />                                              |
| `passwordMismatch`    | string  | Fehlermeldung, die ausgegeben wird, wenn Passwort und Passwort-Bestätigung nicht übereinstimmen. <br /><br /><TextbausteinHinweis />                       |
| `missingPasswordAuth` | string  | Fehlermeldung, die ausgegeben wird, wenn das aktuelle Passwort als Bestätigung erforderlich, aber nicht angegeben ist. <br /><br /><TextbausteinHinweis /> |
| `failedPasswordAuth`  | string  | Fehlermeldung, die ausgegeben wird, wenn das eingegebene, aktuelle Passwort, nicht korrekt ist. <br /><br /><TextbausteinHinweis />                        |
| `passwordCheckFailed` | string  | Fehlermeldung, die ausgegeben wird, wenn das Passwort die Mindestanforderungen nicht erfüllt. <br /><br /><TextbausteinHinweis />                          |


## Related topics

- [actions - Warenkorb & Checkout](/konfiguration/actions-fehlertexte-e-mails/actions-warenkorb-checkout.md)
- [actions - Alphabetische Übersicht](/konfiguration/actions-fehlertexte-e-mails/actions-alphabetische-ubersicht.md)
- [Anmeldung & Benutzerverwaltung von strapi](/strapi-cms/anmeldung-benutzerverwaltung-von-strapi.md)
- [accounts - Benutzerkonten](/konfiguration/accounts-benutzerkonten.md)
- [actions -  Fehlertexte & E-Mails](/konfiguration/actions-fehlertexte-e-mails.md)