将 SAP OData 元数据作为 API 导入

1. 在左侧菜单中，选择“API”“+ 添加 API”。

2. 在“根据定义创建”下，选择“OData”。

   

3. 输入 API 设置。 稍后可以转到 API 的“设置”选项卡来更新设置。

   1. 在 OData 规范中，输入 OData 元数据终结点的 URL，通常是服务根的 URL，并附加 /$metadata。 或者，选择要导入的本地 OData XML 文件。

   2. 输入其余设置以配置 API。 在导入和发布第一个 API 教程中对这些设置进行了说明。

4. 选择“创建”。

   API 将添加到 API 列表中。 OData 元数据说明中公开的实体集和函数显示在 API 的“架构”选项卡上。

   

可以在门户中访问编辑器以查看 API 的 OData 架构。 如果 API 发生更改，还可以从文件或 OData 服务终结点更新 API 管理中的架构。

1. 在门户中导航到 API 管理实例。

2. 在左侧菜单中，选择 OData API 的“API”>。

3. 在“架构”选项卡上，选择“编辑 (</>)”图标。

4. 查看架构。 如果要更新它，请选择“从文件更新”或“从终结点更新架构”。

   

通过应用现有访问控制策略和 OData 验证策略来保护 OData API，以防止通过 OData API 请求的攻击。

1. 将 OData XML 转换为 OpenAPI JSON 格式。 根据你的元数据 XML，对 OData v2 或 OData v4 使用 OASIS 开源工具。

   以下示例针对测试服务 epm_ref_apps_prod_man_srv 转换 OData v2 XML：

   odata-openapi -p --basePath '/sap/opu/odata/sap/epm_ref_apps_prod_man_srv' \
    --scheme https --host <your IP address>:<your SSL port> \
    ./epm_ref_apps_prod_man_srv.xml
   

   注意

   • 若要使用单个 XML 文件进行测试，可以使用基于开源工具的 基于 Web 的转换器 。
   • 使用该工具或基于 Web 的转换器，可以选择指定你的 SAP OData 服务器的 <IP 地址>:<端口>。 或者，在生成的 OpenAPI 规范中或将文件导入 API 管理后添加此信息。

2. 将 openapi-spec.json 文件保存在本地以导入 API 管理。

1. 在左侧导航窗格中的 “API ”部分，选择 API。

2. 在“ 创建新定义”下，选择 “OpenAPI：

   

3. 单击 “选择文件”，然后选择 openapi-spec.json 在上一步中本地保存的文件。

4. 输入 API 设置。 导入 API 时，可以通过转到 “设置” 选项卡来设置这些值。

   • 对于 API URL 后缀，建议使用与原始 SAP 服务相同的 URL 路径。

   • 有关 API 设置的更多信息，请参阅导入和发布你的第一个 API 教程。

5. 选择“创建”。

将以下三个操作添加到你导入的 API 中：

• GET /$metadata

  展開資料表

  操作	说明	操作的其他配置
  GET /$metadata	使 API 管理能够访问 $metadata 终结点，此终结点是客户端与 OData 服务器集成所必需的。 你生成和导入的 OpenAPI 规范中未包含这一必需操作。	添加 200 OK 响应。

  

• HEAD /

  展開資料表

  操作	说明
  HEAD /	使客户端能够在需要时与 SAP 服务器交换跨网站请求伪造 (CSRF) 令牌。 SAP 还允许通过 GET 谓词进行 CSRF 令牌交换。 本文不涉及 CSRF 令牌交换。 请参阅用于代理令牌交换 的示例 API 管理策略代码段 。

  

• GET /

  展開資料表

  操作	说明	操作的其他配置
  GET /	在服务根目录中启用策略配置。	配置以下入站 rewrite-uri 策略以将尾部左斜线附加到转发到服务根的请求： <rewrite-uri template="/" copy-unmatched-params="true" /> 此策略可消除带与不带尾随左斜线的请求之间的潜在歧义。 这些请求的两种类型在某些后端的处理方式上有所不同。

  

还需要使用适用于环境的相应方法配置对后端的身份验证。 有关示例，请参阅 API 管理身份验证和身份验证策略。

1. 导航到 API 管理实例。

2. 在左侧导航窗格中的 “API ”部分，选择 API。

3. 在“所有 API”下，选择导入的 API。

4. 选择“测试”选项卡以访问“测试”控制台。

5. 选择一个操作，输入任何所需的值，然后选择“发送”。

   例如，测试 GET /$metadata 调用以验证与 SAP 后端的连接。

6. 查看响应。 要进行故障排除，请跟踪调用。

7. 完成测试后，退出测试控制台。