Installation du connecteur Mirakl

Conditions requises

L’installation et l’exécution de l’application nécessite ce qui suit :

• PHP 7.3+
• PostgreSQL
• Un serveur Web, de préférence Nginx
• SSL/certificat TLS valide
• Supervisord ou équivalent
• Crontab ou équivalent

Installer à l’aide de Docker

Pour créer et lancer l’application, vous pouvez l’intégrer à un conteneur. Pour en savoir plus, consultez exemple de Docker.

Installer manuellement

1. Installez Composer.
2. Clonez ou téléchargez le connecteur Mirakl depuis GitHub.
3. Déplacez le contenu vers le répertoire de votre serveur Web, par exemple/var/www.
4. Télécharger les dépendances :

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

1. Vérifiez que vous avez configuré correctement le fichier .env.
2. Exécutez les migrations pour configurer la base de données :

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

Si vous rencontrez des erreurs à ce stade, vérifiez la variable DATABASE_URL dans votre fichier .env.

1. Mettez votre superviseur à jour afin de lancer et de relancer automatiquement les traitements.

Notre exemple de Docker comprend un exemple de configuration. Dans un environnement de développement, vous pouvez ignorer cette étape et lancer les traitements manuellement si nécessaire, par exemple :

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

1. Mettez à jour votre planificateur de tâches afin d’exécuter régulièrement les commandes.

Notre exemple de Docker comprend un exemple de configuration. Dans un environnement de développement, vous pouvez ignorer cette étape et commencer les tâches manuellement si nécessaire, par exemple :

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

1. Veillez à ce que votre serveur Web soit configuré pour utiliser le répertoire public en tant que document racine.

Vérifiez votre installation

Ouvrez votre terminal et exécutez la commande suivante afin de vérifier que votre application fonctionne correctement :

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

Vous devez obtenir un code de réponse 200 ainsi qu’une charge utile nulle.

Sécurité

Sur votre serveur, limitez tout le trafic entrant vers le connecteur, sauf pour les points de terminaison suivants :

• /api/public/onboarding/refresh

  Stripe redirige le marchand vers cette URL pour lui permettre d’obtenir un nouveau lien d’inscription si celui-ci expire.

• /api/public/webhook/operator

  Stripe notifie cet point de terminaison lorsqu’un paiement est mis à jour afin de le faire correspondre à une commande Mirakl dans le connecteur.

• /api/public/webhook/sellers

  Stripe notifie cet point de terminaison lorsqu’un compte Stripe est mis à jour afin de synchroniser l’état du marchand dans le connecteur.

Ces points de terminaison peuvent être exposés sans risque, car chacun d’entre eux dispose d’un mécanisme de protection interne. L’exposition des autres points de terminaison comporte des risques, sauf si ceux-ci sont protégés par un OPERATOR_PASSWORD fort.