Apple Business Manager 集成

将 Apple Business Manager 保修信息与 Omnissa Intelligence 中的 Omnissa Workspace ONE 体验管理解决方案集成，以显示 Apple Business Manager 设备保修和服务授权数据，供管理员查看保修范围以及适用的设备上下文。

为什么要集成？

将 Apple Business Manager 保修信息与 Intelligence 中的体验管理集成，以便从列出的功能中受益。

• 查看支持的 Apple Business Manager 设备的 Apple Business Manager 保修和服务授权信息。
• 标识保修服务的开始日期和结束日期。
• 查看服务义务详细信息，如保修类型、服务级别和授权持续时间。
• 分析保修数据以及设备名称、序列号、用户和 Workspace ONE 上下文等设备元数据。
• 使用 Apple Business Manager 保修数据构建仪表板、报告和工作流。
  。

Apple Business 文档

有关该计划的信息，请参阅 Apple Business 站点。有关 Apple Business Manager API 的信息。

有关监控 Apple 设备保修的信息，请参阅 ABM 保修站点。

考虑联系您的 Apple Business Manager 企业支持代表，了解有关访问保修 API 的信息。

要求

您必须使用列出的解决方案才能使用此集成。

• 使用 Experience Management 解决方案。
• 使用 Omnissa Workspace ONE UEM 管理您的设备。
• Apple Business Manager 设备必须在 Workspace ONE UEM 中（包括按序列号）正确列入清单。
• 有权访问 Apple Business Manager 保修 API（Apple 支持/服务授权 API）。

请求访问 Apple Business Manager 保修 API

您必须有权访问 Apple Business Manager (ABM) 保修 API，以便能够在 Intelligence 中输入客户端 ID，实现成功集成。

重要信息：从 ABM 获取 PEM 密钥文件后，将其保存在以后可以访问的位置。您永远无法重新下载该文件。如果丢失此文件并且由于任何原因需要该文件，则必须撤销当前集成并使用新的 PEM 密钥文件创建新集成。

您可以通过查看 Apple 开发者站点上标题为 Apple Business API 的内容，来查看获取 PEM 密钥文件的相似过程。检索 Apple Business API 的过程与检索 ABM 保修 API 信息的过程类似。

• Apple Business Manager 帐户
  • 在 Apple Business Manager 站点上设置一个 Apple Business Manager (ABM) API 帐户。
    • 只有具有组织管理员角色的用户才能创建 API 帐户。
  • 设备应尽可能与同一 Apple Business Manager 帐户相关联。
• 在 Apple Business Manager 中创建 API 密钥
  • 要将 ABM 保修连接到您的环境，您需要客户端 ID、密钥 ID（在 Intelligence 中称为密钥）以及从 ABM 下载的 PEM（隐私增强邮件）私钥。
  • 以下是您在 ABM (Apple Business Manager) 中所执行操作的一般概述。有关此过程的最新信息，请参阅 Apple 文档。
    1. 选择您的名称，然后转到首选项 > API > 入门。
    2. 为 API 帐户命名，然后选择创建。例如，您可以将其命名为资产管理 - 保修同步。
    3. 选择生成 API/私钥。
    4. 下载 PEM 密钥文件。
       • 记得将此文件保存到您可以访问的位置，以备将来需要。
    5. 在新 API 帐户中选择管理。
    6. 复制密钥 ID 和客户端 ID。
       • 密钥 ID 在 Intelligence 中称为密钥
       • 客户端 ID 显示为 BUSINESSAPI.<uuid>。
    7. 构建一个使用 ES256 受众 "aud": "https://account.apple.com/auth/oauth2/v2/token", 签名的 JSON Web 令牌 (JWT)。
       • JWT 最多可缓存 180 天。
• 凭证
  • Omnissa Intelligence 使用这些凭据来检索保修数据。

集成 Apple 商务管理

使用 Omnissa Intelligence 中的数据源 > Apple Business Manager 磁贴配置集成并授权访问 Apple Business Manager 保修数据。

1. 在 Intelligence 中，转到集成 > 数据源，然后找到 Apple Business Manager 磁贴。
2. 在 Apple Business Manager 磁贴上选择设置。
3. 转到凭据选项卡，然后输入客户端 ID 和密钥，后者与您从 Apple Business Manager 获取的密钥 ID 相同。
   。
4. 选择授权。

体验管理可以检索 Apple Business Manager 保修详细信息，并在仪表板、报告和工作流中提供这些详细信息。

验证集成

使用自定义小组件、Data Explorer 和日志验证 Apple Business Manager 集成。

自定义小组件

在新的自定义仪表板中创建自定义小组件，或将小组件添加到现有仪表板。按照程序创建包含自定义小组件的新仪表板。

您还可以使用 Data Explorer，通过相同的数据源来验证集成。

1. 在 Intelligence 中，转到工作区 > 仪表板，然后选择添加 > 自定义仪表板。
2. 输入仪表板的名称并保存。
3. 在自定义仪表板中，选择添加小组件。
4. 输入小组件的名称，然后选择数据源 Apple > Apple 保修。
   。
   • 无需配置其他小组件设置。小组件仅需要数据源。
   • 查找所列的数据集以便填充预览窗格。
     • 保修开始日期和结束日期
     • 服务或授权级别的记录
     • 设备上下文字段（如设备名称、序列号、用户名）

检查日志

您还可以查看日志，确认集成状态或日志中未显示授权或 API 错误。通过在集成 > 数据源中选择 Apple Business Manager 磁贴来访问日志，选择查看，然后选择日志选项以下载或复制日志。
。

管理 Apple Business Manager 集成

使用数据源 > Apple Business Manager 磁贴管理 Intelligence 中的集成。

1. 在 Intelligence 中，转到集成 > 数据源，然后找到 Apple Business Manager 磁贴。
2. 选择 Apple Business Manager 磁贴上的视图、编辑或取消授权。
   • 视图：从 Apple Business Manager 详细信息页面中，您可以查看有关集成状态和使用情况的信息。您还可以从该详细信息页面访问日志文件。
   • 编辑：如果您需要更新客户端 ID，请使用此菜单选项。
   • 取消授权：当您不再希望使用此集成并且不希望在 Intelligence 中显示您的保修信息时，请使用此菜单选项。

数据定义

在保修管理主题中查找此功能中所用数据点的定义。