Apple理由声明隐私API清单(List of APIs that require declared reasons)

2,696 阅读10分钟

背景

image.png 苹果承诺全平台保护用户隐私。我们知道,有一小部分API可以通过指纹识别被滥用,收集有关用户设备的数据,这是开发者计划许可协议所禁止的。为了防止这些API被滥用,苹果在WWDC23上宣布,开发者需要在应用的隐私清单中声明使用这些API的原因。

这将有助于确保应用程序仅将这些API用于其预期目的。在这个过程中,需要选择一个或多个准确反映应用程序如何使用API的批准原因,并且应用程序只能根据您的选择使用该API。

从2023年秋季开始,如果在App Store Connect上传一个新应用程序或更新应用程序(包括来自第三方SDK的应用程序),而该应用程序使用的API需要一个原因,那么如果您没有在应用程序的隐私清单中提供批准原因,将收到通知。

从2024年春季开始,为了将新应用程序或应用程序更新上传到App Store Connect,需要在应用程序的隐私清单中包含一个批准原因,该原因准确地反映了应用程序如何使用API。 developer.apple.com/cn/support/… 如果您有一个API使用要求的原因,但尚未被批准原因涵盖,并且该用例直接使app使用人受益,需要告知苹果。

官方链接:developer.apple.com/news/?id=z6…

API类别API详情列表适配动作
键名值域及说明
### (1)文件时间戳API- creationDate
  • modificationDate
  • fileModificationDate
  • contentModificationDateKey
  • creationDateKey
  • getattrlist(_:_:_:_:_:)
  • getattrlistbulk(_:_:_:_:_:)
  • fgetattrlist(_:_:_:_:_:)
  • stat
  • fstat(_:_:)
  • fstatat(_:_:_:_:)
  • lstat(_:_:)
  • getattrlistat(_:_:_:_:_:_:) | NSPrivacyAccessedAPICategoryFileTimestamp | #### DDA9.1:声明此原因以向使用设备的人显示文件时间戳。为此原因获取的信息或任何派生信息不能发送到设备外。#### C617.1:声明此原因以访问应用程序容器、应用程序组容器或应用程序的CloudKit容器中文件的时间戳。#### 3B52.1:声明此原因以访问用户特别授权的文件或目录的时间戳,例如使用文档选择器视图控制器。 | | ### (2)系统启动时间API | - systemUptime
  • mach_absolute_time() | NSPrivacyAccessedAPICategorySystemBootTime | #### 35F9.1声明此原因以访问系统启动时间,以测量应用程序内发生的事件之间的经过的时间或执行计时器启用的计算。为此原因获取的信息或任何派生信息不能发送到设备外。关于应用程序内发生的事件之间经过的时间的信息可能有例外情况,可以发送到设备外。 | | ### (3)磁盘空间API | - volumeAvailableCapacityKey
  • volumeAvailableCapacityForImportantUsageKey
  • volumeAvailableCapacityForOpportunisticUsageKey
  • volumeTotalCapacityKey
  • systemFreeSize
  • systemSize
  • statfs(_:_:)
  • statvfs(_:_:)
  • fstatfs(_:_:)
  • fstatvfs(_:_:)
  • getattrlist(_:_:_:_:_:)
  • fgetattrlist(_:_:_:_:_:)
  • getattrlistat(_:_:_:_:_:_:) | NSPrivacyAccessedAPICategoryDiskSpace | #### 85F4.1声明此原因以向使用设备的人员显示磁盘空间信息。磁盘空间可以以信息单位(如字节)或与媒体类型结合的时间单位(如HD视频的分钟数)显示。为此原因获取的信息或任何派生信息可能不会发送到设备外。#### E174.1声明此原因以检查是否有足够的磁盘空间写入文件,或检查磁盘空间是否不足,以便应用程序可以在磁盘空间不足时删除文件。应用程序必须根据磁盘空间以一种用户可以观察到的方式表现出不同的行为。为此原因获取的信息或任何派生信息可能不会发送到设备外。有一个例外情况,允许应用程序在磁盘空间不足时避免从服务器下载文件。 | | ### (4)活动键盘API | - activeInputModes | | #### 3EC4.1如果你的应用是自定义键盘应用,声明此原因以确定设备上激活的键盘。向用户提供全局自定义键盘必须是应用程序的主要功能。为此原因获取的信息或任何派生信息不能发送到设备外。#### 54BD.1声明此原因以访问活动键盘信息,向使用设备的人员呈现正确的自定义用户界面。应用程序必须具有输入或编辑文本的文本字段,并且必须根据活动键盘以一种用户可以观察到的方式表现出不同的行为。为此原因获取的信息或任何派生信息可能不会发送到设备外。 | | ### (5)UserDefaults API | - UserDefaults | NSPrivacyAccessedAPICategoryUserDefaults | #### CA92.1声明此原因以访问用户默认设置,以读取和写入只能由应用程序本身访问的信息。此原因不允许读取其他应用程序或系统编写的信息,或写入其他应用程序可以访问的信息。

具体内容

为了遵循苹果的要求,您需要在您的应用程序或第三方SDK的隐私清单文件中说明使用某些必需原因API的原因,并确保仅出于预期原因使用这些API。

从2023年秋季开始,如果您将使用必需原因API的应用程序上传到App Store Connect(即使您未在隐私清单文件中描述使用原因),也将收到电子邮件通知。从2024年初开始,未在其隐私清单文件中描述其对必需原因API的使用情况的应用程序或SDK将不会被接受。

对于您的应用程序或第三方SDK使用的每个必需原因API类别,请在应用程序或第三方SDK的隐私清单文件的NSPrivacyAccessedAPITypes数组中添加一个字典,以报告您使用该API类别的原因。

如果您在自己的应用程序代码中使用了该API,则需要在应用程序的隐私清单文件中报告该API。如果您在第三方SDK的代码中使用了该API,则需要在第三方SDK的隐私清单文件中报告该API。第三方SDK无法依赖链接到其他第三方SDK或应用程序的隐私清单文件来报告其使用必需原因API的情况。

您的应用程序或第三方SDK必须声明一个或多个经过批准的原因,以准确地反映您对这些API及其使用所得到的数据的使用。您只能将这些API及其派生数据用于声明的原因。这些声明的原因必须与向您的用户展示的应用程序功能一致,并且您不能将API或派生数据用于跟踪目的。

NSPrivacyAccessedAPITypes数组中的每个字典都需要包含以下键和值:

NSPrivacyAccessedAPIType:标识您使用的必需原因API类别的字符串。您提供的值必须是下面列出的值之一。

NSPrivacyAccessedAPITypeReasons:标识您使用该API类别的原因的字符串数组。您提供的值必须与下面列出的访问API类型相关联。

必需原因API的类别、每个类别中的哪些API以及您可以在隐私清单中包括的原因在下面的部分中有说明。

苹果会不断审查必需原因API和使用的列表,并会不时更新本文章。如果您的应用程序使用必需原因API向使用该应用程序的人提供好处,并且原因未在此列出,则请提交新的认可原因请求。有关创建隐私清单文件的更多信息,请参阅创建隐私清单

文件时间戳API

以下访问文件时间戳的API需要为其使用提供理由。请将字符串NSPrivacyAccessedAPICategoryFileTimestamp作为NSPrivacyAccessedAPIType键在NSPrivacyAccessedAPITypes字典中的值。

您需要在NSPrivacyAccessedAPITypeReasons数组中提供以下列表中的相关值:

DDA9.1

声明此原因以向使用设备的人显示文件时间戳。为此原因获取的信息或任何派生信息不能发送到设备外。

C617.1:

声明此原因以访问应用程序容器、应用程序组容器或应用程序的CloudKit容器中文件的时间戳。

3B52.1:

声明此原因以访问用户特别授权的文件或目录的时间戳,例如使用文档选择器视图控制器。

系统启动时间API

以下用于访问系统启动时间的API需要提供使用原因。请将NSPrivacyAccessedAPIType键的值设置为NSPrivacyAccessedAPICategorySystemBootTime,在你的NSPrivacyAccessedAPITypes字典中。

在你的NSPrivacyAccessedAPITypeReasons数组中,提供以下列表中的相关值。

35F9.1

声明此原因以访问系统启动时间,以测量应用程序内发生的事件之间的经过的时间或执行计时器启用的计算。

为此原因获取的信息或任何派生信息不能发送到设备外。关于应用程序内发生的事件之间经过的时间的信息可能有例外情况,可以发送到设备外。

磁盘空间API

以下用于访问可用磁盘空间的API需要提供使用原因。请将NSPrivacyAccessedAPIType键的值设置为NSPrivacyAccessedAPICategoryDiskSpace,在你的NSPrivacyAccessedAPITypes字典中。

在你的NSPrivacyAccessedAPITypeReasons数组中,提供以下列表中的相关值。

85F4.1

声明此原因以向使用设备的人员显示磁盘空间信息。磁盘空间可以以信息单位(如字节)或与媒体类型结合的时间单位(如HD视频的分钟数)显示。

为此原因获取的信息或任何派生信息可能不会发送到设备外。

E174.1

声明此原因以检查是否有足够的磁盘空间写入文件,或检查磁盘空间是否不足,以便应用程序可以在磁盘空间不足时删除文件。应用程序必须根据磁盘空间以一种用户可以观察到的方式表现出不同的行为。

为此原因获取的信息或任何派生信息可能不会发送到设备外。有一个例外情况,允许应用程序在磁盘空间不足时避免从服务器下载文件。

活动键盘API

以下用于访问活动键盘列表的API需要提供使用原因。请将NSPrivacyAccessedAPIType键的值设置为NSPrivacyAccessedAPICategoryActiveKeyboards,在你的NSPrivacyAccessedAPITypes字典中。

在你的NSPrivacyAccessedAPITypeReasons数组中,提供以下列表中的相关值。

3EC4.1

如果你的应用是自定义键盘应用,声明此原因以确定设备上激活的键盘。向用户提供全局自定义键盘必须是应用程序的主要功能。

为此原因获取的信息或任何派生信息不能发送到设备外。

54BD.1

声明此原因以访问活动键盘信息,向使用设备的人员呈现正确的自定义用户界面。应用程序必须具有输入或编辑文本的文本字段,并且必须根据活动键盘以一种用户可以观察到的方式表现出不同的行为。

为此原因获取的信息或任何派生信息可能不会发送到设备外。

用户默认API

以下用于访问用户默认设置的API需要提供使用原因。请将NSPrivacyAccessedAPIType键的值设置为NSPrivacyAccessedAPICategoryUserDefaults,在你的NSPrivacyAccessedAPITypes字典中。

在你的NSPrivacyAccessedAPITypeReasons数组中,提供以下列表中的相关值。

CA92.1

声明此原因以访问用户默认设置,以读取和写入只能由应用程序本身访问的信息。

此原因不允许读取其他应用程序或系统编写的信息,或写入其他应用程序可以访问的信息。

适配

1.对于不维护的三放SDK,可以自行fork添加,也可以直接源码集成进项目(不建议) 2.在podSpec文件中配置独立bundle

s.resource_bundles = {

    'podName_Privacy' => ['*.xcprivacy']

  }