Cato API 更新日志

变更: 更新的 API

功能标题: 通过外部工作流程和身份管理系统简化的用户管理

该 API 支持启用用户 (enableUser) 和禁用用户 (disableUser)。

变更: 更新的 API

功能标题：提升的分析能力用于分组的 AppStats 和事件 API 结果

当查询 AppStats 或事件 API 数据并按某个维度进行分组时，例如国家或设备类型，您可以选择将没有该维度值的记录显示为空组。 这有助于确保API查询的一致总计，并在CMA仪表板和报告中显示以前隐藏的数据。

• 新的查询级布尔参数：IncludeEmptyDimension，对现有 API 脚本没有影响

• 适用于API查询和在CMA中显示的数据

变更: 更新的 API

功能标题: 应用程序体验指标的 appStats API 更新

应用程序体验指标的appStats API新建字段允许程序化访问用户、主机和应用程序性能数据：

• experience_score_level - 体验评分指标的汇总

• ttfb - 首字节时间，衡量服务器响应能力

• tls_latency - 建立TLS连接的时间

• tcp_latency - TCP连接设置时间

• http_latency - 端到端HTTP请求延迟时间

• http_error_rate - HTTP错误率

注意: 这些字段仅适用于拥有 DEM 许可证的客户。

变更: 新建的 API

特性标题： API支持管理Webhook、邮件列表和订阅组

• 使用以下API分配、替换、更新和删除站点许可证，通过API支持单一和汇总许可证

  • • 管理 Webhook 集成，使用 createWebhook、updateWebhook、 deleteWebhook、webhook、webhookList 和 testWebhook

    • 使用createMailingList、updateMailingList、deleteMailingList、mailingList和mailingListList管理邮件列表

    • 将Webhook和邮件列表合并到“订阅组”中，使用createSubscriptionGroup、updateSubscriptionGroup、deleteSubscriptionGroup、subscriptionGroup和subscriptionGroupList

  有关在CMA中通知管理的详细信息，请参阅通知知识库文章

变更: 更新的 API

功能标题： 更新 SplitTunnelPolicyMutations

• 以下 API 已变更，以更准确地与 Cato 管理应用程序中的功能行为对齐。

  • 这些变更适用于分流策略的所有变更： 

    • Exclude - 变更为RouteAllToCatoExcept

    • Include - 变更为RouteOnlySelected

    • Coverage - 变更为ConnectionMode

    • dnsExclusion - 变更为dnsSuffix

这些 API 现已作为 Beta 提供。

变更: 新建的 API

功能标题： API 支持管理站点带宽许可证

• 使用以下API分配、替换、更新和删除站点许可证，通过API支持单一和汇总许可证

  • Mutation APIs: 

    • assignSiteBwLicense - 将许可证分配给站点

    • updateSiteBwLicense - 对于汇总许可证，更新站点带宽

    • replaceSiteBwLicense - 在不影响停机时间的情况下更换站点许可证

    • removeSiteBwLicense - 从站点移除许可证

这些 API 现已作为 Beta 提供。

变更: 新建的 API

功能标题： API 支持查询应用程序目录和 DLP 内容类型

• 应用程序目录 - 查询应用程序的数据，包括合规性、安全性和 CASB 活动：

  • catalogApplicationList - 所有应用和数据

  • catalogApplication - 单一应用

• DLP 内容 - 查询 DLP 数据内联保护规则的内容类型

  • contentTypeGroupList

这些 API 现已作为 Beta 提供。

变更: 新建的 API

功能标题： HA 配置的辅助 vSocket 的 API 支持

• 使用以下API设置故事判定、变更状态和添加备注

  • Mutation APIs: 

    • addSecondaryAwsVSocketInput 对于具有HA配置的AWS vSocket，添加辅助vSocket

    • AddSecondaryAzureVSocketInput 对于具有HA配置的AWS vSocket，添加辅助vSocket

这些 API 现已作为 Beta 提供。

变更: 新建的 API

功能标题： XDR 故事和评论的 API 支持

• 使用以下API设置故事判定、变更状态和添加备注

  • Mutation APIs: 

    • addStoryComment 提交评论帮助跟踪故事调查

    • analystFeedback 管理故事操作，例如故事判定、类型和分类。

    • deleteStoryComment 使用评论ID删除已发布的评论

这个 API 目前可作为 Beta 版本使用。

变更： API 的增强

功能标题： 设置站点带宽值，精确到一个小数点 (例如 1.5 Mbps)，以获得更细致的准确性

• 使用以下API设置故事判定、变更状态和添加备注

  • 受影响的 API 类型： 

    • LastMileBwInput 

    • InterfaceInfo 

    • SocketInterfaceBandwidthInput 

这些 API 类型目前可作为 Beta 版本使用。

更改： Primary 值更新为 Primary 1

功能标题： IPsec IKEv2 站点的 API 支持

随着 Jan 12, 2025 支持活动/活动配置的逐步发布，从 accountSnapshot 和 accountMetrics 查询中检索到 value 的 InterfaceId 字段的更改。

变更: 新建的 API

功能标题： BGP 对等的 API 支持

• 使用以下API简化配置和监控站点的BGP对等

  • Mutation APIs: 

    • addBgpPeer 为站点添加新建BGP对等

    • updateBgpPeer 更新现有BGP对等配置的设置

    • removeBgpPeer 删除站点的BGP对等配置

  • 查询 API： 

    • bgpPeer 检索有关特定BGP对等的信息

    • siteBgpStatus 显示当前BGP状态，包括会话详细信息和路由信息

这个 API 目前可作为 Beta 版本使用。