Installazione di Mirakl Connector

Requisiti

Installazione e utilizzo dell’applicazione richiedono quanto segue:

• PHP 7.3+
• PostgreSQL
• Un server web, Nginx consigliato
• Un certificato SSL/TLS valido
• Supervisord o equivalente
• Crontab o equivalente

Eseguire l’installazione tramite Docker

Puoi implementare e avviare l’applicazione integrandola in un contenitore. Per ulteriori informazioni, consulta il Docker di esempio.

Eseguire l’installazione manuale

1. Installa Composer.
2. Clona o scarica Mirakl Connector da GitHub.
3. Sposta i contenuti nella directory del server web, ad esempio /var/www.
4. Scarica le dipendenze:

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

1. Verifica di aver configurato correttamente il file .env.
2. Esegui le migrazioni per configurare il database:

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

Se incontri errori in questa fase, controlla la variabile DATABASE_URL nel file .env.

1. Aggiorna il supervisore per avviare e riavviare i lavoratori.

Un esempio di configurazione è disponibile nel campione Docker. Puoi ignorare questa fase in un ambiente di sviluppo e avviare i lavoratori manualmente ove necessario, ad esempio:

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

1. Aggiorna il pianificatore lavori per eseguire i comandi periodicamente.

Un esempio di configurazione è disponibile nel campione Docker. Puoi ignorare questa fase in un ambiente di sviluppo e avviare i lavori manualmente ove necessario, ad esempio:

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

1. Assicurati che il server web sia stato configurato in modo da utilizzare la directory public come radice documento.

Verificare l’installazione

Apri un terminale ed esegui il comando che segue per verificare che l’applicazione sia in esecuzione:

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

Dovresti ricevere il codice di risposta 200 insieme a un payload vuoto.

Sicurezza

Sul server, limita tutto il traffico in ingresso verso il connettore ad eccezione dei seguenti endpoint:

• /api/public/onboarding/refresh

  Stripe reindirizza il venditore a questo URL per ottenere un nuovo link di attivazione qualora dovesse scadere.

• /api/public/webhook/operator

  Stripe invia un avviso all’endpoint quando un pagamento viene aggiornato per mapparlo con un ordine Mirakl nel connettore.

• /api/public/webhook/sellers

  Stripe invia una notifica a questo endpoint quando un account Stripe viene aggiornato per sincronizzare lo stato del venditore nel connettore.

Questi endpoint possono essere esposti in tutta sicurezza poiché dispongono di un meccanismo di protezione interno. Altri endpoint non possono essere esposti in sicurezza se non sono protetti da un valore OPERATOR_PASSWORD.