システム設計

ブラウザに配達させない:中継 API に取りに来てもらう方式

業務システムのサーバーが外へ通信できないとき、画面の JavaScript にデータを送らせる方法があります。ただ、ブラウザは確実な配達係ではなく、取りこぼし対策を入れても限界があります(ブラウザは「確実な配達係」ではない、送りそこねと 2 重登録を防ぐ:送信待ちテーブルと冪等性)。この記事では、構成を変えられる場合の、より確実な方法を紹介します。

ブラウザに配達させることの限界

取りこぼしの対策をすべて入れても、ブラウザを配達係にする限り、次の問題は残ります。

  • 送られるタイミングが利用者しだい:画面を開いている人がいるときしか送られません。夜間の一括処理のようなこともできません。
  • 送るデータを利用者が書き換えられる:開発者ツールを使えば、送る前にデータを変えられます。業務システムのサーバーが送信データに署名を付け、中継 API で確かめる、などの対策が必要になります。
  • 中継 API が誰でも呼べる入口になりやすい:ブラウザから呼べる以上、認証を付ける、決まった連携先にしか送らない作りにする、などが欠かせません。

取りに来てもらう

業務システムが外へ通信できなくても、外から呼ばれることはできるなら、向きを逆にします。中継 API の方から、業務システムの「未送信」を取りに来てもらう方法です。

業務システム中継 API連携先の API 保存時に「未送信」を記録 ① 数秒ごとに「未送信ある?」 ② 未送信のデータを返す ③ 登録(失敗したら再送) ④「この ID は送信済み」 ⑤ 記録を「送信済み」に変える

業務システムは呼ばれて答えるだけで、自分からは通信しません。ブラウザに頼らないので、タブを閉じても、夜間でも送られます。

この方式の良いところ

ブラウザに配達させる場合取りに来てもらう場合
画面を開いている人がいないと送られないいつでも送られる
利用者がデータを書き換えられるブラウザを通らないので書き換えられない
中継 API をブラウザに公開する必要がある中継 API をブラウザから呼べるようにしなくてよい

送信待ちテーブルと冪等性は、この方式でもそのまま使えます。中継 API が途中で止まっても、記録は「未送信」のまま残り、次に取りに来たときに送られます。

使える条件

この方式は、中継 API から業務システムへの通信が許されていることが前提です。業務システムが「外へは出られないが、決まった相手からは呼ばれてよい」というネットワークなら使えます。外からも一切呼べない場合は、ブラウザに配達させる構成のまま、取りこぼし対策をしっかり入れることになります。

まとめ

  • ブラウザを配達係にする限り、送るタイミング・データの書き換え・入口の公開という問題が残る。
  • 構成を変えられるなら、中継 API から取りに来てもらう方式が確実。
  • ただし、中継 API から業務システムを呼べることが条件になる。
スポンサーリンク
タイトルとURLをコピーしました