notParsec / 문서전체 문서

설명·설계 문서

Mac 업데이트 후 권한을 유지하는 고정 코드 서명

design/MAC_FIXED_SIGNING.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

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도 실행했다. 이전 이중 커서 수정의 -capture_cursor 0이 실제 캡처 프로세스에 전달되는 것도 확인했다. 원격 Windows 화면에서 한 커서만 보이는지에 대한 사용자 최종 관찰은 별도다.

최종 설치·배포용 빌드 1790451741에는 동시에 진행된 기기 운영체제 정보 보고도 포함했다. 이 빌드로 한 번 더 교체한 뒤에도 동일한 승인 기록이 유지됐고, 실제 화면 2초 검사에서 123개 인코딩·121개 디코딩을 확인했다.

왜 같은 이름의 앱인데 권한이 사라졌나

macOS는 표시 이름만으로 앱을 신뢰하지 않는다. 권한을 승인할 때 앱이 만족해야 할 코드 서명 조건인 designated requirement를 함께 저장한다. 기존 ad-hoc 서명은 특정 코드의 해시인 CDHash에 묶였다. 빌드가 바뀌면 그 조건을 만족하지 못해, 스위치가 켜져 있어도 새 앱의 입력 권한이 거부될 수 있었다. 실제 이전 오류와 로그는 권한 불일치 복구 기록에 있다.

이번에는 같은 개인키와 인증서를 계속 사용하고 다음 조건을 서명에 명시한다.

identifier "kr.n3m.notparsec" and certificate leaf = H"e9c16b6d76c8bafa1dbf972a47522e2c689b0511"

앱 이름·ID만 검사하도록 완화한 것이 아니다. 해당 인증서의 개인키로 서명된 코드만 이 조건을 만족한다. 실행파일의 내용과 CDHash가 바뀌어도 위 조건은 유지되므로 다음 빌드를 같은 앱으로 판단할 수 있다. 변조한 실행파일과 동일 ID의 ad-hoc 서명 파일이 거부되는 것도 실제 Mac에서 검사했다. Apple의 코드 요구 조건 설명, 인증서 조건·자체 서명 설명.

인증서 보관과 빌드 방식

빌드용 Mac의 저장소 디렉터리에서 처음 한 번 실행한다. 현재 연결된 Mac에서는 이미 완료했으므로 반복할 필요가 없다.

python3 scripts/init-macos-signing.py --authorize-trust

이후에는 기존 빌드 명령을 사용한다.

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다. 통합 앱·로더·플랫폼 책임 구조를 기준으로, 이번 변경은 사용자 요청 및 E05의 Mac 패키징에 해당한다. 보관한 원본은 Windows 버전이므로 Mac Parsec의 서명 인증서·공증·TCC 이전 동작을 확인했다고 주장하지 않는다. 직접 작성한 Python 빌드 도구이며 원본 소스나 디컴파일 복원 코드가 아니다. F07/F20/F82 전체의 parity different와 부분 구현 상태를 유지한다.

서명 테스트는 Mac 5개 통과, Linux에서는 독립 가드 4개 통과·Mac 실행 시험 1개 제외다. 두 코드 버전의 동일 식별 조건, 다른 서명 거부, 파일 변조 거부, 인증서 교체·외부 노출·심볼릭 링크 거부를 포함한다. 실제 앱 A→B DMG 설치와 권한 유지·영상 처리 검사는 이 단위 시험과 별도로 수행했다.

검증 기록 · 현재 Mac 다운로드 · DMG 설치 안내