クラウド / インフラセキュリティ

API (Application Programming Interface)

約 5 分で読めます

API とは

API (Application Programming Interface) とは、ソフトウェア同士がデータや機能をやり取りするための取り決め (インターフェース) で⁠す⁠。レストランに例えると、客 (アプリケーション) がメニュー (API 仕様) を見て注文し、ウェイター (API) が厨房 (サーバー) に伝えて料理 (データ) を運んでくる仕組みに似てい⁠ま⁠す⁠。

スマートフォンの天気アプリが最新の気象データを表示できるのは、気象サービスの API を通じてデータを取得しているから⁠で⁠す⁠。Web サービスの中には、裏側で複数の API を組み合わせて動くものもあり⁠ま⁠す⁠。

API の主な種類

REST API
API の設計スタイルの⁠一⁠つ⁠。HTTP メソッド (GET, POST, PUT, DELETE) を使い、URL でリソースを指定⁠す⁠る⁠。シンプルで理解しや⁠す⁠い⁠。
GraphQL
Facebook が開発したクエリ⁠言⁠語⁠。クライアントが必要なデータだけを指定して取得できるため、REST で起きることのある過剰取得 (over-fetching) を減ら⁠せ⁠る⁠。モバイルアプリなど帯域が限られる環境で⁠有⁠利⁠。
WebSocket
サーバーとクライアント間で双方向のリアルタイム通信を実現⁠す⁠る⁠。チャットアプリ、株価のリアルタイム表示、オンラインゲームなど、即時性が求められる場面で使わ⁠れ⁠る⁠。
gRPC
Google が開発した高性能 RPC フレームワ⁠ー⁠ク⁠。Protocol Buffers によるバイナリシリアライゼーションを使う (Protocol Buffers の公式の説明では JSON より小さく速い形⁠式⁠)⁠。マイクロサービス間の内部通信などで使わ⁠れ⁠る⁠。

API の認証と認可

API を安全に利用するには、「誰がアクセスしているか」(認証) と「何を許可するか」(認可) の仕組みが不可欠⁠で⁠す⁠。

  • API キー: シンプルな認証⁠方⁠式⁠。リクエストヘッダーやクエリパラメーターに固定の文字列を含⁠め⁠る⁠。手軽だが、キーが漏洩すると誰でもアクセスできてし⁠ま⁠う⁠。
  • OAuth 2.0: 第三者のアプリケーションが HTTP サービスへの限定的なアクセス権を得るための認可の枠組み (RFC 6749)⁠。ユーザーのパスワードを直接共有せず、アクセストークンを介して権限を委譲⁠す⁠る⁠。「Google でログイン」のような本人確認は、OAuth 2.0 の上に本人確認の層を載せた OpenID Connect が⁠担⁠う⁠。
  • JWT (JSON Web Token): 認証情報をトークンに埋め込み、サーバー側でセッションを保持しなくても検証できる⁠方⁠式⁠。ステートレスな API 設計と相性が⁠良⁠い⁠。

API キーをソースコードにハードコードしたり、公開リポジトリにコミットしたりすると、漏洩につながりかねま⁠せ⁠ん⁠。シークレット管理ツールを使い、環境変数や専用のシークレットストアで管理するのが鉄則⁠で⁠す⁠。

レート制限と API の保護

レート制限 (Rate Limiting) とは、一定時間内に受け付ける API リクエスト数に上限を設ける仕組み⁠で⁠す⁠。これがないと、悪意のあるユーザーが大量のリクエストを送りつけてサーバーをダウンさせる DDoS 攻撃が容易になり⁠ま⁠す⁠。

一般的なレート制限の実装パターンには以下があり⁠ま⁠す⁠。

  • 固定ウィンドウ: 1 分間に 100 リクエストまで、のように固定の時間枠で⁠制⁠限⁠。実装が簡単だが、ウィンドウの境界でバーストが発生し⁠う⁠る⁠。
  • スライディングウィンドウ: 直近 1 分間のリクエスト数を常に⁠追⁠跡⁠。固定ウィンドウの境界でのバーストを抑えら⁠れ⁠る⁠。
  • トークンバケット: 一定速度でトークンが補充され、リクエストごとにトークンを消費⁠す⁠る⁠。短時間のバーストを許容しつつ、長期的な平均レートを制御で⁠き⁠る⁠。

レート制限に達すると、サーバーは HTTP ステータスコード 429 (Too Many Requests) を返し⁠ま⁠す⁠。API を利用する側は、429 を受け取ったらリトライ間隔を空ける (エクスポネンシャルバックオフ) 実装が必要⁠で⁠す⁠。

API セキュリティの実践

API は Web サービスを支える部品であり、攻撃者の標的にもなり⁠ま⁠す⁠。OWASP API Security Top 10 の 2023 年版では、オブジェクトレベルの認可の不備、認証の不備、オブジェクトのプロパティレベルの認可の不備 (2019 年版の過剰なデータ公開を含む) が上位 3 つに挙げられてい⁠ま⁠す⁠。

  • 入力バリデーション: すべてのリクエストパラメーターを検証し、SQL インジェクションや XSS のリスクを減⁠ら⁠す⁠。
  • HTTPS の強制: API 通信は必ず TLS で暗号化⁠す⁠る⁠。平文の HTTP で API キーやトークンを送信すると、ネットワーク上で傍受されるおそれが⁠あ⁠る⁠。
  • 最小権限の原則: API トークンには必要最小限の権限だけを付与⁠す⁠る⁠。読み取り専用の用途に書き込み権限を与え⁠な⁠い⁠。
  • ログと監視: API の呼び出しパターンを監視し、異常なアクセスを早期に検知⁠す⁠る⁠。

よくある誤解

API は開発者だけが関係するもの
API はスマートフォンアプリ、IoT デバイス、決済システムなど、日常生活のさまざまな場面で使われてい⁠ま⁠す⁠。SNS にログインする、電子マネーで支払う、配車アプリを使うといった行為の裏側でも API が使われてい⁠ま⁠す⁠。
API を公開しなければ安全
内部 API であっても、社内ネットワークに侵入された場合やサプライチェーン攻撃を受けた場合に悪用されるリスクがあり⁠ま⁠す⁠。内部 API にも認証 / 認可 / 暗号化を適用するゼロトラストの考え方が重要⁠で⁠す⁠。
REST API は古い技術で GraphQL に置き換わる
GraphQL は特定のユースケースで優れていますが、REST がすべての場面で劣っているわけではありま⁠せ⁠ん⁠。シンプルな CRUD 操作やキャッシュの活用では REST の方が適しており、両者は共存してい⁠ま⁠す⁠。
共有する

関連用語

関連記事