# Mac 업데이트 후 권한을 유지하는 고정 코드 서명 2026-09-26 · progress-35 · F07 / F20 / F82 · E05 ## 적용 결과 **Apple Silicon 빌드 1790451255부터 고정된 개인용 인증서로 앱과 FFmpeg를 서명한다.** 빌드마다 새로 만들어지던 ad-hoc 서명을 제거했다. 빌드용 Mac에서 인증서를 한 번 등록하고, 기존 앱의 권한을 새 서명에 승인한 뒤 실제로 다음 빌드로 교체했다. 재승인이나 권한 초기화 없이 손쉬운 사용·화면 녹화 권한이 유지됐으며 실제 화면 캡처도 성공했다. | 검증 단계 | 이전 앱 A | 새 앱 B | |---|---|---| | 빌드 | 1790450061에 고정 서명 적용 | 1790451255 네이티브 release 빌드 | | 실행파일 SHA-256 | `4f133072aa9284e438f3639959f20144cdd1773585c8c860972ed0d0033c7bbe` | `5eb6cddab3e8672172a7702c370cdcf42d326d342a499f74aa27c947af5ef397` | | 앱 식별 조건 | 앱 ID + 인증서 지문 | A와 동일 | | 손쉬운 사용·화면 녹화 | 사용자 최초 승인 | 승인값·조건·승인 시각 유지 | | 실제 화면 2초 검사 | 122개 인코딩 / 120개 디코딩 | 123개 인코딩 / 122개 디코딩 | 영상 검사는 실제 Mac 화면 1668×1080, H.264 VideoToolbox, 60fps 설정에서 수행했다. 이 숫자는 파이프라인 동작 검사이며 Windows 수신 성능·원본 Parsec 성능 비교가 아니다. 새 앱은 실제 배포 DMG를 읽기 전용으로 마운트해 복사했으며, 교체 후 GUI도 실행했다. 이전 [이중 커서 수정](MAC_CURSOR.ko.md)의 `-capture_cursor 0`이 실제 캡처 프로세스에 전달되는 것도 확인했다. 원격 Windows 화면에서 한 커서만 보이는지에 대한 사용자 최종 관찰은 별도다. 최종 설치·배포용 빌드 **1790451741**에는 동시에 진행된 기기 운영체제 정보 보고도 포함했다. 이 빌드로 한 번 더 교체한 뒤에도 동일한 승인 기록이 유지됐고, 실제 화면 2초 검사에서 123개 인코딩·121개 디코딩을 확인했다. ## 왜 같은 이름의 앱인데 권한이 사라졌나 macOS는 표시 이름만으로 앱을 신뢰하지 않는다. 권한을 승인할 때 앱이 만족해야 할 코드 서명 조건인 **designated requirement**를 함께 저장한다. 기존 ad-hoc 서명은 특정 코드의 해시인 CDHash에 묶였다. 빌드가 바뀌면 그 조건을 만족하지 못해, 스위치가 켜져 있어도 새 앱의 입력 권한이 거부될 수 있었다. 실제 이전 오류와 로그는 [권한 불일치 복구 기록](MAC_DMG_INSTALL.ko.md)에 있다. 이번에는 같은 개인키와 인증서를 계속 사용하고 다음 조건을 서명에 명시한다. ```text identifier "kr.n3m.notparsec" and certificate leaf = H"e9c16b6d76c8bafa1dbf972a47522e2c689b0511" ``` 앱 이름·ID만 검사하도록 완화한 것이 아니다. 해당 인증서의 개인키로 서명된 코드만 이 조건을 만족한다. 실행파일의 내용과 CDHash가 바뀌어도 위 조건은 유지되므로 다음 빌드를 같은 앱으로 판단할 수 있다. 변조한 실행파일과 동일 ID의 ad-hoc 서명 파일이 거부되는 것도 실제 Mac에서 검사했다. [Apple의 코드 요구 조건 설명](https://developer.apple.com/documentation/technotes/tn3127-inside-code-signing-requirements), [인증서 조건·자체 서명 설명](https://developer.apple.com/library/archive/documentation/Security/Conceptual/CodeSigningGuide/RequirementLang/RequirementLang.html). ## 인증서 보관과 빌드 방식 - `scripts/init-macos-signing.py`: 빌드용 Mac에 RSA 3072비트 코드 서명 인증서를 최초 한 번 생성한다. 기존 설정이 있으면 같은 인증서를 재사용하고, 불완전한 상태에서 임의로 키를 재생성하지 않는다. - 개인키는 빌드용 Mac의 전용 키체인에 추출 불가로 가져온다. 키체인·잠금 해제 정보는 소유자만 접근할 수 있으며 저장소·배포 파일로 복사하지 않는다. 임시 PEM·PKCS#12 파일은 가져온 뒤 삭제한다. 키 사용은 코드 서명 도구로 제한하고 서명 후 키체인을 잠근다. - 인증서 신뢰는 해당 Mac 사용자 영역의 **코드 서명 정책에만** 등록했다. 기존 키체인 검색 목록을 보존하고 전용 키체인을 추가했다. 사용자 인증이 필요한 최초 등록은 Mac의 정상 승인 화면에서 처리했다. - `scripts/macos_signing.py`: 인증서 지문·유효 기간·파일 권한을 검사한다. 앱 `kr.n3m.notparsec`와 보조 실행파일 `kr.n3m.notparsec.ffmpeg`를 같은 인증서로 각각 서명하고, 지정된 조건과 전체 번들을 검증한다. - `scripts/build-portable.py`: 기본 Mac release 빌드는 고정 인증서를 요구한다. 인증서 누락·변경·유효성 오류가 있으면 중단하며 임시 서명으로 되돌아가지 않는다. 개발용 ad-hoc 서명은 명시적인 `--debug --mac-adhoc` 조합으로만 허용한다. - `package.json`에는 인증서 공개 지문과 앱 식별 조건을 기록한다. 인증서 유효 기간은 2026-09-26부터 2036-09-23까지다. 개인키나 키체인 비밀번호는 포함하지 않는다. 빌드용 Mac의 저장소 디렉터리에서 처음 한 번 실행한다. 현재 연결된 Mac에서는 이미 완료했으므로 반복할 필요가 없다. ```sh python3 scripts/init-macos-signing.py --authorize-trust ``` 이후에는 기존 빌드 명령을 사용한다. ```sh python3 scripts/build-portable.py --target aarch64-apple-darwin --ffmpeg-bundle /path/to/ffmpeg-arm64 ``` 기본 설정 위치는 `~/Library/Application Support/notParsec/signing/config.json`이다. 다른 빌드 환경에서는 `--mac-signing-config` 또는 `NOTPARSEC_MAC_SIGNING_CONFIG`로 지정한다. 이 디렉터리는 키체인과 함께 빌드용 Mac의 보호된 백업으로 유지해야 한다. 인증서를 잃어버렸다고 같은 이름의 새 인증서를 만들면 지문은 달라지고 권한 재승인이 필요해질 수 있다. ## 한 번의 전환 승인과 남는 한계 임시 서명에서 이번 인증서로 바뀌는 최초 전환은 사용자 동의가 필요했다. 과거 임시 서명의 notParsec 손쉬운 사용 기록만 정상 `tccutil` 절차로 초기화한 뒤 사용자가 승인했다. **그 다음 A→B 교체에서는 권한을 초기화하거나 승인 기록을 수정하지 않았다.** 기존 승인 기록의 지문이 새 앱 인증서와 일치했고 실제 입력 권한 검사와 화면 캡처가 통과했다. 이번 인증서는 개인용 자체 서명 인증서이며 **Apple Developer ID 발급·앱 공증은 아니다.** 업데이트 권한 유지와 다운로드 파일의 Gatekeeper 검사는 다른 문제다. 인터넷에서 받은 파일의 첫 실행 안내가 모두 사라진다고 보장하지 않는다. 인증서를 교체하거나 macOS에서 권한을 초기화·철회하면 재승인이 필요하다. Mac 자동 업데이트와 Intel 빌드는 여전히 후속 작업이다. ## Parsec 대조와 검증 범위 기준 Windows Parsec 150-104a의 코어 SHA-256은 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f`다. [통합 앱·로더·플랫폼 책임 구조](../analysis/parsec/STRUCTURE_ANALYSIS.ko.md)를 기준으로, 이번 변경은 사용자 요청 및 E05의 Mac 패키징에 해당한다. 보관한 원본은 Windows 버전이므로 Mac Parsec의 서명 인증서·공증·TCC 이전 동작을 확인했다고 주장하지 않는다. 직접 작성한 Python 빌드 도구이며 원본 소스나 디컴파일 복원 코드가 아니다. F07/F20/F82 전체의 parity `different`와 부분 구현 상태를 유지한다. 서명 테스트는 Mac 5개 통과, Linux에서는 독립 가드 4개 통과·Mac 실행 시험 1개 제외다. 두 코드 버전의 동일 식별 조건, 다른 서명 거부, 파일 변조 거부, 인증서 교체·외부 노출·심볼릭 링크 거부를 포함한다. 실제 앱 A→B DMG 설치와 권한 유지·영상 처리 검사는 이 단위 시험과 별도로 수행했다. [검증 기록](evidence/mac-fixed-signing-validation.json) · [현재 Mac 다운로드](MAC_DOWNLOADS.ko.md) · [DMG 설치 안내](MAC_DMG_INSTALL.ko.md)