Apple 개인정보 매니페스트 2026: 필수 사유 API 점검표
Apple의 개인정보 매니페스트 요건은 2024년 5월 1일부터 시행 중이며, 앱의 동작 방식과 무관하게 제출이 거절되는 몇 안 되는 사유로 남아 있습니다. 필수 사유 API를 사용하면서 사유를 선언하지 않은 빌드는 App Store Connect에서 그대로 반려됩니다. 같은 파일에 두 가지 별개의 의무가 있습니다. 모든 플랫폼에 적용되는 데이터 수집 선언과, iOS, iPadOS, tvOS, visionOS, watchOS에 적용되는 필수 사유 API 선언입니다. 앱이 Apple의 commonly used SDK list에 있는 SDK를 링크한다면 해당 SDK의 개인정보 매니페스트가 추가로 필요하며, SDK를 바이너리 종속성으로 사용하는 경우 서명도 필요합니다. 다음은 아카이브가 Mac을 떠나기 전에 점검하는 열두 가지 항목입니다.
한 줄 요약: 파일 이름은 PrivacyInfo.xcprivacy여야 하고, 해당 API를 사용하는 코드가 포함된 번들 안에 있어야 하며, 모든 API 카테고리는 Apple가 공개한 사유 코드로 신고해야 합니다. 직접 쓴 문장으로는 안 됩니다.
1. 이 앱에 매니페스트가 정말 필요한가요?
이를 결정하는 두 가지 의무가 있으며 그 범위는 다릅니다. 데이터 수집 신고는 앱 또는 타사 SDK에 대해 모든 플랫폼에서 필요합니다. 필수 사유 API 신고는 iOS, iPadOS, tvOS, visionOS 및 watchOS에서 필요합니다. 앱이 필수 사유 API를 사용하거나, 해당 앱을 포함한 앱을 사용하는 사람에 대한 데이터를 수집하거나, 앱이 사용자에 대한 데이터를 수집할 수 있게 하거나, 추적 도메인에 접속하는 경우 해당 파일이 필요합니다. 나열된 SDK 중 하나라면 그와 관계없이 필요합니다.
2. 파일 이름이 정확하며 번들 안에 들어 있나요?
PrivacyInfo.xcprivacy가 필수 파일 이름이며, Apple는 다른 이름을 거부합니다. Xcode에서 File > New File로 이동해 Resource 섹션으로 스크롤한 뒤 App Privacy File 유형을 선택하고 타깃을 체크한 다음 생성하세요. 그런 다음 해당 타깃의 resources에 나열되어 있는지 확인하세요. Xcode는 개인정보 보고서를 생성할 때 그곳에서 찾은 매니페스트만 사용합니다. 서드파티 SDK를 정적 라이브러리로 배포하는 경우 Xcode 15에 추가된 정적 프레임워크 지원을 사용하고, 다른 리소스와 함께 프레임워크 타깃의 번들 리소스에 매니페스트를 추가하세요.
3. 네 가지 최상위 키가 모두 있나요?
NSPrivacyTracking— 앱 또는 서드파티 SDK가 데이터를 추적에 사용하는지 여부입니다.NSPrivacyTrackingDomains— 추적을 위해 연결되는 도메인입니다.NSPrivacyCollectedDataTypes— 수집하는 데이터 유형마다 하나의 딕셔너리를 두고, 각각 데이터 유형, 개인 식별 정보와의 연결 여부, 추적 사용 여부, 사용 목적을 기재합니다.NSPrivacyAccessedAPITypes— 필수 사유 API 카테고리마다 하나의 딕셔너리를 두고, 각각 카테고리와 사유 코드를 기재합니다.
앱이 추적하지 않는다면, 추적 키를 생략하는 대신 파일에 명시적으로 그렇게 밝히세요.
4. 필수 사유 API 5개 범주를 모두 감사하셨나요?
Apple는 규제 대상 API를 다섯 가지 범주로 분류합니다. 직접 작성한 코드와, 연동한 모든 SDK 내부의 코드를 각각 감사하세요. 단 한 번의 호출만으로도 신고가 필요해질 수 있습니다.
- 파일 타임스탬프 —
getattrlist,getattrlistbulk,fgetattrlist,fstat,fstatat,lstat,getattrlistat. - 시스템 부팅 시간 —
mach_absolute_time(). - 디스크 공간 —
statfs,statvfs,fstatfs,fstatvfs, 그리고getattrlist계열. - 활성 키보드 — 기기에서 어떤 키보드가 활성 상태인지 보고하는 API
- 사용자 기본값 — 사용자 기본값 API를 통해 읽고 씁니다.
5. 모든 항목이 승인된 사유 코드를 사용하나요?
이유 코드는 Apple이 게시하는 고정 문자열이며, 목록에서 선택할 뿐 직접 작성하지는 않습니다. 당사가 가장 자주 신고하는 항목은 다음과 같습니다. 파일 타임스탬프 — DDA9.1(기기 사용자에게 타임스탬프 표시), C617.1(앱, 앱 그룹 또는 CloudKit 컨테이너 내 파일), 3B52.1(문서 선택기 등을 통해 사용자가 특별히 허용한 파일 또는 디렉터리), 0A2A.1(앱을 위해 API를 감싸는 타사 SDK). 시스템 부팅 시간 — 35F9.1(앱 내 이벤트 간 경과 시간 측정 또는 타이머 실행), 8FFB.1(앱에서 발생한 이벤트의 절대 타임스탬프), 3D61.1(사용자가 제출하는 선택적 버그 리포트 내 부팅 시간). 디스크 공간 — 85F4.1(기기 사용자에게 디스크 공간 표시), E174.1(쓰기에 충분한 공간이 있는지 확인 또는 공간이 부족할 때 확보), 7D9E.1(선택적 버그 리포트 내 디스크 공간), B728.1(건강 연구 앱). 사용자 기본값 — CA92.1(앱 자체에서만 접근 가능한 데이터), 1C8F.1(앱, 앱 확장 및 App Clip), C56D.1(SDK 래퍼, 타사 SDK 전용), AC6B.1(MDM 관리 구성 키). 활성 키보드 — 3EC4.1(사용자 지정 키보드 앱), 54BD.1(올바른 맞춤 인터페이스 표시).
6. 사유가 사용자가 볼 수 있는 기능성과 일치하나요?
각 사유에는 고유한 조건이 있으며 심사자는 이를 읽습니다. E174.1은 앱이 사용자가 관찰할 수 있는 방식으로 디스크 공간에 따라 다르게 동작할 것을 요구합니다. 3EC4.1은 주요 기능이 시스템 전반의 사용자 정의 키보드인 앱에 한정됩니다. 3D61.1은 부팅 시간이 사용자가 제출하기로 선택한 보고서의 일부로 눈에 띄게 표시될 것을 요구합니다. 코드가 실제로 하는 일을 설명하는 사유를 선택하세요. 선언된 사유는 사용자에게 제시하는 기능과도 일치해야 합니다.
7. 사유가 금지하는 모든 이전을 중단했나요?
사유를 신고하면 해당 API 사용과 그로부터 파생된 데이터에 오직 그 사유에 한해서만 라이선스가 부여됩니다. 대부분의 사유에는 해당 정보와 그로부터 파생된 모든 것이 기기 외부로 전송되어서는 안 된다는 문구가 따릅니다. 문서화된 예외는 좁습니다. 인앱 이벤트 사이의 경과 시간은 기기를 떠날 수 있고(35F9.1), 절대적인 인앱 타임스탬프는 기기를 떠날 수 있지만(8FFB.1) 부팅 시간 자체는 떠날 수 없습니다. 버그 리포트 값은 해당 사용자가 특정 리포트를 직접 제출한 뒤에만 기기를 떠날 수 있으며, 디스크 공간은 같은 사용자가 사용하는 다른 기기로 표시 목적으로 로컬 네트워크를 통해 전달될 수 있을 뿐 인터넷을 통해서는 절대 전달될 수 없습니다. 분석 SDK에서 이 규칙이 가장 먼저 깨지므로, 신고서에 서명하기 전에 SDK가 무엇을 업로드하는지 확인하세요.
8. 추적 선언이 일관되나요?
핑거프린팅은 해당 개인이 추적 권한을 부여했는지 여부와 관계없이 금지되며, 이러한 API나 그로부터 파생된 데이터를 추적에 사용할 수 없습니다. 추적하지 않는다면 파일에 명시하세요. 명시적인 false는 신고이고, 침묵은 신고가 아닙니다.
9. SDK는 누구의 매니페스트에 포함되나
SDK 자체의 매니페스트입니다. 서드파티 SDK는 자신을 링크하는 앱의 매니페스트나 앱이 링크하는 다른 SDK의 매니페스트에 의존할 수 없습니다. 필수 사유 API를 사용하는 앱의 모든 실행 파일이나 동적 라이브러리는 이를 신고하는 매니페스트를 포함한 번들이 필요합니다. 반대 방향의 규칙은 더 관대합니다. 앱의 개인정보 매니페스트는 앱이 링크하는 서드파티 SDK가 수집하는 데이터까지 다룰 필요가 없습니다.
10. SDK 목록과 서명을 확인하셨나요?
개인정보 매니페스트는 Apple의 목록에 있는 SDK를 포함한 새 앱을 제출하거나, 목록에 있는 SDK 중 하나를 추가하는 업데이트를 제출할 때 해당 SDK에 대해 의무입니다. 또한 해당 SDK가 바이너리 종속성으로 사용되는 경우 서명이 추가로 요구되어, Xcode이 해당 SDK가 동일한 개발자에 의해 서명되었는지 검증할 수 있습니다. 목록에 있는 SDK의 모든 버전이 적용 대상이며, 목록에 있는 SDK를 재패키징한 SDK도 마찬가지입니다. 이 목록은 대부분의 실제 스택에 해당합니다. Flutter와 주요 플러그인, FirebaseCore, FirebaseMessaging, FirebaseCrashlytics, OneSignal, Alamofire, SDWebImage, Reachability, nanopb, GoogleUtilities, UnityFramework, hermes 등이 포함됩니다. 이 중 하나가 업로드를 격리할 때, 해결책은 보통 자체 매니페스트와 서명을 포함한 릴리스로 버전을 올리는 것입니다.
11. 업로드 전에 개인정보 보고서를 생성할 수 있나요?
Xcode에서 프로젝트를 열고 제품 > 아카이브를 선택한 다음, Organizer에서 아카이브를 컨트롤 클릭하고 개인정보 보고서 생성을 선택하세요. Xcode는 앱의 매니페스트와 앱이 연결된 모든 SDK의 매니페스트를 통합합니다. App Store Connect에서 개인정보 세부 정보를 입력한 후가 아니라 반드시 그 전에 이 보고서를 확인하세요. 심사자가 보는 것과 동일한 내용입니다.
12. 없이 업로드하면 어떻게 되나요?
먼저 이메일이 옵니다. Apple이(가) 앱의 개인정보 매니페스트에 누락된 사유를 추가하라는 알림을 보냅니다. 그다음은 강제 중단입니다. 2024년 5월 1일부터 필수 사유 API의 사용을 기술하지 않은 앱은 App Store Connect에서 접수되지 않습니다. 이 검증을 통과하지 못한 빌드는 심사 대기열에 오르지 않으며, 동일한 API 사용이 모든 패키지에서 반복적으로 나타나기 때문에 규모가 큰 포트폴리오는 즉시 그 영향을 받습니다.
출처
- Apple 개발자 — 개인정보 매니페스트 파일: developer.apple.com/documentation/bundleresources/privacy-manifest-files
- Apple Developer — 필수 사유 API 사용 설명: developer.apple.com/documentation/bundleresources/describing-use-of-required-reason-api
- Apple 개발자 — 개인정보 매니페스트에서 데이터 사용 설명하기: developer.apple.com/documentation/bundleresources/describing-data-use-in-privacy-manifests
- Apple 개발자 — 서드파티 SDK 요건: developer.apple.com/support/third-party-SDK-requirements
개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.
메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.
← 수정으로 돌아가기