Mirakl Connector のインストール
Stripe 用の Mirakl コネクターをインストールして検証します。
要件
アプリケーションをインストールして実行するには、次の要件を満たす必要があります。
- PHP 7.3 以上
- PostgreSQL
- Web サーバ (Nginx 推奨)
- 有効な SSL/TLS 証明書
- Supervisord または同等のもの
- Crontab または同等のもの
Docker を使用したインストール
アプリケーションをコンテナに埋め込むことで、アプリケーションを構築および開始できます。詳細については、Docker サンプルを参照してください。
手動インストール
- Composer をインストールします。
- Mirakl コネクターを GitHub から複製またはダウンロードします。
- コンテンツを
/var/www
のような Web サーバーディレクトリーに移動します。 - 従属性をダウンロードします。
composer install --prefer-dist --no-dev
- .env ファイルが正しく設定されていることを確認してください。
- 移行を実行してデータベースを設定します。
bin/console doctrine:migration:migrate --no-interaction
この段階でエラーが発生した場合は、.env ファイルの DATABASE_
変数を確認してください。
- Supervisor を更新して、ワーカーを自動的に開始および再起動します。
設定例は、Docker サンプルで確認できます。開発環境ではこのステップをスキップし、必要に応じて手動でワーカーを起動できます。次に例を示します。
php bin/console messenger:consume process_transfers --time-limit=3600 --env=prod
- コマンドを定期的に実行するようにジョブスケジューラを更新します。
設定例は、Docker サンプルで確認できます。開発環境ではこのステップをスキップし、必要に応じて手動でジョブを起動できます。次に例を示します。
php bin/console connector:dispatch:process-transfer -q 2>&1
- Web サーバがドキュメントルートとして
public
ディレクトリを使用するように設定されていることを確認してください。
インストールの確認
端末を開き、次のコマンドを実行して、アプリケーションが正しく実行されていることを確認します。
curl -X GET "https://connector-url/api/mappings" \ -H "accept: application/json" \ -H "X-AUTH-TOKEN:
"$OPERATOR_PASSWORD
空のペイロードとともに 200
レスポンスコードを取得する必要があります。
セキュリティ
サーバでは、次のエンドポイントを除いて、コネクタに「すべてのインバウンドトラフィックを制限します」。
/api/public/onboarding/refresh
Stripe は、有効期限が切れている場合には新しいアカウント登録リンクを取得するために、売り手をこの URL にリダイレクトします。
/api/public/webhook/operator
支払いが更新されてコネクタ内の Mirakl の注文にマッピングされると、Stripe はこのエンドポイントに通知します。
/api/public/webhook/sellers
Stripe アカウントが更新されてコネクタ内の売り手のステータスが同期化されると、Stripe はこのエンドポイントに通知します。
上記のエンドポイントは安全に公開でき、各エンドポイントは内部保護メカニズムを備えています。他のエンドポイントは、強力な OPERATOR_
で保護されていない限り、安全に公開できません。
参照情報
- 導入手順。