4.17.05 - Edge for Private Cloud 版本说明

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

<ph type="x-smartling-placeholder">

自上一个 Edge for Private Cloud 功能版本以来,以下版本 已出现,并已包含在此功能版本中:

Edge 界面版本 边缘管理版本

请参阅关于版本 通过编号来判断特定 Cloud 版本是否 包含在适用于私有云的 Edge 版本中。

版本概览

此版本包含一些值得注意的功能,可帮助您更好地控制 API,包括:

  • 共享流支持零停机部署。
  • 现已支持删除组织的创收数据。
  • 其他新功能如下所述。

在弃用方面,保险柜已弃用。

本主题的其余部分包含有关所有新功能、更新和问题修复的详细信息 。

弃用和停用

此版本中已弃用或弃用以下功能。如需了解详情,请参阅 Edge 弃用政策

已停用:添加 “API 代理性能”标签页上的路径

在此版本之前,您可以在管理界面中前往 API 代理, 效果 标签,并创建不同的路径,以便对代理的 “效果”标签页和“业务交易”信息中心内。此功能现已弃用, 界面中的“延续”部分如需了解此功能的替代方案,请参阅以下 Apigee 社区文章:https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html。 (EDGEUI-902)

退休人员: 开发者服务门户的 buildInfo 网址

在之前版本的门户中,如需确定您的门户版本,您打开了以下内容 浏览器中的网址:

http://yourportal.com/buildInfo

在 4.17.05 中,此链接已被移除。要确定版本,请打开报告 > Drupal 中的状态报告菜单项。门户版本会显示在该行的表格中 名为安装配置文件

弃用 Apigee 安全存储(保险柜)

Apigee 的 也称为“保险柜”弃用并停用 弃用公告日期显示在 弃用和 弃用页面。创建提供键值对加密存储的保险柜 使用 Management API,并在运行时使用 apigee-access 中的函数访问 Node.js 模块。

不使用安全存储空间,而是使用加密的键值映射 (KVM),如 使用键值对映射。 加密的 KVM 与保险柜一样安全, 检索。(MGMT-3848)

新功能和更新

以下是此版本中的新功能和增强功能。除了以下 此版本也包含多项易用性、性能、安全性和稳定性 增强功能。

私有云

向安装中添加了新的必需 SMTP 配置参数

现在,您必须使用 Edge 安装配置文件。此参数用于指定 在 Edge 自动发送电子邮件时使用,例如当用户请求重置密码时。请参阅 在 node

(EDGEUI-1020)

现在可以为 Edge API 管理调用设置 Edge 界面使用的超时

您现在可以指定 Edge 界面使用的 API 超时时长,以控制界面的时长 等待 API 管理调用返回。以下属性定义了超时:

  • conf_apigee_apigee.feature.apitimeout 集 界面等待对后端的调用返回的时间(以秒为单位), 活动如果在此期间调用没有完成,界面会抛出超时错误。通过 默认值为 180 秒(3 分钟)。
  • conf_apigee_play.ws.timeout.idle 会设置 界面在服务器上等待 activity 的时间(以毫秒为单位)。它可以设置为与之前相同的值 作为 conf_apigee_apigee_apitimeout 或 一个较小的值。将其设置为更大的值不会产生任何影响。默认值为 180,000 毫秒(3 分钟)。
  • conf_apigee_play.ws.timeout.connection 集 界面等待连接建立的时间它可以设置为与之前相同的值 作为 conf_apigee_apigee_apitimeout 或 一个较小的值。将其设置为更大的值不会产生任何影响。默认值为 120000 毫秒(2 分钟)。

请参阅设置超时时间 。

(EDGEUI-816)

向路由器添加了消息处理器重试超时

添加了超时,以便路由器停止重试对消息处理器的请求并返回 错误消息。

请参见配置 以重试与消息处理器的连接以获取更多信息。

(APIRT-2912)

添加了更改默认系统管理员的过程

我们现在附上了更改默认系统管理员的文档。

请参阅管理 用户、角色和权限

(DOS-4895)

添加了关于如何在根用户和非根用户之间分离 Edge 安装任务的文档

新文档介绍了将 Edge 安装任务在 Root 和 非根用户。

请参阅边缘安装 概览了解详情。

(DOS-4573)

Edge 会自动发送电子邮件来响应某些事件,例如当用户被添加到 组织。其中很多电子邮件都包含链接。例如,当某个新用户被添加到 组织,则 Edge 界面会向用户发送一封电子邮件,其中包含登录网址,形式如下:

https://domain/login

网域由 Edge 自动确定,通常适合组织。 但是,如果 Edge 界面位于负载平衡器后面,那么自动 生成的域名不正确。如果是这样,您可以使用 conf_apigee_apigee.emails.hosturl 属性 明确设置所生成网址的域名部分。

请参阅将 主机名

(EDGEUI-1044)

为 API 代理设置 Edge 界面显示的基础网址

Edge 界面根据虚拟主机中的设置显示 API 代理的网址 与部署代理的位置相对应。此显示屏可能包含 虚拟主机。

在大多数情况下,Edge 界面中显示的网址是用于将外部 向代理发送的请求不过,对于某些配置,显示的网址不正确。 例如,以下任意一种配置都会导致系统不显示显示网址 对应于向代理发出外部请求的实际网址:

  • SSL 终止在负载平衡器发生
  • 负载平衡器和 Apigee 路由器之间发生端口映射
  • 配置了路径重写的负载平衡器

适用于私有云 4.17.05 及更高版本的 Edge 支持虚拟主机上名为 &lt;BaseUrl&gt; 中, 替换 Edge 界面显示的网址。下面是一个使用 新的 &lt;BaseURL&gt; 属性。在此示例中,值“http://myCo.com”在 Edge 界面中显示:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias> 
   </HostAliases> 
   <BaseUrl>http://myCo.com</BaseUrl>     
   <Interfaces/>
   <Port>9005</Port> 
</VirtualHost>

如果未设置 &lt;BaseUrl&gt;, 则 Edge 界面呈现的默认网址将显示为:“http://DNS_name_or_IP:9005/”, 而实际的主机别名设置为“http://myCo.com”。

您还可以在创建组织时使用 VHOST_BASEURL 属性 apigee-provision 实用程序。

请参阅配置 TLS 访问适用于私有云的 API

(EDGEUI-5008)

添加了关于启用调试日志记录的文档

添加了介绍如何为 Edge 启用/停用调试日志记录的文档 组件。

请参阅启用调试日志记录

(APIRT-4018)

apigee-analytics-collector 实用程序新增了安装程序和命令语法

所有适用于私有云的 Edge 客户都必须向 Apigee 提交有关 API 的统计信息 使用 apigee-analytics-collector 命令行 Beta 版代理流量 实用程序。该实用程序将 API 调用量报告发送回 Apigee。

此版本的 Edge 包含适用于 apigee-analytics-collector 实用程序。在这个版本中,您现在可以使用 apigee-service 安装 apigee-analytics-collector 实用程序, 而不是 npm,并调用 apigee-analytics-collector 实用程序 apigee-service,而不是通过 独立的命令

请参阅上传 API “流量数据到 Apigee - Beta 版”了解详情。

开发者服务门户更新后新建默认安装目录 从全新 4.17.01 安装的 Nginx/Postgres

更新使用 Nginx/Postgres 的新安装 4.17.01 后,根目录 从:

/opt/apigee/apigee-drupal

to:

/opt/apigee/apigee-drupal/wwwroot

API 服务

对实体进行更严格的输入验证

已针对 Apigee Edge 组织的所有实体强制执行更严格的输入验证。 允许使用的字符通常为字母(所有大小写)、数字和下划线。

受影响的实体包括:

  • 组织
  • 环境
  • API 代理
  • API 代理修订版本
  • API 代理中的政策名称
  • 调试跟踪记录掩码配置 ID
  • 资源名称(Java 调用程序、xsl、所有资源)
  • 密钥库
  • CRLstores
  • 资源引用
  • 目标服务器

(MGMT-3840)

共享流零停机部署

当您要部署共享流,并确保很少或根本没有传入流量时被拒绝 您现在可以使用零停机的 Deployment Management API。流程如下: 与使用 Management API 实现 API 代理零停机部署几乎完全相同。唯一 区别在于管理 API 资源

以下调用将部署 URI 中指示的共享流修订版本,然后取消部署 之前部署的修订版本(override=true 查询参数可实现此目的):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

创收

删除组织的创收数据

在以下情况下,您可能需要删除贵组织的创收数据:

  • 删除您的组织。在这种情况下,您必须先删除创收数据,然后才能 可以删除组织。
  • 清除您要重复使用的测试组织的创收数据。在本课中, 在这种情况下,您必须在删除创收数据后同步 Apigee Edge 数据。

有关详情,请参阅删除创收数据 来自贵组织。(DEVRT-2581)

添加了用于为组织启用创收功能的 API

您现在可以使用 API 为组织启用创收功能了。

请参阅启用 如何助力组织获利

(DEVRT-2383)

已修复 Bug

此版本中修复了以下 Bug。此列表主要供用户检查其支持服务工单中的问题是否已修复,并非旨在为所有用户提供详细信息。

私有云 4.17.05

问题 ID 说明
DEVRT-3569

创收功能的产品名称和应用名称长度限制小于 边缘

变现和 Edge 目前对产品和应用的长度限制相同 名称。

DOS-4400 当数据目录使用 apigee-service 备份操作时失败 符号链接
DOS-4563

现在,ZooKeeper 验证支持主机名和 IP 地址

现在,您可以使用边缘配置文件使用 IP 地址指定 ZooKeeper 节点 和主机名。

DOS-4562

“apigee-provision delete-env”操作不允许您进入管理员 创建密码

您现在可以从命令行输入管理员密码。

DOS-4568

现在,当您指定“:observer”时,ZooKeeper 验证将会生效 后缀

您现在可以使用 Edge 配置文件指定“:observer”ZooKeeper 的后缀 节点。

EDGEUI-28

用户退出 Edge 界面后,用户会话未销毁

当用户退出 Edge 界面时,该用户的会话 Cookie 会被删除。 然而,在用户登录后, 用户的系统可以获取该 Cookie,并使用该 Cookie 访问 Edge 界面。
您可以配置 Edge 界面,以在服务器中存储当前会话的相关信息 内存。当用户退出时,他们的会话信息就会被删除, 另一个用户禁止其使用 Cookie 访问 Edge 界面。请参阅配置 Edge 界面,将会话信息存储在内存中
EDGEUI-662

现在可以在 Edge 界面中设置密码提示文本

您现在可以控制 Edge 的重置密码对话框中显示的文本 界面。如果您对用户密码有特殊要求,那么这种方法非常有用。请参阅设置密码 提示文本

EDGEUI-920

Edge 界面中对加密 KVM 的支持默认处于停用状态

在之前的版本中,您必须在 Edge 界面。

EDGEUI-962

SMTP TLS 端口不再仅限于 465

您现在可以选择 SMTP TLS 端口。

Cloud 17.04.12(界面)

问题 ID 说明
EDGEUI-1008 在启用 SAML 的情况下切换到“Try New Edge”时重定向错误 网址
现在当您从以下位置点击试用新 Edge 时,重定向可以正常工作 已启用 SAML 的网址。
EDGEUI-980 跟踪会话应在用户保存对 API 代理的更改或 从环境中取消部署
现在,当用户保存对 API 代理的更改或取消部署该代理后,Trace 会话会停止 环境。
DEVRT-3532 EDGE 界面小数位强制执行
EDGE 界面现在可以强制执行小数位数,包括位数 允许出现在输入掩码中。

Cloud 17.04.05(界面)

问题 ID 说明
EDGEUI-976 最大跟踪事务消息不正确地拆分到两个 线
显示错误消息时,Edge 界面有时会错误地拆分单词 两行。此问题已解决。
EDGEUI-971 SOAP 2 REST:移除不起作用的示例
对 CurrencyConvertor 示例 WSDL 的引用已从 Edge 界面中移除,并且 文档。
EDGEUI-905 SOAP 代理天气 WSDL 示例不再有效
对天气示例 WSDL 的引用已从 Edge 界面中移除,并且 文档。

Cloud 17.03.29(界面)

问题 ID 说明
EDGEUI-967 在轨迹会话停止后不显示错误消息
如果在跟踪会话期间遇到错误,系统会停止跟踪会话并 后续错误消息将被隐藏。

此外,当您达到单笔交易所允许的交易次数上限时 跟踪会话和跟踪会话停止后,系统现在会显示以下消息 显示:

A maximum of 20 transactions can be fetched during a trace session. Start a new trace session to view more transactions.

EDGEUI-966 API 商品详情页面未显示开发者应用
在某些情况下,API 商品详情页面未显示任何开发者应用。 此问题已解决。
EDGEUI-965 在某些时区中,openSUSE 上的“开发者应用”页面会挂起
在某些时区中,“开发者应用”页面无法在 openSUSE 上加载。此问题导致 已修复
EDGEUI-907 默认情况下,系统会为所有 HIPAA 组织选中“已加密”复选框
对于 HIPAA 组织,所有键值对映射均已加密。添加新键值对映射时 使用 HIPAA 组织的界面,在“New Key Value Map”对话框中,找到“Encrypted” 复选框,无法停用。

Cloud 17.03.15.01(界面)

问题 ID 说明
EDGEUE-996 商品详情页面未显示应用
商品详情页面现在会显示所有开发者应用。
EDGEUI-973 Edge 会在停止跟踪会话后重定向到登录屏幕
修复了一个错误,该错误会导致 Edge 在执行以下操作时将用户重定向到登录屏幕: 执行正常操作(例如停止 Trace 会话)。

Cloud 17.03.15(界面)

问题 ID 说明
EDGEUI-961 留出缓冲时间以计算令牌刷新
为防止对 Edge 的调用偶尔失败,Edge 现在会检查并刷新 而不是只刷新即将到期的令牌 已过期。
EDGEUI-954 代理编辑器将条件中的引号替换为编码实体
在代理编辑器中,<Condition> 内的引号不再编码 标记前面。
EDGEUI-952 如果过滤后的查询参数包含特殊信息,跟踪工具将无法正常运行 字符
当出现特殊字符 。
EDGEUI-943 已过期的 /oAuthRefreshToken 不应返回 500 错误
如果 OAuth 令牌过期,现在会返回 303 HTTP 状态代码,而不是 5XX 服务器错误。
EDGEUI-942 出现错误时,Node.js 日志页面应停止自动刷新
查看 node.js 日志时,如果遇到错误,系统会停用自动刷新 。您可以点击“开始自动刷新”,以重新启用自动刷新。
EDGEUI-941 错误处理和自动退出方面的问题
在某些情况下,当用户需要重新输入凭据才能继续工作时, 界面不会重定向到登录屏幕。此问题已解决。
EDGEUI-934 应压缩通过代理编辑器提交的捆绑包
当您在代理编辑器中修改新修订版本或现有修订版本时,压缩的 ZIP 压缩包会 已提交。
EDGEUI-918 更新 Apigee Advisory
Apigee 公告已更新为 如下:
  • 过去 24 小时的查询(而不仅仅是支持“昨天午夜”)
  • 在检查建议(针对 例如,您的凭据已过期)
  • 标题已从 Advisory Alerts 更改为 Advisories
EDGEUI-917 请勿将 4xx 错误封装为 502
在界面中,4xx HTTP 错误不再以 502 HTTP Bad Gateway 错误的形式封装。

Cloud 17.03.13.02(创收)

问题 ID 说明
DEVRT-3584 GET {organization}/limits 提供过渡性支持 致电
已停用已停用的“限制”功能的所有 API 端点,并将以 状态代码 404 除外,它会返回空的 GET {organization}/limits limit 数组(以便有时间停止使用此端点)。 建议您在 2017 年 9 月之前移除对 GET {organization}/limits 端点的所有引用,因为届时相关引用将被排除 已移除。
DEVRT-3555 同步开发者输出显示“products”
使用 monetization API 同步开发者时,如同步 开发者使用 API,输出指定的“products”而不是“developers”这个 问题已解决。

Cloud 17.03.13.01(创收)

问题 ID 说明
DEVRT-3554 将 API 产品添加到多个 API 软件包
现在,您可以将一个 API 产品添加到多个可能处于有效状态,也可能没有生效的 API 软件包 但前提是开发者不接受两种不同的费率方案: 适用于同一 API 产品。
DEVRT-3532 为价格方案评分增加了额外的小数位
贵组织现已支持 MINT.RATE_DECIMAL_PLACES 属性 可让您设置特定费率方案值支持的小数位数。 请参阅配置 价格方案费率的小数位数
DEVRT-3517 标记为按组织启用税务引擎的标记
现在,可以使用 MINT_TAX_ENGINE_ENABLED 标志 管理员可以启用或停用用于获利的税务引擎。税务引擎 对已启用获利功能的新组织默认处于停用状态。
DEVRT-3454 改进 Monetization API 中的异常处理/响应
错误处理功能经过改进,现在包含有关所报告的 错误。
DEVRT-3441 使用情况通知未正确触发
未正确触发使用情况通知。导致出现此错误的问题 已修复

Cloud 17.03.13(API 管理)

问题 ID 说明
MGMT-3843 “org.antlr.v4.runtime.Vocabulary”将模型渲染为 HTML
MGMT-3829 系统显示“尝试使用共享流部署 API 端点部署 API 代理” 才能取得成功
此 bug 修复在 Sharedflow 部署 API 中添加了验证功能,以返回 400 Bad Request “NoSharedFlowsToDeploy”到这里就结束了
MGMT-3667 GET /v1/o/{org}/developers 返回的开发者数量不准确
MGMT-3575 部署期间的 expressions.parser.InvalidPattern 异常
MGMT-3511 即使部署了代理,代理部署仍会返回 400 响应代码 成功
此 bug 修复涉及到忽略 apiproxy 修订版本的取消部署状态 通过另一个取消部署 API 调用在新的 修订版本

Cloud 17.03.1(界面)

问题 ID 说明
EDGEUI-936 跟踪:对 Content-Type 设置过滤器不起作用,因为正斜线 双重编码
EDGEUI-935 “提取分析数据时出错”使用“=”登录自定义报告时 过滤条件
EDGEUI-930 保存时,未保留正则表达式保护政策的 XML 编码 套装

Cloud 17.02.15(界面)

问题 ID 说明
EDGEUI-901 作为 SOAP 直通代理的一部分生成的 WSDL 错误
EDGEUI-884 查看与成千上万个应用相关联的商品可能会导致 界面
EDGEUI-868 在 IE 浏览器中,某些用户界面页面无法显示并报错,“对象没有 支持属性”
EDGEUI-238 误导性跟踪错误“您无权在此跟踪 环境”
真正的问题是所选的代理修订版本未部署。

Cloud 17.02.13(API 运行时)

问题 ID 说明
DEVRT-3205 创建公司时间歇性失败
APIRT-3513 由于“未找到 Vhost”错误,代理通话失败
APIRT-3507 通过 不同的主机名
APIRT-3449 Policy Verify OAuth v2.0 Access Token 设置错误的属性名称;双前缀 apiproduct.apiproduct.*
APIRT-3392 特定代理在 MP 上的响应时间间歇性较长
APIRT-3032 在 target.url(设置为 IP 地址)上执行 DNS 查询
APIRT-2718

OAuthV2 政策 - 生成访问令牌时错误地返回 api_product_list 格式
使用 Management API 生成 OAuth v2.0 访问令牌时,JSON 响应 包含以下格式的 API 产品列表:

&quot;api_product_list&quot;:“[Product1, Product2, Product3]”

响应中的新 api_product_list_json 属性也会返回商品列表 作为单个产品名称的数组:

&quot;api_product_list_json&quot;: ["Product1", "Product2", "Product3"]

Cloud 17.02.13(API 管理)

问题 ID 说明
UAPAQ-146 TPS 分析指标返回分钟,而非秒

Cloud 17.01.18(界面)

问题 ID 说明
EDGEUI-898

导入或保存大型内容集时出错(超过 10MB)

此问题已在 2017 年 2 月 6 日发布的修补程序中得到解决。(REL-3948)

EDGEUI-860

在界面中将用户添加到组织后,他们收不到电子邮件

2017 年 1 月 23 日发布的修补程序已解决此问题。

EDGEUI-847 NodeJS 选项应从服务调用程序政策中移除 选项
EDGEUI-827 自定义角色可能会意外获得额外的权限

Cloud 17.01.16(API 管理)

问题 ID 说明
MGMT-3697 Management API 性能缓慢
MGMT-3674 无法为已启用 HIPAA 的组织创建加密的 KVM 或保险柜
MGMT-3647 使用大写电子邮件地址的用户的用户角色访问权限会抛出 403
MGMT-3601 部署新的 Apigee 代理时出错
MGMT-3527 部署期间发生加载目标服务器、缓存、虚拟主机错误
DOS-4008 显示流量下降不准确的流量来源错误

Cloud 17.01.16(创收)

问题 ID 说明
DEVRT-3385 为公司开发者通知添加通知模板
为公司开发者通知、 包括COMPANY_INVITES_DEVELOPERDEVELOPER_INVITES_COMPANY。有关详情,请参阅使用 通知模板
DEVRT-3364 未在续订日期续订价格方案
修复了导致无法在所配置的 续订日期。
DEVRT-3325 未生成用量通知的费率方案
修复了导致费率方案使用情况通知无法显示的问题 已发送。
DEVRT-3297 费率方案到期后,API 调用不会被屏蔽
修复了在费率方案结束后允许进行 API 调用的问题 过期日期。
DEVRT-3296 删除包含草稿或过期方案的 API 软件包会返回 500 HTTP 错误
删除包含草稿或已过期费率方案的 API 软件包时,删除操作 将失败并显示 500 HTTP 错误现在会返回一个更具描述性的错误,指示 用户必须先删除已过期的费率方案或草稿费率方案,然后才能删除该 API 软件包。
DEVRT-3178 未应用的未来费率方案不适用于接受父级费率方案的开发者 未来价格方案已发布
如果有一个或多个开发者在某个未来费率方案生效后接受了父级费率方案 则未来的费率方案没有得到实施, 价格方案已过期。此问题已解决。
DEVRT-3113 重复发送某些活动的通知
系统不会再针对同一活动发送重复的通知。