旅行APIの認証とセキュリティ:テナントのデータはどこから漏れるか

パートナー代理店の開発者が、火曜の午後に連携のテストをしています。予約一覧のエンドポイントがクエリ文字列で agencyId を受け取っていることに気づき、好奇心から114を115に変えてみます。返ってきたのは他社の予約でした。乗客名、PNR、そしてその代理店がマージンを上乗せする前に支払ったネット運賃まで含まれています。誰も何も攻撃していません。APIがクライアントの言うことをそのまま信じただけです。この一回の午後が 旅行APIの認証とセキュリティ のほぼすべてであり、このテーマがログイン画面に払われがちな注意よりも多くの注意に値する理由です。
マルチテナントの旅行APIが漏れる経路は、予測しやすい少数のパターンに集約されます。一つずつ名前を付けておく価値があります。それぞれに、公開前なら公開後よりはるかに安く済む設計上の答えがあるからです。
テナントはパラメータではない
冒頭の過ちは、チェックの抜けではありません。呼び出し側に「あなたは誰か」と尋ね、その答えを信じる設計そのものです。単一顧客のシステムなら、それは単に雑なだけで済みます。しかし数十の代理店、サブエージェント、ホワイトラベルサイトが一つのデータベースを共有するプラットフォームでは、キーを手にするすべての連携担当者の誠実さにセキュリティモデル全体が寄りかかることになります。
このバグの系統を丸ごと消すルールはこうです。テナントは認証情報から決まり、リクエストからは決まらない。 キーやトークンが検証されると、サーバーはそれがどのテナントに属し、そのテナント内のどの事業所で、呼び出し側がどのロールを持つかを確定します。以降のすべてのクエリはそのスコープ内で実行されます。リクエスト本文が正当な理由で代理店IDを運ぶことはあります。たとえばコンソリデーターが自社のサブエージェントに代わって予約を作成する場合です。ただしサーバーはそのIDを、認証情報がすでに確立したスコープと照合するだけで、フィールドが求めたからといってスコープを広げることはありません。
実際には、次の三つがサーバー側にあります。
- ハンドラごとではなく、データ層でのスコープ制限。 テナント所有のテーブルへのすべてのクエリに自動で適用されるフィルターがあれば、
where句を書き忘れた開発者が受け取るのは他人のデータではなく空の結果です。ハンドラごとのチェックは、誰かが急いでエンドポイントを追加した最初の瞬間に破綻します。 - パス内のすべてのIDに対するオブジェクト単位のチェック。
GET /bookings/98231は、予約98231が呼び出し側のスコープに属することを確認しなければなりません。連番のIDでは、これが旅行APIで最も多い穴です。予約番号やPNR参照は推測しやすいからです。 - 「あなたのものではない」と「存在しない」に同じ応答を返す。 他のテナントの予約には404を返してください。403は、そのレコードが実在することを裏付けてしまい、それだけで競合が欲しがる情報になります。
抜け道にも同じ規律が必要です。多くのプラットフォームには、サポート、経理、プラットフォーム所有者のように、テナントをまたいで読む運用者向けビューが要ります。それは、コードで付与され、使うたびに記録される独立したロールにしてください。認証済みの呼び出し側なら誰でも設定できるクエリフラグにしてはいけません。クライアント側の連携がこうした境界の周りでどう振る舞うべきかは、リクエスト側を扱った 航空券予約API連携 の記事をご覧ください。
サプライヤーの認証情報はブラウザに届かせない
旅行プラットフォームは二種類の秘密を持っています。一つ目はあなたのもの、つまりパートナーに発行するキーです。二つ目はサプライヤーとの関係に属するもので、GDSのオフィス認証情報、NDCアグリゲーターのトークン、ベッドバンクのAPIキーなどがあり、多くは御社名とIATA番号を記した契約に紐づいています。それらを使ったすべてのリクエストは、サプライヤーから見ればあなたからのリクエストです。
これらの認証情報が安全でいられる場所は一つだけ、呼び出し側に代わってサプライヤーと通信するサーバープロセスです。シングルページアプリのJavaScriptバンドル、モバイルアプリのバイナリ、「検索ページ用だけ」としてブラウザに配信される設定ファイル、サプライヤー呼び出しが失敗したときに返すエラーメッセージのいずれにも置いてはいけません。どれも、どこかで漏えい元になった場所です。ネットワークタブは誰でも開けますし、アプリのバイナリは望む人なら誰でも展開できます。
その影響は請求書より深刻です。サプライヤーキーが漏れると、見知らぬ人があなたのアカウントで検索し、場合によっては予約までできてしまいます。サプライヤーがあなたを評価するルックトゥブック比率が消費され、最悪の場合はあなたのクレジットで発券されます。サプライヤーはそのトラフィックをあなたのものと区別しません。よくある結末は、あなたの仕業ではないと証明する間のアカウント停止であり、特定の航空会社や一つのベッドバンクを主力に売る代理店にとっては、その間ずっと店を閉めることを意味します。
ここから小さなルールが二つ導かれます。リクエストがどのサプライヤーアカウントを通るかをクライアントが選ぶことはなく、サーバーがテナントの設定から選びます。そして、サプライヤーのエラー本文はAPIの外に出す前に変換します。サプライヤーの生のエラーは、リクエストヘッダーをそのまま返してくることがあるからです。
ネット運賃が漏れると実際いくらかかるか
開発者はデータ漏えいを、データがどれだけ個人的かで順位づけしがちです。旅行流通で商業的に最も危険なフィールドは、しばしば価格です。ネット運賃は、一般に見せないことを条件にサプライヤーがあなたに約束した金額で、販売価格との差があなたとサブエージェントのマージンです。下の表は大まかな順位づけです。自社の事業では行の重みづけが違うかもしれません。その意見の相違は、事故の最中ではなく事故の前にチームと話し合う価値があります。
| 何が漏れるか | 通常は誰が見つけるか | 自社にとっての代償 |
|---|---|---|
| B2C検索レスポンス内のネット運賃(JSONに隠れていて画面には出ない) | スクレイピングする競合、好奇心のある顧客 | サプライヤーからの価格パリティの苦情、公表価格で払った理由を尋ねる顧客 |
| 他のサブエージェントのマージンやネット価格 | 情報を突き合わせるサブエージェント | ネットワーク全体で価格が再交渉に。良い条件を得た代理店が話題の中心に |
| クライアントバンドル内のサプライヤー認証情報 | 見た人なら誰でも | 自社アカウント上のトラフィックと予約、調査中の停止の可能性 |
| 列挙できる予約IDやPNR | スクレイパー、ときに記者 | 乗客データの露出。規制上の重みは商業的損失をはるかに超える |
| 他の代理店のクレジット上限と残高 | パートナー、競合 | ネットワーク内で最も弱いアカウントが引き抜きの標的に |
チームが見落とすのは一行目です。画面は正しく見えるからです。ページには販売価格が表示されますが、それを供給したレスポンスには、フロントエンドが「必要かもしれない」という理由で、ネットとマージンが別フィールドとして載っています。レスポンスはサーバー側で対象ごとに整形してください。B2Cの呼び出し側が受け取るのは販売価格だけで、引き算を可能にするものは何も含めません。サブエージェントへのネット運賃の配布 の記事では、その差こそがコンソリデーターの売り物である理由を説明しています。
ダウンタイムなしで認証情報をローテーションする
すべての認証情報は、いずれ交換が必要になります。開発者がパートナー代理店を辞める、キーが公開リポジトリで見つかる、サプライヤーが独自のスケジュールでキーを更新する。ローテーションが「変えるとパートナーが再デプロイするまですべてが壊れる」ことを意味するなら、誰もローテーションせず、キーは何年も生き続けます。
初日から重なり期間を前提に設計してください。各パートナーは有効なキーを同時に二つ持てます。新しいキーを作り、デプロイし、トラフィックが移るのを確認してから、古いキーを失効させます。これを成り立たせるには、地味な部品がいくつか要ります。
- 見えるキー識別子。秘密の横に保存したプレフィックスやIDで、ログやサポートチケットが、誰も秘密そのものを見ることなく、どのキーが呼び出したかを示せるようにします。
- ハッシュとして保存される秘密。作成時に一度だけ表示し、二度と表示しません。サポートチームがパートナーのキーを読めるなら、サポートツールを侵害した人も読めます。
- キーごとの最終使用時刻。パートナーが古いキーが静かになったことを確認してから失効できるようにします。
- 認証の前段にあるキャッシュを含め、即時に有効になる失効。
サプライヤーの認証情報にも、逆方向に同じ重なりが必要です。ビルドに焼き込まず、稼働中のサービスが再読み込みするシークレットストアや暗号化された設定に保管してください。そうすれば切り替えはデプロイではなく設定変更になります。長期キーの上に短命のアクセストークンを重ねるのも有効です。トークンが漏れても、多くの人が消えたことに気づく前に失効します。
ローテーションは、ログ記録が元を取る場面でもあります。秘密や乗客の決済データは記録せずに、どのキーとどのテナントが各呼び出しを行ったかを記録しておけば、「うちの仕業か?」に一週間ではなく一時間で答えられます。
パートナーにキーを渡す前に
短いリストです。長い版はこの記事の残りの部分だからです。
- リクエスト内の何かが、キーのテナントを変えられるか。変えられてはいけません。
- IDを受け取るすべてのエンドポイントが所有権を確認し、失敗時に404で答えているか。
- サプライヤーの認証情報、またはそれに由来するフィールドが、ブラウザから到達できないか。
- B2Cのレスポンスのどこかに、隠しフィールドを含めて、ネット価格やマージンが含まれていないか。
- パートナーは連絡なしにローテーションでき、あなたも連絡なしに失効できるか。
当社のAPIアクセスの扱い
このブログの背後にあるプラットフォームは、航空券とホテルのAPIを提供しています。そこに載るすべてのテナントは、すでに独自の管理パネル、独自の予約、ロールベースのスタッフ権限で運用されており、サプライヤーのコンテンツは一対一の契約ではなくサプライヤーグループを通じてテナントに届きます。APIへのアクセスは、セルフサービスのキーではなく対話から始まります。理由の一部は上に述べたとおりで、認証情報が存在する前に、誰がどの市場向けに連携するのかを把握しておきたいのです。旅行APIのページ に、利用できる内容とその対話の始め方を記しています。