API Management で API を公開しポリシーを適用する

Azure API Management(APIM)は、既存のバックエンド サービスの前段に「ゲートウェイ」を置き、認証・流量制御・変換などを一元的に適用できるサービスです。バックエンドのコードを一切変更せずに、サブスクリプションキーによるアクセス制御やレート制限を追加できる点が特徴で、AZ-204 では「API Management の実装」として頻出のテーマです。

このラボでは、数分で作成できるサーバーレスの Consumption(従量課金)レベルの APIM インスタンスを作成し、インターネット上の公開テスト用バックエンド(httpbin.org)を API として定義します。その後、サブスクリプションキーなしのリクエストが 401 で拒否されること、キー付きなら 200 が返ることを確認し、最後に rate-limit ポリシーを適用して、制限を超えたリクエストが 429 Too Many Requests になる様子を実際に観察します。

ポリシーは XML で記述され、inbound / backend / outbound / on-error の各セクションに配置します。今回は inbound セクションに rate-limit を入れますが、Consumption レベルでは rate-limit-by-key が使えないなど、レベル(ティア)ごとの機能差も試験でよく問われるポイントです。手順の中で合わせて確認していきます。

学習目標

• Consumption レベルの API Management インスタンスを Azure CLI で作成できる
• 既存の公開バックエンドを APIM 上の API として定義し、オペレーションを追加できる
• サブスクリプションキー(Ocp-Apim-Subscription-Key ヘッダー)によるアクセス制御の動作を説明できる
• rate-limit ポリシーを API スコープに適用し、429 応答を確認できる
• Consumption レベルで使用できるポリシーの制約(rate-limit-by-key 不可など)を説明できる

前提

• Azure ポータルにサインイン済みであること
• リソースはすべて japaneast(東日本) リージョンに作成すること
• 作業はすべて割り当て済みのリソースグループ 1 つの中で行います(新しいリソースグループの作成、サブスクリプション設定の変更はできません)

• Azure API Management の概要と主要な概念
• クイックスタート: Azure CLI を使用して新しい Azure API Management インスタンスを作成する
• API を手動で追加する
• Azure API Management のサブスクリプション
• Azure API Management のポリシー
• サブスクリプションごとの呼び出しレートの制限ポリシー (rate-limit)