IOSOR ガイド
組み込みテナント上限で送信を即座に停止すべき理由
ISV プロダクト内の公平な分配上限は、上限到達時に偽の API 200 配信成功を返さず、該当テナントの送信を確実にハード停止する必要があります。
組み込み型マルチテナント SaaS では、1つの高負荷なテナントが共有のプリペイド残高を枯渇させたり他のテナントに影響を与えたりしないよう、公平な分配上限(フェアシェアキャップ)が必要です。ダッシュボードに警告を表示するだけで API が送信を受け付け続ける上限設定は意味を成しません。テナントが上限に達した場合、明確なエラーと該当する API ステータスを返し、そのテナントの送信を完全に停止する必要があります。偽の 200 配信成功レスポンスは会計処理を破壊し、不正利用を招きます。
上限は Partner のサブテナントレート制限の代用ではなく、キューからの無効な無黙削除の口実でもありません。適切な停止処理とは、SaaS UI に一時停止や上限到達を表示し、組み込みサービスがそのテナント ID からの新規送信を拒否し、運用チームが上限到達ログを出力できる状態を指します。
パイロットトラフィックの開始前に停止定義を策定してください:上限単位(メッセージ数 / 支出額 / 日)、リセットウィンドウ、上限引き上げの承認者、およびエンドユーザーへの表示内容。
上限到達は送信拒否を意味し、いつまでもソフト警告を出さない
ソフト警告は初期のアラートに過ぎません。ハード上限に達した時点で、組み込みサービスはテナント上限エラーを返し、新規の送信目的でメッセージング API を呼び出さないようにします。処理中の既存メッセージは完了できますが、新規の OTP やキャンペーン送信はリセットまたは承認された上限引き上げまで待機します。
拒否ログにはテナント ID、適用ルール、タイムスタンプを記録してください。顧客から送信障害の問合せがあった際、サポートチームはこのログ行を必要とします。
上限に達したパスで配信成功を偽造しない
| レスポンス | 許可される条件 | 禁止される条件 |
|---|---|---|
| プロダクト上限到達 / 一時停止 | ハード上限到達時 | 上限拒否パス |
| HTTP エラー / マッピングエラー | 上限による拒否時 | — |
| 配信完了 / 200 成功 | 正常受領パス | 上限拒否パス |
| サイレントドロップ | 許可しない | 常に禁止 |
サイレントドロップや偽の 200 応答は、成功を装うキュー溢れと同じです。スケーリング基盤は溢れ防止をカバーしますが、ここでのトリガーは ISV 内部のテナント公平分配ルールです。
プロダクト上限をウォレット停止ラインと一致させる
特定のテナントが自身の分配上限以下であっても、ISV 全体のウォレット停止ラインが赤信号になる場合があります。その場合、該当テナントだけでなく組み込みパス全体が一時停止します。ウォレットに残高があっても上限を超過したテナントを救済することはできません。ステータス表現を統一してください:テナント上限到達 vs アカウント一時停止 vs 両方。
上限引き上げリクエストには指定された承認者が必要です。セルフサービスによる無制限な引き上げは公平分配の原則を損ないます。
ステージング環境で高負荷テナントを使用して停止動作をテストする
本番稼働前にステージングテストを実施します。1つのテナントが上限に達するまで OTP を大量送信し、他のテナントが正常に送信を続けられること、出力ログに偽の配信成功がなく拒否行のみが記録されることを確認します。他のテナントまで停止する場合はスコープ設定の誤りであり、高負荷テナントに緑の成功マークが表示され続ける場合は停止処理が機能していません。
関連する運用パス
IOSORで始める
IOSOR コンソールを開き、サブテナントのフェアシェア制限を設定して、上限に達した際に送信ゲートで強制的に拒否されるようにします。上限に達したテナントが正常なペイロードの代わりに明示的なステータスエラーを受け取るよう、API レスポンスのマッピングを構成してください。負荷の高いテナントを使用してステージングテストを実行し、制限された送信が明示的な拒否ログエントリとして記録される一方で、他のテナントのトラフィックが正常に流れることを確認します。
IOSORの要点
単一のサブテナントが急増した場合、緩やかな警告では下流のキューを保護できません。この運用ガイドでは、フェアシェアの上限が即座の送信ゲート拒否として機能し、テナントの上限到達とグローバルウォレットの停止ラインとの間に明確な境界を維持する必要があることが証明されました。
サブテナントが適切に制限の引き上げを要求できるように、制限されたステータスレスポンスをアプリケーション層に必ず返してください。上限に達した試行に対して偽の 200 受理や配信済み DLR を返さないようにしてください。偽の成功を生成すると実際の配信失敗が隠蔽され、テナントの監査性が損なわれます。
このガイドは役に立ちましたか?
関連ガイド
- API埋め込みとホワイトレーベル・パートナーポータルの比較
メッセージングを埋め込むSaaSプロダクトはISVサーフェス上に留まります。ホワイトレーベルのパートナーポータルはPartnerの下に配置し、ブランド、キー、運用所有権を混同しないでください。
- エンドユーザーの送信は引き続き単一のプリペイド元帳から引き落とされます
埋め込み送信は引き続きISVのプリペイドウォレットを減額します。製品が資金調達していない第2の元帳を捏造しないでください。保留、再試行、冪等性は正確に保たれます。