SAP OData メタデータを API としてインポートする

この記事では、メタデータの記述を使用して OData サービスをインポートする方法について説明します。 この記事では、SAP ゲートウェイ基盤を例として使用します。

この記事では、次のことを行います。

  • SAP サービスから OData メタデータを取得する
  • OData メタデータを直接 API Management にインポートする、または OpenAPI 仕様への変換後に API Management にインポートする
  • API の構成を完了する
  • Azure Portal での API のテスト

Note

OData API をそのメタデータの説明から API Management にインポートする操作はプレビュー段階です。 詳細については、こちらを参照してください

前提条件

  • 既存の API Management インスタンスがある。 まだない場合は、作成してください

  • OData v2 または v4 として公開されている SAP システムとサービス。

  • SAP バックエンドが自己署名証明書 (テスト目的) を使用している場合は、SSL の信頼チェーンの検証を無効にすることが必要になる場合があります。 これを行うには、API Management インスタンスでバックエンドを構成します。

    1. Azure portal の [API] で、[バックエンド]>[+ 追加] を選択します。
    2. SAP バックエンド サービスを指すカスタム URL を追加します。
    3. [Validate certificate chain](証明書チェーンを検証する) および [Validate certificate name](証明書名を検証する) のチェックボックスをオフにします。

    注意

    運用環境のシナリオでは、エンドツーエンドの SSL 検証に適切な証明書を使用します。

SAP サービスから OData メタデータを取得する

次のいずれかの方法を使用して、SAP サービスからメタデータ XML を取得します。 メタデータ XML を OpenAPI 仕様に変換する場合は、ファイルをローカルに保存します。

  • SAP ゲートウェイ クライアント (トランザクション /IWFND/GW_CLIENT ) を使用します。
  • または、XML を取得するための次の直接 HTTP 呼び出しを行います。http://<OData server URL>:<port>/<path>/$metadata

API Management インスタンスに移動します。

  1. Azure portal で、[API Management サービス] を検索して選択します。

    Select API Management services

  2. [API Management サービス] ページで、ご自身の API Management インスタンスを選択します。

    Select your API Management instance

API を API Management にインポートする

API を API Management にインポートするには、メタデータ XML を OData API として直接インポートするか、またはメタデータ XML を OpenAPI 仕様に変換するいずれかの方法を選択します。

OData メタデータをインポートする

  1. 左側のメニューで、 [API]>[+ API の追加] を選択します。

  2. [定義から作成][OData] を選択します。

    Screenshot of creating an API from an OData description in the portal.

  3. API 設定を入力します。 API の [設定] タブに移動することで、後で設定を更新することができます。

    1. [OData 仕様]で、OData メタデータ エンドポイントの URL を入力します。これは通常、サービス ルートへの URL であり、/$metadata が追加されています。 または、インポートするローカルの OData XML ファイルを選択します。

    2. 残りの設定を入力して API を構成します。 設定については、「最初の API のインポートと発行」のチュートリアルで説明されています。

  4. [作成] を選択します

    API が [API] リストに追加されます。 OData メタデータの説明で公開されているエンティティ セットと関数は、API の [エンティティ セットと関数 ] タブに表示されます。

    Screenshot of OData entity sets and functions in the portal.

OData スキーマを更新する

ポータルでエディターにアクセスして、API の OData スキーマを表示できます。 API が変更された場合は、ファイルまたは OData サービス エンドポイントから API Management のスキーマを更新することもできます。

  1. portal で、API Management インスタンスに移動します。

  2. 左側のメニューで、[API]> OData API を選択します。

  3. [エンティティ セットと関数] タブで、エンティティ セットまたは関数の横にあるコンテキスト メニュー (...) を選択し、[編集] を選択します

    Screenshot of context menu for an OData entity set in the portal.

  4. スキーマを確認します。 更新する場合は、[ファイルから更新する] または [エンドポイントからスキーマを更新する] を選択します。

    Screenshot of schema editor for OData API in the portal.

OData API をテストする

  1. 左側のメニューで、[API]> OData API を選択します。

  2. [エンティティ セットと関数] タブで、エンティティ セットまたは関数の横にあるコンテキスト メニュー (...) を選択し、[テスト] を選択します

    Screenshot of Test option on context menu for an OData entity set in the portal.

  3. テスト コンソールで、テストのテンプレート パラメーター、クエリ パラメーター、ヘッダーを入力し、[テスト] を選択しますポータルでの API のテストの詳細について説明 します。

OData API をセキュリティで保護する

OData API 要求を介した攻撃から保護するために、既存のアクセス制御ポリシーOData 検証ポリシーの両方を適用して、OData API をセキュリティで保護します。

ヒント

ポータルの [API ポリシー] タブで、OData API のポリシーを 構成します。

実稼働に関する考慮事項