notParsec / 문서전체 문서

설명·설계 문서

Mac 드래그 설치와 손쉬운 사용 권한 정리

design/MAC_DMG_INSTALL.ko.md

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

이 문서의 목차

현재 배포의 서명은 고정 인증서·권한 유지 검증을 따른다. 아래의 ad-hoc 관련 기록은 당시 빌드의 이력이다.

2026-09-26 · progress-30 · F61 / F82 · E02 / E05

사용자가 하는 설치

기기 관리 웹에서 로그인한 뒤 **macOS → Apple Silicon → 다운로드 (.dmg)**를 누른다. 현재 Intel 빌드는 준비 중이다.

  1. 받은 notparsec-darwin-arm64.dmg를 더블클릭한다.
  2. 기존 notParsec을 종료한다. 열린 설치 디스크의 notParsec.app → Applications로 드래그한다. 기존 앱이 있으면 대치를 선택한다.
  3. 복사가 끝나면 설치 디스크를 추출한다.
  4. Finder의 응용 프로그램에서 notParsec을 실행한다.
  5. 이 Mac에 원격 접속하려면 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용과 화면 및 시스템 오디오 녹음을 허용한 뒤 앱을 다시 실행한다.

처음 다운로드한 앱을 여는 과정과 원격 제어 권한 승인은 별개다. 현재 배포는 Apple 공증 전이므로 열기가 차단될 수 있다. 출처를 확인한 뒤 Apple의 그래도 열기 절차를 사용한다. DMG를 만들었다고 공증이 된 것은 아니다. Apple 앱 설치 안내, 앱 열기 안내, 손쉬운 사용 허용 안내.

왜 예전에는 압축 파일이었나

초기 Mac 배포가 개발용 .tar.gz 패키지를 그대로 제공했기 때문이다. Mac에서 드래그 설치가 불가능했던 것이 아니다. .app은 실행파일·FFmpeg·서명·자원을 묶은 앱 폴더이고, .dmg는 앱을 전달하는 읽기 전용 디스크 이미지다. Applications는 실제 /Applications로 연결되는 바로가기다. 앱을 그 위로 끌어 놓으면 앱 전체를 복사한다. DMG를 열거나 디스크 내부에서 앱을 실행하는 것만으로는 설치 위치가 정리되지 않는다.

이미 받은 예전 .tar.gz도 압축을 푼 뒤 앱 전체를 응용 프로그램에 복사하면 된다. 새 웹 다운로드와 터미널 명령은 DMG를 받는다. FFmpeg는 앱 내부에 포함되어 Homebrew 설치가 필요 없다. 앱을 교체해도 ~/Library/Application Support/notParsec의 사용자 설정은 보존한다.

이번 SSH 처리와 오류 원인

사용자가 제공한 오류의 실제 원인은 AXIsProcessTrusted()가 거부한 손쉬운 사용 권한이다. 상위 오류 문구가 이를 상대 PC GPU 초기화 실패로 묶어 보여 준다. 이 문구만으로 GPU 고장이라고 판단하면 안 된다.

확인 당시 실행 중인 앱은 /private/var/folders/…/AppTranslocation/…/notParsec.app 아래에 있었다. 별도로 설치된 ~/Applications/notParsec.app과 실행파일 해시는 같았다. 따라서 다른 버전이라는 증거는 없으며, 임시 실행 경로가 권한 거부의 유일한 원인이라고 단정하지 않는다.

SSH로 검증한 앱을 /Applications/notParsec.app에 복사하고 기존 프로세스를 종료한 뒤 정확한 경로에서 다시 실행했다. 예전 사용자 응용 프로그램의 복사본은 개발 작업 폴더로 옮겨 보존했다. 시작 프로세스 경로와 코드 서명을 확인했고 개인정보 보호 설정 및 앱 위치를 열었다. 사용자 프로필은 수정하지 않았다.

SSH로 파일 복사·검증·재실행·설정 화면 열기는 가능하지만 사용자 대신 macOS 개인정보 권한에 동의하지 않는다. 손쉬운 사용 항목이 이미 켜져 있는데 같은 오류가 나면 이전 notParsec 항목을 제거하고 +에서 응용 프로그램의 현재 notParsec을 다시 추가해 허용한다. 이 작업에서는 TCC 데이터베이스·Gatekeeper 정책·격리 속성을 변경하지 않았다. 권한 승인 후 실제 재접속 성공 여부는 사용자 확인이 필요하다.

구현과 게시 경로

결과와 검증 범위

항목 확인 결과
Apple Silicon 실제 DMG 생성·hdiutil 검사 통과
읽기 전용 마운트·Applications 대상 확인 /Applications
DMG 안 앱 및 복사한 앱의 코드 서명 통과
실행파일 SHA-256 80bc8373cbe6d836d5cf750ddf0c95395fc1a90214a25c0d319377b29b81719f
DMG 크기 25,164,290 bytes
DMG SHA-256 90271b86c16f8a4b5d3b36e6c0461b0d7b1b16bd690262473e705909e5f776d0
관리자/다운로드 회귀 시험 9개 통과, 손상·잘못된 이름/크기/해시·누락 DMG 거부 포함
웹 브라우저 시험 DMG/예전 tar·아키텍처·명령 복사·실제 다운로드·변경된 파일 거부·모바일 배치 확인
명령어 실행 환경 생성된 Mac 명령을 Linux Bash의 격리 서버에서 실행. 실제 Mac Terminal/Windows PowerShell 입력은 미검증
공개 게시 DMG 운반 파일·서버 해시 일치, 웹 JS·문서·readiness 확인. Windows EXE/업데이트 해시 보존
사용자 권한 승인·재접속 이 설치 변경 후 확인 대기
Intel·Apple 공증·Mac 자동 업데이트 미완료

이번 작업은 사용자가 요청한 Mac 배포(E05) 및 자체 웹(E02)에 해당한다. 보관 기준은 Windows Parsec 150-104a, 코어 SHA-256 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f다. 원본 Mac 설치 이미지의 화면·내부 구현 대조 자료는 없으며, 이번 DMG를 Parsec 원본 설치 UI 복원으로 표시하지 않는다. F61/F82 parity different와 기존 미완료 항목을 유지했다.

기존 원본 UI 대조 · 검증 기록 · 다운로드 명령어·설치 안내

progress-32 후속: 허용 스위치가 켜져도 실패한 실제 원인

2026-09-26 UTC / Mac 현지 2026-09-27에 같은 오류를 다시 조사했다. 초기 설치 경로 정리만으로는 해결되지 않는 권한 기록과 앱 서명의 불일치를 확인했다. 앞선 단순 재허용 안내로 해결되지 않았던 구체적인 원인이다.

비교 항목 확인한 값
이전 빌드 1790443069 / CDHash dc516dd6f47355ac21a0865bd7033bebe9471ae9
현재 설치된 빌드 1790445294 / CDHash f7829eb5a529d7e33b4ed32751b98e78ac559e1a
기존 손쉬운 사용·화면 녹화 승인 허용 값 2였지만 이전 빌드 CDHash를 요구
실제 권한 거부 로그 Failed to match existing code requirement / -67050

두 빌드의 서명은 실제 보존 앱과 현재 앱에서 읽어 대조했다. 현재 앱의 서명 자체는 정상이다. macOS는 같은 표시 이름만으로 기존 승인을 적용하지 않고, 승인 시 저장한 코드 요구 조건을 확인한다. 지금처럼 ad-hoc 서명을 사용하면 요구 조건이 특정 코드 버전에 묶인다. 앱을 교체한 뒤 스위치가 켜져 있어도 이전 요구 조건이 남으면 새 앱의 권한 검사에 실패할 수 있다. Apple의 코드 서명 요구 조건 설명.

이번 후속 작업에서는 Apple의 tccutil reset으로 kr.n3m.notparsec의 Accessibility와 ScreenCapture만 초기화했다. 다른 앱의 권한은 건드리지 않았다. 승인 기록이 사라진 것을 확인한 뒤 현재 앱을 LaunchServices로 실행해 검사했고, **현재 CDHash의 새 Accessibility 항목(아직 미승인)**이 생성됐다. 초기화는 권한을 허용하는 작업이 아니다. 이제 시스템 설정에서 현재 앱에 다시 승인해야 한다. 이전 progress-30 작업에서는 권한 기록을 변경하지 않았고, 이 후속 조사에서 처음 초기화했다.

TCC 데이터베이스는 notParsec 항목을 읽기만 했으며 직접 쓰지 않았다. 관리자 권한으로 보호 기능을 끄거나 이전 앱의 서명을 흉내 내지 않는다. 사용자 재승인 후 기록·실제 영상 검사를 확인하고 결과를 갱신한다. 장기적으로는 지속적인 배포 서명 체계를 마련해야 하며, 이번 문제 해결을 위해 앱을 다시 빌드하거나 서명을 바꾸지는 않았다.

서명 대조·거부 로그·초기화·후속 검증 기록

후속 검증 결과: 현재 CDHash f7829e…에 대해 손쉬운 사용과 화면 녹화 모두 허용 값 2로 바뀐 것을 확인했다. 설치된 동일 앱을 LaunchServices로 실행한 1초 video-probe도 통과했다. 실제 Mac 화면을 1668×1080 / H.264 / 4:2:0 8-bit / 설정 60 fps로 캡처했고, VideoToolbox 인코더 63개·앱 CPU 디코더 61개 프레임을 처리했다. 화면 파일을 저장하거나 네트워크로 전송하지 않았다. 이 검사는 macOS 입력 권한 확인과 실제 캡처·인코더 초기화 성공을 증명하며, Windows 수신 성능이나 실제 원격 입력 전달 시험을 대신하지 않는다. 권한 반영 후 GUI 앱을 재실행했다. 별도 사용자 PC에서의 재접속 확인은 남았다.