Skip to main content

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.

Der Konfigurationsbereich authentication dient der Verwaltung von Authentifizierungsinformationen und Zugangsdaten für externe Dienste, Schnittstellen oder Systeme. Über diesen Bereich können zukünftig verschiedene Authentifizierungsprovider (z. B. Google, Apple, Microsoft oder eigene OAuth-Dienste) eingebunden werden. Jede Authentifizierungseinheit wird dabei als eigener Eintrag mit individuellen Parametern konfiguriert. Aktuell steht die Konfiguration für Google OAuth 2.0 zur Verfügung, die über den Eintrag
authentication.googleOAuthKey.FCMKey die Zugangsdaten eines Google-Service-Accounts für Firebase Cloud Messaging (FCM) verwaltet.

​
authentication* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens authentication 
{
    "authentication": {
      "googleOAuthKey": {...}
    }
}

​
Parameterübersicht

ParameterBeschreibung
googleOAuthKeyAuthentifizierung für Firebase Cloud Messaging

​
authentication.googleOAuthKey.FCMKey - Authentifizierung für Firebase Cloud Messaging

Damit das Shopsystem Push-Nachrichten z. B. über die App oder den Browser senden kann, benötigt es eine Authentifizierung gegenüber Firebase. Der Konfigurationsabschnitt authentication.googleOAuthKey.FCMKey enthält die Zugangsdaten für den Google-Service-Account, der für die Authentifizierung gegenüber Firebase Cloud Messaging (FCM) verwendet wird. Diese Daten ermöglichen es dem System, Push-Benachrichtigungen über die Google-Infrastruktur zu senden oder andere FCM-bezogene Aktionen automatisiert durchzuführen. Jeder Eintrag stellt die vollständigen Authentifizierungsinformationen des Service-Accounts bereit, einschließlich Projekt-ID, Client-E-Mail, privatem Schlüssel und den zugehörigen OAuth-Endpoints.

​
Beispielkonfiguration

{
  "authProviderX509CertUrl": "https://www.googleapis.com/oauth2/v1/certs",
  "authUri": "https://accounts.google.com/o/oauth2/auth",
  "clientEmail": "<CLIENTEMAIL>",
  "clientId": "<CLIENTID>",
  "clientX509CertUrl": "https://www.googleapis.com/robot/v1/metadata/x509/<CLIENTEMAIL>",
  "name": "FCM Service Account",
  "privateKey": "<PRIVATEKEY>",
  "privateKeyId": "<PRIVATEKEYID>",
  "projectId": "<PROJECTID>",
  "tokenUri": "https://oauth2.googleapis.com/token",
  "type": "service_account",
  "universeDomain": "googleapis.com"
}

​
Parameterübersicht

ParameterTypBeschreibung
authProviderX509CertUrlstringURL, über die die öffentlichen Zertifikate der Authentifizierung bereitgestellt werden.
authUristringStandard-URL für das OAuth-Token-Handling bei Google.
clientEmailstringE-Mail-Adresse des Service-Accounts.
clientIdstringInterne ID des Service-Accounts.
clientX509CertUrlstringURL, über die die öffentlichen Zertifikate der Authentifizierung bereitgestellt werden.
namestringAnzeigename des Service-Accounts im System.
privateKeystringPrivater Schlüssel des Service-Accounts (dient zur Signierung der Token).
privateKeyIdstringSchlüssel-ID des Service-Accounts (dient zur Signierung der Token).
projectIdstringID des zugehörigen Firebase-/Google-Cloud-Projekts.
tokenUristringStandard-URLs für das OAuth-Token-Handling bei Google
typestringTyp des Authentifizierungsobjekts – hier immer service_account.
universeDomainstringGoogle-spezifischer Namespace (Standard: googleapis.com).