Aruba Networks:配置设备管理集成

Prev Next

概览

为了增强设备智能,您可以将 Aruba 设备数据与 Cato 的信息搜集进行集成,以提供 IoT/OT 安全服务。来自两个平台的数据被合并,从而创建统一的设备配置文件来增强可见性和分类。

组合视图显示在主页 > 设备 > 库存选项卡中,并帮助改善对已管理和未管理资产的识别。通过更准确和完整的设备数据,您可以在网络中做出更好的安全决策。有关设备清单的更多信息,请参阅什么是设备清单?。.

要配置设备管理集成,您需要:

  • 在 Aruba Networks 中配置集成

  • 在 CMA 中创建 API 连接器

此功能需要IoT/OT安全许可证。

配置 Aruba Networks 集成

配置 Aruba Networks 集成时,需要为 Central 或 Classic Central 创建 API 凭证,并将其输入到 Cato 管理应用程序(CMA)中。

条件

  • 一个 HPE Aruba 网络设备中心 或 经典中心账户,能够访问您要监控的站点

  • 对于 Central:需要权限在 HPE GreenLake 为您的 Central 实例创建一个个人 API 客户端

  • 对于 Classic Central:需要权限创建应用程序和令牌在 Classic Central API 网关中

  • 仅限 Central:设备分配到站点,因为 Central 的监控 API 仅报告分配到站点的设备的遥测数据

访问令牌继承相同的权利和权限,比如您的 Central 用户角色。使用一个角色有权限读取您想收集的监控数据的账户。

步骤 1: 在 Aruba Networks 中配置集成

连接器支持 Central(新 Central)和经典 Central。创建一个 Aruba Networks 连接器为每个 Central 账户。

  • Central: 使用此选项用于独立 Central 账户或运行 AOS 10 的接入点

  • 经典中心: 使用此选项如果你看到经典中心切换或管理的 AOS 8 Instant APs 在经典中心内

配置 Aruba Central:

  1. 登录到您的 HPE Aruba 网络设备中心账户。

  2. 导航到 菜单 > API 网关,并选择 REST API 标签页。

  3. 点击复制在基本网址旁边。复制并保存基本网址以便输入到 CMA 中。

    基本网址是特定于您的账户的托管区域。如果您使用错误的网址,请求将会失败。

  4. 在 HPE GreenLake 中,选择 管理工作区。

  5. 选择 个人 API 客户端类别并点击 创建个人 API 客户端。

  6. 输入一个凭证昵称,例如 Cato 网络基础设施,然后从服务管理器下拉列表中选择您的 Central 实例。

  7. 点击 创建个人 API 客户端。

  8. 复制并保存客户端 ID和客户端密钥,以便在 CMA 中输入。

  9. 确认您想监控的接入点已分配到一个站点。未分配设备不返回监控数据,也不会出现 Cato 中。

配置 Aruba 经典 Central:

  1. 识别您账户集群的经典 API 网关 URL。经典 Central 使用不同的 API 网关域名。

    • US-1:https://app1-apigw.central.arubanetworks.com

    • US-2:https://apigw-prod2.central.arubanetworks.com

    • US-East1:https://apigw-us-east-1.central.arubanetworks.com

    • US-West4:https://apigw-uswest4.central.arubanetworks.com

    • US-West5:https://apigw-uswest5.central.arubanetworks.com

    • EU-1:https://eu-apigw.central.arubanetworks.com

    • EU-Central2:https://apigw-eucentral2.central.arubanetworks.com

    • EU-Central3:https://apigw-eucentral3.central.arubanetworks.com

    • Canada-1:https://apigw-ca.central.arubanetworks.com

    • China-1:https://apigw.central.arubanetworks.com.cn

    • APAC-1:https://api-ap.central.arubanetworks.com

    • APAC-EAST1:https://apigw-apaceast.central.arubanetworks.com

    • APAC-SOUTH1:https://apigw-apacsouth.central.arubanetworks.com

    • UAE-NORTH1:https://apigw-uaenorth1.central.arubanetworks.com

    复制并保存 经典 API 网关 URL,以便输入到 CMA 中。

  2. 登录到经典 Central。在账户主页页面下,点击全局设置中的API 网关。

  3. 打开我的应用程序&令牌标签页。(管理员用户可以使用系统应用程序&令牌标签页。)

  4. 点击+ 添加应用程序&令牌。

  5. 输入一个应用程序名称,例如Cato 网络基础设施。将 重定向 URI 留空,并选择网络运维作为应用。

  6. 单击 生成。应用程序已添加到表格中,令牌已添加到令牌列表中。

  7. 从应用程序的行中复制并保存 客户端 ID 和 客户端密钥,以便输入到 CMA 中。

  8. 在令牌列表中为新令牌点击下载令牌。复制并保存 刷新令牌 (refresh_token) 以便可以输入到 CMA 中。

    在生成令牌后 15分钟内完成Cato连接。仅将此应用程序和令牌用于Cato。当令牌被刷新时,经典中央会发出新的令牌对。如果另一个工具或脚本刷新了相同的令牌,Cato的拷贝将停止工作。

  9. 通过在经典API网关网址中追加/oauth2/token来构建令牌端点。对于US-2,使用https://apigw-prod2.central.arubanetworks.com/oauth2/token。

步骤2:在CMA中创建API连接器

设置完与应用程序的集成后,将详细信息添加到CMA中。

对于Aruba Networks,使用与您帐户匹配的认证选项:

  • Aruba Central 的 OAuth2 客户端凭证授权:客户端 ID、客户端密钥和 Aruba Central API 网关网址

  • Aruba Classic Central 的 OAuth2 刷新令牌认证:客户端 ID、客户端密钥、刷新令牌、令牌端点和 Aruba Classic Central API 网关网址

要在CMA中创建API连接器:

  1. 从导航菜单中,点击资源 > 集成。

  2. 点击已配置集成标签页。

  3. 点击新建。新集成面板打开。

  4. 选择您要添加的SaaS应用程序。

  5. 在功能下拉菜单中选择设备管理。

  6. 添加在步骤一中创建的详细信息。

  7. 点击保存。

该应用在集成应用表格中可见,并具有已连接状态。

通过 Central,Cato 自动发现您账户中的所有站点,并开始收集每个站点的事件。通过经典中央,Cato 收集事件、访问点和无线客户端,并自动更新令牌。

如果连接显示Aruba Classic Central 刷新令牌无效,则代表令牌已过期,被撤销或被其他工具刷新。在API 网关 > My Apps & Tokens中为应用程序生成新令牌。复制并保存刷新令牌以便输入到 CMA。在 Cato 中编辑连接器并粘贴新的刷新令牌。

已知局限性

  • 经典中央不收集有线客户端。经典中央选项仅收集无线客户端。

  • 用户名仅在 802.1X 网络上可用。当 SSID 使用 802.1X / WPA-Enterprise 与 RADIUS 后端对抗时,Aruba 仅填充客户端用户名。在预共享密钥 SSID 上:通常为访客、物联网和 BYOD 网络:没有要报告的用户身份,因此这些网络的客户端事件没有用户归属。

  • 只有中央指派的设备才会被报告。在 Central 中未被分配到站点的设备在 Central API中是不可见的。如果您的设备在经典 Central 中进行管理,请改用经典 Central 认证选项。

  • 经典 Central 令牌必须专用于 Cato。如果其他工具刷新同一令牌,或者令牌未使用超过15天,连接将停止,您需要生成一个新令牌。

  • API配额。 Central 在整个 Central 账户中实施每秒10次 API 调取的共享速率限制。经典 Central 每秒强制7次 API 调用并每日为每个账户设置 API 调用配额:每天基础5,000次调用,当订阅的设备数超过5,000时,每台基础设备增加30次,每台高级设备增加90次。经典 Central 连接器每天使用约400次调用(每次轮询至少四次:令牌刷新、接入点、客户端和事件),对于大账户来说更多,因为每个列表都以1000页的形式读取。其他共享账户的工具会影响同一配额。