适用于 iOS 的 Intune 应用 SDK - 多标识

注意

本指南分为几个不同的阶段。 首先查看 第 1 阶段:规划集成。

阶段 5:多标识 (可选)

默认情况下,SDK 将策略作为一个整体应用。 多重身份是一项 MAM 功能,可以通过它来在每个身份级别应用策略。 这需要比其他 MAM 功能更多的应用参与。

当应用打算更改活动标识时,应用必须通知应用 SDK。 SDK 还会在需要更改标识时通知应用。 目前只支持一个托管标识。 用户注册设备或应用后,SDK 将使用此标识,并将其视为主要托管标识。 应用中的其他用户将被视为未托管用户,且策略设置不受限制。

请注意,标识只是定义为字符串。 标识不区分大小写。 对 SDK 的标识请求可能不会返回设置标识时最初使用的相同大小写。

阶段目标

  • 确定应用程序是否需要多标识支持。
  • 了解 Intune 应用 SDK 如何感知标识。
  • 重构应用程序以提高标识感知。
  • 添加代码,通知 SDK 整个应用程序中的活动和更改标识。
  • 全面测试托管标识和非托管标识的应用保护策略强制。

标识概述

标识只是帐户 (例如) 的用户 user@contoso.com 名。 开发人员可以在以下级别上设置应用的标识:

  • 进程标识:设置进程范围的标识,主要用于单一标识应用。 此标识会影响所有任务、文件和 UI。

  • UI 标识:确定哪些策略应用于主线程上的 UI 任务,例如剪切/复制/粘贴、PIN、身份验证和数据共享。 UI 标识不会影响加密和备份等文件任务。

  • 线程标识:影响当前线程上应用的策略。 此标识会影响所有任务、文件和 UI。

无论用户是否被管理,应用都负责适当地设置标识。

在任何时候,每个线程都具有 UI 任务和文件任务的有效标识。 这是用于检查应应用哪些策略(如果有)的标识。 如果标识为“无标识”或用户不受管理,则不会应用任何策略。 下图显示了如何确定有效标识。

Intune App SDK iOS:标识确定过程

线程队列

应用经常将异步和同步任务调度到线程队列。 SDK 会截获 Grand Central Dispatch (GCD) 调用,并将当前线程标识与已调度的任务相关联。 任务完成后,SDK 会临时将线程标识更改为与任务关联的标识,完成任务,然后还原原始线程标识。

由于 构建于 GCD 之上,NSOperations因此NSOperationQueue在将任务添加到 NSOperationQueue时,将在线程的标识上运行。 NSOperations 或直接通过 GCD 调度的函数也可以在运行时更改当前线程标识。 此标识将替代从调度线程继承的标识。

在 swift 中,由于 SDK 传播 DispatchWorkItem身份的方式,与 关联 DispatchWorkItem 的标识是创建项目的线程的标识,而不是调度项目的线程。

文件所有者

SDK 跟踪本地文件所有者的身份并相应地应用策略。 创建文件或在截断模式下打开文件时确定文件所有者。 所有者设置为执行任务的线程的有效文件任务标识。

或者,应用可以使用显式 IntuneMAMFilePolicyManager设置文件所有者标识。 应用可用于 IntuneMAMFilePolicyManager 检索文件所有者,并在显示文件内容之前设置 UI 标识。

共享的数据

如果应用创建的文件同时包含来自托管和非托管用户的数据,则该应用负责加密托管用户的数据。 可以使用中的 and unprotect API IntuneMAMDataProtectionManager来加密数据protect。

该 protect 方法接受可以是托管用户或非托管用户的标识。 如果用户是托管用户,则数据将加密。 如果用户不受管理,则标头将添加到编码标识的数据中,但不会对数据进行加密。 可以使用该 protectionInfo 方法检索数据的所有者。

共享扩展

如果应用具有共享扩展,则可以通过 中IntuneMAMDataProtectionManager的方法检索protectionInfoForItemProvider要共享的项的所有者。 如果共享项是一个文件,则 SDK 将处理文件所有者的设置。 如果共享项是数据,应用负责设置文件所有者(如果此数据保留到文件),并在 UI 中显示此数据之前调用 setUIPolicyAccountId API。

启用多重标识

默认情况下,应用被视为单一标识。 SDK 将进程标识设置为已注册的用户。 要启用多标识支持,请将名称 MultiIdentity 和值为 YES 的布尔值设置添加到应用的 Info.plist 文件中的 IntuneMAMSettings 字典中。

注意

启用多标识后,进程标识、UI 标识和线程标识设置为 nil。 应用负责正确设置它们。

切换标识

重要

SDK 无法独立检测标识更改。 它完全依赖于应用来报告它们。 如果应用未正确通知 SDK 身份切换:

  • 可能不会对活动用户强制实施应用保护策略,从而使托管数据不受保护。
  • 非托管数据可能受到错误限制。

每当活动用户发生更改时(包括启动应用时、帐户切换时以及显示其他用户的数据时),应用都必须调用相应的标识切换 API (setUIPolicyAccountId 例如) 。

  • 应用启动的身份切换:

    启动时,多标识应用被视为在未知的非托管帐户下运行。 条件启动 UI 不会运行,并且不会对应用强制实施任何策略。 应用负责在标识发生更改时通知 SDK。 通常,每当应用程序即将显示特定用户帐户的数据时,就会发生这种情况。

    例如,用户试图打开笔记本中的文档、邮箱或选项卡。 在文件、邮箱或选项卡实际打开之前,应用需要通知 SDK。 这是通过 中的 IntuneMAMPolicyManagerAPI 完成setUIPolicyAccountId的。 无论用户是否被托管,都应调用此 API。 如果用户是托管用户,则 SDK 将执行条件启动检查,例如越狱检测、PIN 和身份验证。

    标识切换的结果将通过完成处理程序异步返回到应用。 应用应推迟打开文档、邮箱或选项卡,直到返回成功结果代码。 如果身份切换失败,应用应取消任务。

    多标识应用应避免用作 setProcessAccountId 设置标识的方式。 使用 UIScenes 的应用应使用 setUIPolicyAccountId:forWindow API 设置标识。

    应用还可以使用 setCurrentThreadIdentity: and setCurrentThreadIdentity:forScope:设置当前线程的标识。 例如,应用可能会生成后台线程,将标识设置为托管标识,然后对托管文件执行文件操作。 如果应用使用 setCurrentThreadAccountId:,应用也应使用 getCurrentThreadAccountId ,以便在完成后可恢复原始标识。 但是,如果应用使用 setCurrentThreadAccountId:forScope: ,则会自动还原旧标识。 最好使用 setCurrentThreadAccountId:forScope:.

    In swift,由于 async/await, [IntuneMAMPolicyManager setCurrentThreadAccountId:] 并且 [IntuneMAMPolicyManager setCurrentThreadAccountId:forScope:] 不可用。 而是在 swift 中设置当前标识 use IntuneMAMSwiftContextManager.setAccountId(_, forScope:). 存在用于传入的异步、引发和异步引发闭包的此 API 的变体。

  • SDK 启动的身份切换:

    有时,SDK 需要要求应用切换到特定标识。 多标识应用必须实现处理identitySwitchRequiredForAccountIdIntuneMAMPolicyDelegate此请求的方法。

    调用此方法时,如果应用可以处理切换到指定标识的请求,则它应传递 IntuneMAMAddIdentityResultSuccess 到完成处理程序中。 如果无法处理身份切换,则应用应传递 IntuneMAMAddIdentityResultFailed 到完成处理程序中。

    应用不必调用 setUIPolicyAccountId 即可响应此调用。 如果 SDK 需要应用切换到非托管用户帐户,则空字符串将传递到调用中 identitySwitchRequiredForAccountId 。

  • SDK 启动的标识自动注册:

    当 SDK 需要在应用中自动注册用户以执行操作时,应用必须在 IntuneMAMPolicyDelegate中实现该addIdentity:completionHandler:方法。 然后,应用程序必须调用完成处理程序,如果应用能够添加标识,则传入 IntuneMAMAddIdentityResultSuccess;否则传入 IntuneMAMAddIdentityResultFailed。

  • 选择性擦除:

    当应用被选择性擦除时,SDK 将调用 wipeDataForAccountIdIntuneMAMPolicyDelegate. 该应用程序负责删除指定用户的帐户以及与之关联的任何数据。 SDK 能够删除用户拥有的所有文件,并且会在应用从调用中 wipeDataForAccountId 返回 FALSE 时执行此操作。

    请注意,此方法是从后台线程调用的。 在删除用户的所有数据之前,应用不应返回值, (如果应用返回 FALSE) ,则文件除外。

退出条件

计划投入大量时间来验证应用的多重身份集成。 在开始测试之前:

  • 创建应用保护策略并将其分配给帐户。 这将是测试托管帐户。
  • 创建,但不要将应用保护策略分配给另一个帐户。 这将是测试的非托管帐户。 或者,如果你的应用支持除 Microsoft Entra 帐户之外的多种帐户类型,则可以使用现有的非 AAD 帐户作为非托管测试帐户。
  • 重新熟悉如何在应用中强制实施策略。 多标识测试要求你轻松区分应用何时在强制执行策略的情况下运行,何时未运行。 用于阻止屏幕截图的应用保护策略设置可有效快速测试策略实施。
  • 请考虑应用提供的整个 UI 集。 枚举显示帐户数据的屏幕。 您的应用是否只一次显示一个帐户的数据,或者是否可以同时显示属于多个帐户的数据?
  • 考虑应用创建的整个文件集。 枚举这些文件中哪些包含属于帐户的数据,而不是系统级数据。
    • 确定如何验证每个文件的加密。
  • 考虑应用与其他应用交互的整个方式。 枚举所有入口和出口点。 应用可以引入哪些类型的数据? 它广播什么意图? 它实现哪些内容提供商?
    • 确定将如何运用这些数据共享功能。
    • 准备一台测试设备,该设备具有可与你的应用交互的托管和非托管应用。
  • 请考虑您的应用如何使最终用户能够与所有已登录帐户进行交互。 在显示某个帐户的数据之前,用户是否需要手动切换到该帐户?

全面评估应用的当前行为后,通过执行以下一组测试来验证多身份集成。 请注意,这不是一个完整的列表,并不保证应用的多标识实现没有 bug。

验证登录和注销方案

多标识应用最多支持 1 个托管帐户和多个非托管帐户。 这些测试有助于确保多重身份集成不会在用户登录或注销时不正确地更改保护。

对于这些测试,请在测试设备上安装应用;开始测试前请勿登录。

应用场景 步骤
首先登录托管 - 首先使用托管帐户登录并验证该帐户的数据是否受管理。
- 使用非托管帐户登录并验证该帐户的数据不受管理。
首先在非托管用户登录 - 首先使用非托管帐户登录,然后验证该帐户的数据不受管理。
- 使用托管帐户登录并验证该帐户的数据是否受管理。
登录多个托管 - 首先使用托管帐户登录并验证该帐户的数据是否受管理。
- 使用第二个托管帐户登录,并验证用户是否被阻止登录,而无需先删除原始托管帐户。
注销托管 - 使用托管帐户和非托管帐户登录到您的应用。
- 注销托管帐户。
- 确认已从您的应用中移除受管理帐号,并且该帐号的所有数据都已被移除。
- 确认非托管帐户仍已登录,未删除非托管帐户的任何数据,并且仍未应用策略。
注销非托管 - 使用托管帐户和非托管帐户登录到您的应用。
- 注销非托管帐户。
- 确认已从您的应用中移除该非托管帐号,并且该帐号的所有数据都已被移除。
- 确认托管帐号仍已登录,未移除任何非托管帐号的数据,并且仍应用策略。

验证活动标识和应用生命周期

您的多标识应用可能会显示包含单个帐号数据的视图,并允许用户显式更改当前正在使用的帐号。 它还可以同时呈现包含多个帐户数据的视图。 这些测试有助于确保多标识集成在整个应用生命周期中为每个页面上的活动标识提供正确的保护。

对于这些测试,请在测试设备上安装应用;在开始测试之前,使用托管帐户和非托管帐户登录。

应用场景 步骤
单一帐户视图,托管 - 切换到托管帐户。
- 导航到应用中显示单个帐号数据的所有页面。
- 确认策略应用于每个页面。
单一帐户视图,非托管 - 切换到非托管帐户。
- 导航到应用中显示单个帐号数据的所有页面。
- 确认该策略未应用于任何页面。
多帐户视图 - 导航到应用程序中同时显示多个帐户数据的所有页面。
- 确认策略应用于每个页面。
托管暂停 - 在显示托管数据且策略处于活动状态的屏幕上,通过导航到设备主屏幕或其他应用来暂停应用。
- 恢复应用。
- 确认仍应用该策略。
非托管暂停 - 在显示非托管数据且没有处于活动状态的策略的屏幕上,通过导航到设备主屏幕或其他应用来暂停应用。
- 恢复应用。
- 确认未应用该策略。
托管终止 - 在显示托管数据且策略处于活动状态的屏幕上,强制终止应用。
- 重新启动应用程序。
- 确认如果应用在受管理帐户数据 (预期) 屏幕上恢复,则仍应用策略。 如果应用在包含非托管帐户数据的屏幕上恢复,请确认未应用该策略。
非托管终止 - 在显示非托管数据且策略处于活动状态的屏幕上,强制终止应用。
- 重新启动应用程序。
- 确认,如果应用在屏幕上恢复,且非托管帐户的数据 (预期) ,则不会应用策略。 如果应用在带有托管帐户数据的屏幕上恢复,请确认仍然应用该策略。
临时身份切换 - 实验在帐户之间切换并暂停/恢复/终止/重新启动应用程序。
- 确认托管账户的数据始终受到保护,而非托管账户的数据从未受到保护。

验证数据共享方案

多标识应用可能会向其他应用发送数据,也可能会从其他应用接收数据。 Intune 的应用保护策略具有规定此行为的设置。 这些测试有助于确保多身份集成遵守这些数据共享设置。

对于这些测试,请在测试设备上安装应用;在开始测试之前,使用托管帐户和非托管帐户登录。 此外:

  • 将托管帐户的策略设置为:
    • 将组织数据发送到其他应用“改为”策略管理的应用“。
    • “从其他应用接收数据”到“策略管理的应用”。
  • 在测试设备上安装其他应用:
    • 一个托管应用,目标 (与你的应用相同的策略,可以发送和接收数据,如 Microsoft Outlook) 。
    • 可发送和接收数据的任何非托管应用。
  • 使用托管测试帐户登录到其他托管应用。 即使其他托管应用是多标识的,也只能使用托管帐户登录。

如果你的应用能够将数据发送到其他应用,例如 Microsoft Outlook 将文档附件发送到 Microsoft Office:

应用场景 步骤
托管标识发送到非托管应用 - 切换到托管帐户。
- 导航到应用可以发送数据的位置。
- 尝试将数据发送到非托管应用。
- 应阻止你向非托管应用发送数据。
托管标识发送到托管应用 - 切换到托管帐户。
- 导航到应用可以发送数据的位置。
- 尝试使用已登录的托管帐户将数据发送到其他托管应用。
- 应允许您将数据发送到托管应用。
发送到托管应用的非托管标识 - 切换到非托管帐户。
- 导航到应用可以发送数据的位置。
- 尝试使用已登录的托管帐户将数据发送到其他托管应用。
- 应阻止您将数据发送到其他托管应用。
发送到非托管应用的非托管标识 - 切换到非托管帐户。
- 导航到应用可以发送数据的位置。
- 尝试将数据发送到非托管应用。
- 应始终允许您将非托管帐户的数据发送到非托管应用。

应用可能会主动从其他应用导入数据,例如 Microsoft Outlook 从 Microsoft OneDrive 附加文件。 应用也可能被动地从其他应用接收数据,例如 Microsoft Office 从 Microsoft Outlook 附件打开文档。 接收应用保护策略设置涵盖这两种场景。

如果您的应用能够主动导入其他应用中的数据:

应用场景 步骤
从非托管应用导入托管标识 - 切换到托管帐户。
- 导航到应用可以从其他应用导入数据的位置。
- 尝试从非托管应用导入数据。
- 应阻止从非托管应用导入数据。
从托管应用导入托管标识 - 切换到托管帐户。
- 导航到应用可以从其他应用导入数据的位置。
- 尝试使用已登录的托管帐户从其他托管应用导入数据。
- 应允许从其他托管应用导入数据。
从托管应用导入非托管标识 - 切换到非托管帐户。
- 导航到应用可以从其他应用导入数据的位置。
- 尝试使用已登录的托管帐户从其他托管应用导入数据。
- 应阻止从其他托管应用导入数据。
从非托管应用导入非托管标识 - 切换到非托管帐户。
- 导航到应用可以从其他应用导入数据的位置。
- 尝试从非托管应用导入数据。
- 应始终允许你从非托管帐户导入数据。

如果你的应用能够被动地从其他应用接收数据:

应用场景 步骤
从非托管应用接收的托管标识 - 切换到托管帐户。
- 切换到非托管应用。
- 导航到可以发送数据的位置。
- 尝试将数据从非托管应用发送到您的应用。
- 应用的托管帐号不应能够从非托管应用接收数据。
从托管应用接收的托管标识 - 切换到托管帐户。
- 使用已登录的托管帐户切换到其他托管应用。
- 导航到可以发送数据的位置。
- 尝试将数据从托管应用发送到您的应用。
- 应允许应用的托管帐户从其他托管应用接收数据。
从托管应用接收的非托管标识 - 切换到非托管帐户。
- 使用已登录的托管帐户切换到其他托管应用。
- 导航到可以发送数据的位置。
- 尝试将数据从托管应用发送到您的应用。
- 应用的非托管帐户不应能够从托管应用接收数据。
从非托管应用接收的非托管标识 - 切换到非托管帐户。
- 切换到非托管应用。
- 导航到可以发送数据的位置。
- 尝试将数据从非托管应用发送到您的应用。
- 应始终允许应用的非托管帐户从非托管应用接收数据。

如果在这些测试中失败,则可能表明应用在尝试发送或接收数据时没有设置正确的活动标识。 可以通过在发送/接收时利用 SDK 的获取标识 API 来调查此问题,以确认活动标识设置正确。

后续步骤

完成上述所有 退出条件 后,应用现已成功集成为多标识,可以按标识强制实施应用保护策略。 后续部分( 阶段 6:应用保护条件访问支持 和 阶段 7:Web 视图功能)可能是必需的,也可能不需要,具体取决于应用所需的应用保护策略支持。