このページは Apigee と Apigee ハイブリッドに適用されます。
Apigee Edge ドキュメントを表示する
構成可能な API プロキシのプレビューを使用すると、API デベロッパーは宣言型の構成モデルを使用して、軽量プロキシを迅速に作成してデプロイできます。構成可能なプロキシ構成モデルでは、ユーザーは動作を生成するために必要な一連の手順ではなく、プロキシの目的の動作を指定します。
構成可能な API プロキシのプレビューの開発は、Apigee 有料サブスクリプションの組織のお客様のみがご利用いただけます。Apigee を従量課金制で使用している組織のお客様は、プログラム可能な API プロキシを作成できます。
プログラム可能なプロキシと構成可能なプロキシ
Apigee の使い慣れた XML ベースのプロキシ構成、または「プログラム可能な」構成モデルでは、ユーザーが命令的にプログラミングできます。つまり、プログラム可能な API プロキシの構成では、条件付きロジックのフローや各リクエストとレスポンスの状態を制御する一連の手順を指定します。これは、複数のデータソースを使った複雑なオペレーションのオーケストレーション、意思決定ロジックの実行、カスタムコードのインポートに使用されます。
たとえば、プログラム可能（命令型）Apigee API プロキシで外部コールアウト処理を実行するには、API デベロッパーが以下の各手順を指定します。
- 外部サービスを呼び出します。
- レスポンスに
fooが含まれている場合は、エンドポイント X を呼び出します。 - レスポンスに
barが含まれている場合は、エンドポイント Y を呼び出します。
構成可能な API プロキシ（宣言型）モデルのプレビューを使用すると、API デベロッパーは目的の結果を達成する方法を規定するのではなく、目的の結果を説明する一連の命令を簡単に提供できます。順次条件やループなどの命令型ロジックはサポートされていませんが、このモデルに従った多数のルールがあります。たとえば、次のようになります。
- 許可ルールまたは拒否ルール
- トークン検証ルール
- 割り当ての適用ルール
アンカーや拡張機能などの業界標準の YAML 構文を使用すると、API デベロッパーはプロダクト固有の言語を習得することなく、簡単に使い始めることができます。構成可能な API プロキシは、大量のトラフィックに対応する標準の API ゲートウェイ機能を提供します。次に例を示します。
- API プロダクトへの API キーのサポート
- OAuth 2.0 認証と JWT 認証
- レート制限
- 外部ポリシー決定点へのコールアウト
- シンプルなペイロード変換（gRPC から JSON など）
主な利点
構成可能な API プロキシのプレビューを使用すると、API デベロッパーは標準の API ゲートウェイ機能を実装でき、API キー検証、JWT 認証、CORS 設定などの一般的な動作に必要な構成を削減できます。
機能の比較
次の表は、2 つの構成形式のゲートウェイ機能を比較したものです。
| 特徴 | 環境の種類 | |
|---|---|---|
| プロキシの形式 | PROGRAMMABLE（XML） | CONFIGURABLE（YAML） |
| デプロイ タイプ | アーカイブ プロキシ |
アーカイブ なし |
| セキュリティ機能 | ||
| OAuth - トークンを生成する | ○ | なし |
| OAuth - トークンを検証する（JWT） | ○ | ○ |
| OAuth - トークンを検証する（不透明） | ○ | × |
| API キーを検証する | ○ | ○ |
| IP と CIDR の許可 / 拒否リスト | ○ | なし |
| 高度なセキュリティ (JWS、HMAC、SAML、XML/JSON Threat Protection、RegEx Scans) |
○ | × |
| トラフィックのスロットリング | ||
| 割り当て | ○ | ○ |
| SpikeArrest | ○ | なし |
| ペイロードの操作 | ||
| プログラマビリティ | ○ | × |
| GraphQL | ○ | × |
| SOAP ← → REST または XSLT | ○ | × |
| スキーマ検証 [WSDL、GraphQL、OAS] |
○ | なし |
| JSON ←→ gRPC | × | なし |
| フロー制御 / 決定 | ||
| コールアウト | ○ [Service Callout または External Callout を使用] |
なし |
| キャッシュと KVM | ○ [Apigee キャッシュまたは Cloud CDN] |
なし |
| アップストリーム / サウスバウンド接続 | ||
| ターゲット サーバー | ○ | ○ |
| ターゲット URI | ○ | ○ |
| mTLS | ○ | なし |
| TLS | ○ | ○ |
| プロトコル | HTTP 1.0、HTTP 1.1 | HTTP 1.1、2.0 |
| ダウンストリーム / ノースバウンド接続 | ||
| TLS | ○ | ○ |
| プロトコル | HTTP 1.1 | HTTP 1.1、2.0 |
| リクエスト / レスポンス | ||
| ペイロード上限 | 10 MB | なし [プロダクトの制限によりより大きなペイロードをサポート] |
| 共有フロー / フローフック | ○ | × |
| 高度な機能 | ||
| データ キャプチャ | ○ | なし |
| 収益化 | ○ | × |
| API Monitoring | ○ | ○ |
| デベロッパー ポータル | ○ | ○ |
| アナリティクス | ○ | ○ |
次のステップ
- 構成可能な API プロキシを作成する
- 構成可能なプロキシ構成の例で詳細を確認する