API のポリシーおよびロジック構成体

ポリシーおよびロジック構成体とは、実行時の API 呼び出しの処理中に、ゲートウェイ・サーバーでの処理の特定の側面を制御する構成の一部です。

ポリシーは、アセンブリー・フローのビルディング・ブロックであり、セキュリティー、ロギング、ターゲット・サービスへの要求のルーティング、あるフォーマットから別のフォーマットへのデータの変換などの機能を構成する手段を提供します。 ポリシーは、API または計画のコンテキスト内で構成できます。

ロジック構成体の動作はポリシーの動作と類似していますが、ロジック構成体は、アセンブリーのデータ・フローを変更せずにアセンブリーのどの部分を実装するかおよびどのように実装するかの処理に影響します。

IBM® API Connect には、ポリシーおよびロジック構成体を作成、構成、および適用できる以下の方法が用意されています。
プランに関連付けられているポリシー
プランは、1 つ以上の API の操作のサブセットまたは API 操作をグループ化するための仕組みを提供します。 レート制限ポリシーをプランに設定できます。このポリシーは、指定された時間内にアプリケーションが行うことができる要求の数を指定します。 また、プランに含める操作ごとにポリシーを構成することもできます。 詳しくは、「 製品の操作」を参照してください。
組み込みポリシー
組み込みポリシー を使用すると、ゲートウェイ・サーバーの処理機能を制御するために、事前構成されたポリシー・ステートメントをアセンブリーに適用することができます。 組み込みポリシー は、 API Designer アセンブリー・エディターを使用して適用され、組み込みポリシーをアセンブリーに追加し、そのポリシーのプロパティーを構成します。 詳しくは、 組み込みポリシーを参照してください。
注: OpenAPI 定義ファイルに assembly 拡張を追加することで、 組み込みポリシー を API に適用することもできます。 詳しくは、 OpenAPI 仕様に対するIBM 拡張を参照してください。
ロジック構成体
ロジック構成体を使用すると、API 呼び出し時のアセンブリーからのデータ・フローを制御できます。 ポリシーと同様に、ロジック構成体は API Designer アセンブリー・エディターを使用して API に適用され、ロジック構成体をアセンブリーに追加したり、構成体の動作を構成したりします。 詳しくは、 論理構成を参照してください。
注: OpenAPI 定義ファイルに assembly 拡張を追加することにより、ロジック構成体を API に適用することもできます。 詳しくは、 OpenAPI 仕様に対するIBM 拡張を参照してください。
ユーザー定義ポリシー
ユーザー定義ポリシー を使用すると、ゲートウェイ・サーバーの追加の処理機能 (セキュリティーや要求のルーティングなど) を制御するための独自のポリシーを作成できます。 ユーザー定義ポリシーAPI Connect の外部で作成され、1 つ以上のカタログにインポートされるため、 組み込みポリシーと同じ方法で操作に適用できます。