Instalación de Mirakl Connector

Requisitos

Para instalar y ejecutar la aplicación hace falta lo siguiente:

• PHP 7.3, o superior
• PostgreSQL
• Un servidor web, se recomienda Nginx
• Un certificado SSL/TLS válido
• Supervisord o equivalente
• Crontab o equivalente

Instalar con Docker

Puedes crear e iniciar la aplicación integrándola en un contenedor. Para obtener más información, consulta nuestra muestra de Docker.

Instalar manualmente

1. Instala Composer.
2. Clona o descarga Mirakl Connector de GitHub.
3. Mueve el contenido del directorio de tu servidor web, por ejemplo, /var/www.
4. Descarga las dependencias:

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

1. Make sure you properly configured the .env file.
2. Ejecuta las migraciones para configurar la base de datos:

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

Si encuentras algún error en esta etapa, comprueba la variable DATABASE_URL de tu archivo .env.

1. Actualiza tu supervisor para iniciar y reiniciar automáticamente los trabajadores.

En nuestro ejemplo de Docker hay un ejemplo de configuración. En el entorno de desarrollo puedes saltarte este paso e iniciar los trabajadores manualmente cuando lo necesites, por ejemplo:

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

1. Actualiza tu programador de trabajos para que ejecute periódicamente los comandos.

En nuestro ejemplo de Docker hay un ejemplo de configuración. En el entorno de desarrollo puedes saltarte este paso e iniciar los trabajos manualmente cuando lo necesites, por ejemplo:

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

1. Asegúrate de que tu servidor web esté configurado para usar el directorio public como directorio raíz de documentos.

Comprueba tu instalación

Abre tu Terminal y ejecuta el siguiente comando para confirmar que tu aplicación está funcionando correctamente:

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

Deberías recibir un código de respuesta 200 junto con una carga vacía.

Seguridad

En tu servidor, restringe todo el tráfico de entrada al conector, excepto para los siguientes puntos de conexión:

• /api/public/onboarding/refresh

  Stripe redirige el vendedor a esta URL para obtener un nuevo enlace para el onboarding en caso de que caduque.

• /api/public/webhook/operator

  Cuando se actualiza un pago, Stripe se lo notifica a este punto final para que lo asigne a un pedido de Mirakl de dentro del conector.

• /api/public/webhook/sellers

  Cuando se actualiza una cuenta, Stripe se lo notifica a este punto final para que sincronice el estado del vendedor de dentro del conector.

Es seguro exponer estos puntos de conexión, ya que cada uno tiene un mecanismo de protección interno. No es seguro exponer otros puntos de conexión si no están protegidos por una OPERATOR_PASSWORD segura.