Installation des Mirakl Connectors

Voraussetzungen

Zum Installieren und Ausführen der Anwendung ist Folgendes erforderlich:

• PHP 7.3+
• PostgreSQL
• Ein Webserver, Nginx wird empfohlen
• Ein gültiges SSL/TLS-Zertifikat
• Supervisord oder vergleichbar
• Crontab oder vergleichbar

Mithilfe von Docker installieren

Sie können die Anwendung erstellen und starten, indem Sie sie in einen Container einbetten. In unserem Docker-Beispiel finden Sie weitere Informationen.

Manuell installieren

1. Installieren Sie Composer.
2. Kopieren Sie den Mirakl Connector von GitHub oder laden Sie ihn von dort herunter.
3. Verschieben Sie den Inhalt in das Webserver-Verzeichnis, z. B. /var/www.
4. Laden Sie Abhängigkeiten herunter:

composer install --prefer-dist --no-dev

1. Stellen Sie sicher, dass die ENV-Datei ordnungsgemäß konfiguriert ist.
2. Führen Sie die Migrationen aus, um die Datenbank einzurichten:

bin/console doctrine:migration:migrate --no-interaction

Wenn in dieser Phase Fehler auftreten, überprüfen Sie die Variable DATABASE_URL in Ihrer .env-Datei.

1. Aktualisieren Sie den Supervisor, um die Worker automatisch zu starten und neu zu starten.

Ein Konfigurationsbeispiel finden Sie in unserem Docker-Beispiel. In einer Entwicklungsumgebung können Sie diesen Schritt überspringen und die Worker bei Bedarf manuell starten:

php bin/console messenger:consume process_transfers --time-limit=3600 --env=prod

1. Aktualisieren Sie Ihren Job-Scheduler, um die Befehle regelmäßig auszuführen.

Ein Konfigurationsbeispiel finden Sie in unserem Docker-Beispiel. In einer Entwicklungsumgebung können Sie diesen Schritt überspringen und die Jobs bei Bedarf manuell starten:

php bin/console connector:dispatch:process-transfer -q 2>&1

1. Stellen Sie sicher, dass Ihr Webserver so konfiguriert ist, dass das Verzeichnis public als Dokumenten-Stammverzeichnis verwendet wird.

Installation prüfen

Öffnen Sie Ihr Terminal und führen Sie folgenden Befehl aus, um zu prüfen, ob Ihre Anwendung korrekt ausgeführt wird:

curl -X GET "https://connector-url/api/mappings" \
  -H "accept: application/json" \
  -H "X-AUTH-TOKEN: 
$OPERATOR_PASSWORD
"

Sie sollten den Antwortcode 200 zusammen mit einer leeren Nutzlast erhalten.

Sicherheit

Schränken Sie auf Ihrem Server den gesamten eingehenden Datenverkehr zum Connector ein, mit Ausnahme der folgenden Endpoints:

• /api/public/onboarding/refresh

  Stripe leitet die Verkäufer/innen am Ende des Onboardings zu dieser URL weiter, um einen neuen Onboarding-Link zu erhalten, wenn er abläuft.

• /api/public/webhook/operator

  Stripe benachrichtigt diesen Endpoint, wenn eine Zahlung aktualisiert wird, damit sie einer Mirakl-Bestellung innerhalb des Connectors zugeordnet werden kann.

• /api/public/webhook/sellers

  Stripe benachrichtigt diesen Endpoint, wenn ein Stripe-Konto aktualisiert wird, damit der Status der Verkäuferin/des Verkäufers innerhalb des Connectors synchronisiert werden kann.

Diese Endpoints können bedenkenlos bereitgestellt werden, da sie jeweils einen internen Schutzmechanismus haben. Andere Endpoints sollten aus Sicherheitsgründen nicht bereitgestellt werden, wenn sie nicht durch ein starkes OPERATOR_PASSWORD geschützt sind.