앱 개발

iOS 개인정보 매니페스트 PrivacyInfo.xcprivacy, 사유 필요 API와 SDK 기준

iOS 개인정보 매니페스트 PrivacyInfo.xcprivacy, 사유 필요 API와 SDK 기준

iOS 개인정보 매니페스트 PrivacyInfo.xcprivacy, 사유 필요 API와 SDK 기준

App Store Connect에 iOS 앱을 올리려면 PrivacyInfo.xcprivacy에 수집 데이터와 사유 필요 API 사용 이유를 적어야 합니다. UserDefaults도 대상이고, Firebase, Flutter 같은 목록 속 SDK는 매니페스트와 서명이 필요합니다.

App Store Connect에 iOS 앱을 올리려면 PrivacyInfo.xcprivacy에 수집 데이터와 사유 필요 API 사용 이유를 적어야 합니다. UserDefaults도 대상이고, Firebase, Flutter 같은 목록 속 SDK는 매니페스트와 서명이 필요합니다.

7분 소요

7분 소요

iOS 앱에는 PrivacyInfo.xcprivacy라는 개인정보 매니페스트 파일이 들어갑니다. 앱이 어떤 데이터를 모으는지, 그리고 Apple이 "사유 필요 API(required reason API)"로 묶어 둔 기능을 왜 쓰는지 적는 파일입니다. Apple 문서 기준으로 2024년 5월 1일부터는 이 API를 쓰면서 사유를 적지 않은 앱을 App Store Connect가 받지 않습니다. 대상 API에는 UserDefaults처럼 거의 모든 앱이 쓰는 것도 들어 있어서, 직접 만든 기능이 단순해도 이 파일은 챙겨야 합니다.

iOS 개인정보 매니페스트 PrivacyInfo.xcprivacy, 사유 필요 API와 SDK 기준 대표 이미지

심사에서 반려되는 다른 이유들은 앱스토어 심사 거절 사유와 대응 방법 글에 따로 있습니다. 이 글은 매니페스트 파일 하나만 다룹니다.

매니페스트에는 키 네 개가 들어갑니다

매니페스트는 속성 목록(plist) 파일입니다. Xcode에서 File, New File을 고른 뒤 Resource 항목의 App Privacy를 선택하면 만들어지고, 파일 이름은 PrivacyInfo.xcprivacy에서 바꾸면 안 됩니다. Apple 개인정보 매니페스트 문서에 나오는 최상위 키는 아래와 같습니다.

키 적는 내용
NSPrivacyTracking 앱이 추적(App Tracking Transparency 기준)에 데이터를 쓰는지 여부
NSPrivacyTrackingDomains 추적에 쓰는 인터넷 도메인 목록
NSPrivacyCollectedDataTypes 수집하는 데이터 종류, 사용자와 연결 여부, 수집 목적
NSPrivacyAccessedAPITypes 사유 필요 API 분류와 Apple이 정한 사유 코드

추적 도메인 항목은 실제 동작에도 영향을 줍니다. 사용자가 추적을 허용하지 않았다면 여기 적힌 도메인으로 가는 네트워크 요청이 실패하고 앱은 오류를 받습니다. 광고나 분석 SDK가 쓰는 도메인을 무심코 넣었다가 기능 일부가 멈추는 일이 생길 수 있으니, SDK 문서에 적힌 도메인만 넣습니다.

수집 데이터 항목은 App Store의 개인정보 라벨(Privacy Nutrition Label)과 내용이 이어집니다. Xcode에서 Product, Archive로 아카이브를 만든 다음 오거나이저에서 Generate Privacy Report를 누르면, 앱과 SDK의 매니페스트를 합친 보고서가 PDF로 나옵니다. App Store Connect에서 개인정보 항목을 채울 때 이 보고서를 옆에 두고 맞추면 빠뜨리는 곳이 줄어듭니다.

사유 필요 API는 다섯 분류입니다

Apple은 기기를 식별하는 데 악용될 수 있는 API를 따로 묶었습니다. 사용자 몰래 기기 특징을 모아 사람을 알아보는 방식을 핑거프린팅이라고 하는데, 사유 필요 API 문서는 사용자가 추적을 허용했더라도 핑거프린팅은 금지라고 적고 있습니다. 그래서 이 API들은 쓸 수는 있지만 정해진 사유 안에서만 써야 하고, 그 사유를 코드로 적어야 합니다.

분류 대표 API 흔히 쓰는 사유 코드
파일 시간 정보 creationDate, modificationDate, stat C617.1 앱 컨테이너 안 파일
시스템 부팅 시간 systemUptime, mach_absolute_time() 35F9.1 앱 안 이벤트 사이 경과 시간
저장 공간 volumeAvailableCapacityKey, statfs E174.1 파일을 쓸 공간이 충분한지 판단
활성 키보드 activeInputModes 54BD.1 키보드에 맞춘 화면 표시
UserDefaults UserDefaults CA92.1 앱 자신만 읽고 쓰는 값

사유 코드마다 조건이 붙어 있습니다. 예를 들어 저장 공간 E174.1은 공간이 모자랄 때 앱이 사용자 눈에 보이게 다르게 동작해야 하고, 그 정보를 기기 밖으로 보내면 안 됩니다. 위젯이나 앱 확장과 같은 App Group에서 값을 나눠 쓴다면 UserDefaults 사유는 CA92.1이 아니라 1C8F.1입니다. 코드를 찾는 것보다 실제 쓰임새와 사유 설명이 맞는지 보는 데 시간을 더 씁니다.

SDK는 각자 자기 매니페스트를 가져야 합니다

앱 매니페스트가 SDK의 사용 내역까지 대신 적어 주지 않습니다. Apple 문서는 SDK가 앱이나 다른 SDK의 매니페스트에 기대지 말고 자기 사용 내역을 직접 적으라고 하고, 실행 파일이나 동적 라이브러리마다 그 묶음 안에 매니페스트가 있어야 한다고 설명합니다.

여기에 별도 목록이 하나 더 있습니다. Apple의 서드파티 SDK 요구 사항 페이지에 올라 있는 SDK는 매니페스트를 반드시 갖춰야 하고, 바이너리로 들어가는 경우 서명도 있어야 합니다. 새 앱을 올리거나, 업데이트에서 목록 속 SDK를 새로 추가할 때 적용됩니다. 목록에는 Alamofire, Kingfisher, SDWebImage, Lottie 같은 iOS 라이브러리와 FirebaseCore, FirebaseMessaging, FirebaseCrashlytics, GoogleSignIn, FBSDKCoreKit, OneSignal이 있고, Flutter와 그 플러그인(shared_preferences_ios, path_provider, image_picker_ios, webview_flutter_wkwebview 등), React Native의 hermes, Capacitor와 Cordova도 들어 있습니다. 목록 SDK를 다시 포장한 SDK도 대상입니다.

크로스플랫폼 앱은 직접 쓴 iOS 코드가 거의 없어도 플러그인 때문에 이 목록에 걸리는 경우가 많습니다. 오래된 버전의 플러그인을 고정해 둔 프로젝트라면 매니페스트가 들어간 버전으로 올리는 작업이 먼저입니다.

잘못 쓴 매니페스트도 반려됩니다

파일이 있기만 하면 끝나는 것도 아닙니다. Apple 기술 노트 TN3181에 따르면 2024년 11월 12일부터 심사에 내는 앱은 형식이 올바른 매니페스트를 갖춰야 합니다. 정해지지 않은 키나 값이 들어 있으면 Apple이 문제 파일의 이름과 경로를 적은 메일을 보냅니다. 기술 노트에 나오는 흔한 실수는 이런 것들입니다.

  • NSPrivacyTracking이 true인데 추적 도메인 목록이 비어 있음
  • NSPrivacyTracking이 false인데 추적 도메인이 남아 있음
  • 도메인에 경로나 끝 슬래시를 붙임
  • 사유 필요 API 분류 이름이 Apple 목록과 글자 하나라도 다름

수집 데이터 종류나 목적을 Apple 목록에 없는 값으로 직접 지어 넣으면 Xcode 개인정보 보고서도 제대로 만들어지지 않습니다. 정해진 값만 골라 씁니다.

문제가 서드파티 SDK의 매니페스트에 있다면 SDK 개발사에서 고친 버전을 받는 것이 정석입니다. 당장 제출해야 하는데 고친 버전이 없을 때는, Apple 문서가 안내하는 대로 아카이브 안에서 해당 파일을 고치거나 지운 뒤 Xcode 오거나이저에서 배포하는 방법이 있습니다. 파일을 건드리면 서명이 깨지지만 오거나이저로 배포할 때 Xcode가 다시 서명합니다.

제출 전에 이 순서로 봅니다

저희는 iOS 빌드를 올리기 전에 매니페스트를 아래 순서로 봅니다.

  1. 앱 타깃에 PrivacyInfo.xcprivacy가 있고 리소스에 포함됐는지 봅니다.
  2. 앱 코드에서 다섯 분류 API를 검색해 쓰임새마다 사유 코드를 고릅니다.
  3. 패키지 목록을 Apple SDK 목록과 대조하고, 걸리는 SDK는 매니페스트가 들어간 버전인지 봅니다.
  4. 아카이브로 개인정보 보고서를 뽑아 App Store Connect의 개인정보 라벨과 맞춥니다.

iOS 빌드 환경 자체가 바뀌는 시기라면 iOS 26 SDK 필수 이후 앱 업데이트 점검도 함께 보시면 좋습니다. Xcode를 올리면서 SDK 버전을 같이 올리는 경우가 많아서, 두 작업을 한 번에 묶어 진행하면 반려를 덜 겪습니다.

자주 묻는 질문

데이터를 하나도 수집하지 않는 앱도 매니페스트가 필요한가요?

사유 필요 API를 쓰면 필요합니다. 설정값 저장에 UserDefaults만 써도 대상이라서, 실제로는 거의 모든 앱이 매니페스트를 갖게 됩니다. 수집 데이터가 없다면 해당 항목은 비워 둡니다.

Flutter나 React Native 앱도 개인정보 매니페스트를 챙겨야 하나요?

챙겨야 합니다. Apple의 SDK 목록에 Flutter, hermes, Capacitor, Cordova와 여러 Flutter 플러그인이 들어 있어서, 매니페스트가 포함된 버전을 써야 새 앱 제출이 막히지 않습니다.

사유 코드를 잘못 고르면 어떻게 되나요?

분류 이름이나 사유 코드가 Apple 목록과 다르면 형식 오류로 처리돼 업로드 단계에서 메일을 받습니다. 형식은 맞더라도 고른 사유가 실제 쓰임새와 다르면 Apple 규정 위반이므로, 앱 기능과 맞는 사유만 적어야 합니다.

개인정보 매니페스트와 App Store 개인정보 라벨은 같은 건가요?

다른 것입니다. 매니페스트는 앱 묶음 안에 들어가는 파일이고, 라벨은 App Store Connect에서 직접 입력하는 항목입니다. Xcode가 매니페스트를 모아 만든 개인정보 보고서를 보면서 라벨을 채우면 두 내용을 맞추기 쉽습니다.

iOS 앱 심사 준비나 SDK 정리가 필요하시면 상담 페이지로 앱 이름과 쓰고 있는 주요 SDK를 알려 주세요.

앱 개발이 고민되시나요?
앱 개발이 고민되시나요?

기획부터 출시까지, 모바일파트너스가 함께합니다

다른 아티클 살펴보기

다른 아티클 살펴보기

다른 아티클 살펴보기