APIセキュリティ:データオブジェクトごとに権限を検証する
APIはアプリケーション、パートナー、社内サービスをつなぐと同時に、データへの新たなアクセス経路を開きます。保護にはトークンの確認以上の対策が必要です。各要求を、ID、操作、対象データ、適切な利用制限に基づいて評価します。

記事の内容
APIと所有者を把握する
API台帳には、エンドポイント、バージョン、利用アプリケーション、担当者を記載します。古いAPIや文書化されていないAPIも通信を受け続ける場合があり、ドキュメントポータルだけでは全体を把握できません。
台帳をルーティング設定やトラフィックログと照合すると、不明な点を洗い出せます。サポートを終了するバージョンには、移行計画と、利用者の移行完了を確認する方法が必要です。
認証はオブジェクトの権限確認を代替しない
有効なトークンは、要求が適切な認証を通過したことを示します。それでもサービスは、要求対象のレコードに対する操作権限を確認する必要があります。パス内の記録IDを変えるだけで、権限外のデータが見える状態にしてはいけません。
テストでは、複数のアカウントと権限グループを使用します。管理者アカウントだけで確認せず、読み取り、更新、取得や変更が許されるデータ項目まで検証します。
入力と利用量を制御する
本文サイズ、レコード数、処理時間、リクエスト数の制限は、異常な負荷でもサービスの動作を予測可能にします。規則は、背後のシステム能力と合意済みの利用要件を反映する必要があります。
要求を拒否する場合は、呼び出し側が対処できる適切なステータスとエラー情報を返します。エラー詳細に内部設定、接続情報、アクセスキーを含めるべきではありません。
開発ライフサイクルにセキュリティ検証を組み込む
業務上の変更、特にデータ項目、役割、結果の絞り込み方法を追加する際は、APIもテストします。権限テストを維持することで、新しい変更が想定外にアクセス範囲を広げる問題を発見できます。
ゲートウェイは共通ポリシーを提供できますが、各記録の業務規則をすべて理解しているわけではありません。入口とデータ処理サービスの保護責任を明確に分担する必要があります。
実際の場面に当てはめる
顧客記録の検索APIでは、異なる記録グループを担当する二人の従業員をテストに用意します。両者とも有効なアカウントを持ちますが、取得できるのは担当範囲のデータだけです。許可されていない項目の更新や、過剰なレコード取得も試し、拒否動作を十分に評価します。
合意すべき点
- API、バージョン、現在の利用者を一覧化する。
- 操作、レコード、データ項目ごとに権限を検証する。
- サービス能力に応じて入力とリソースの上限を設ける。
- 業務変更のたびに権限テストを継続する。
導入の視点
APIセキュリティは、共通アクセス層と業務サービスの両方で実施する必要があります。有効なトークンは必要条件であり、個々のデータに対する権限は別途明確に検証しなければなりません。
参考資料
各組織や技術プロジェクトの原資料をお読みください。



