# Mac 드래그 설치와 손쉬운 사용 권한 정리 현재 배포의 서명은 [고정 인증서·권한 유지 검증](MAC_FIXED_SIGNING.ko.md)을 따른다. 아래의 ad-hoc 관련 기록은 당시 빌드의 이력이다. 2026-09-26 · progress-30 · F61 / F82 · E02 / E05 ## 사용자가 하는 설치 [기기 관리 웹](https://remote.n3m.kr/)에서 로그인한 뒤 **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 앱 설치 안내](https://support.apple.com/ko-kr/guide/mac-help/mh35835/mac), [앱 열기 안내](https://support.apple.com/ko-kr/102445), [손쉬운 사용 허용 안내](https://support.apple.com/ko-kr/guide/mac-help/mh43185/mac). ## 왜 예전에는 압축 파일이었나 초기 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 정책·격리 속성을 변경하지 않았다. 권한 승인 후 실제 재접속 성공 여부는 사용자 확인이 필요하다. ## 구현과 게시 경로 - `scripts/macos_dmg.py`: macOS `hdiutil`로 HFS+ / UDZO 이미지를 만들고 검증한다. 앱, `/Applications` 바로가기, 한국어 설치 안내, 라이선스가 들어간다. OS 권한 변경이나 자동 실행 스크립트는 넣지 않는다. - `scripts/build-portable.py`: 향후 Mac 패키징 시 DMG와 메타데이터를 함께 만든다. 별도 CLI는 기존 검증 앱을 재빌드·재서명하지 않고 포장할 수 있다. - 앱 바이너리는 **0.1.0 / 1790445294** 그대로다. 이번 변경은 설치 포장과 서버 다운로드다. Developer ID 서명·공증·Mac 자동 업데이트는 이번에 구현하지 않았다. - 운영 게시기는 기존 허용 목록의 `.tar.gz`를 **배포 운반 파일**로 계속 검증한다. 이 안에 기존 앱·Info.plist·package.json과 DMG 일반 파일을 담았다. 게시기의 관리자 권한 범위를 넓히지 않았다. - `apps/control-server/src/api/admin/downloads/macos.rs`: 인증된 고정 Mac 다운로드 ID에 대해 운반 파일 안의 고정 이름 DMG만 읽는다. 서버 파일시스템에 풀거나 실행하지 않는다. 크기·항목 수를 제한하고 중복 메타데이터/DMG, 경로, gzip 손상, 선언한 DMG 크기·SHA-256·UDIF 꼬리표를 확인한다. 실제 디스크 내부 파일시스템 검사는 빌드 Mac의 `hdiutil`과 서명 검증에서 수행한다. - 다운로드 목록의 파일명·용량·해시와 실제 응답은 **내부 DMG 기준**이다. DMG가 없는 정상 예전 패키지는 `.tar.gz`로 제공한다. 잘못된 DMG 선언은 조용히 예전 파일로 대체하지 않고 거부한다. - `admin.js`: DMG 버튼, 드래그 설치 안내와 Mac 명령어를 표시한다. Windows EXE와 다운로드 인증 범위는 유지한다. ## 결과와 검증 범위 | 항목 | 확인 결과 | |---|---| | 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 대조](ADMIN_AND_COMPUTERS_UI.ko.md) · [검증 기록](evidence/mac-dmg-validation.json) · [다운로드 명령어·설치 안내](APP_DOWNLOAD_AND_INSTALL.ko.md) ## 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의 코드 서명 요구 조건 설명](https://developer.apple.com/documentation/technotes/tn3127-inside-code-signing-requirements). 이번 후속 작업에서는 Apple의 `tccutil reset`으로 **kr.n3m.notparsec의 Accessibility와 ScreenCapture만 초기화**했다. 다른 앱의 권한은 건드리지 않았다. 승인 기록이 사라진 것을 확인한 뒤 현재 앱을 LaunchServices로 실행해 검사했고, **현재 CDHash의 새 Accessibility 항목(아직 미승인)**이 생성됐다. 초기화는 권한을 허용하는 작업이 아니다. 이제 시스템 설정에서 현재 앱에 다시 승인해야 한다. 이전 progress-30 작업에서는 권한 기록을 변경하지 않았고, 이 후속 조사에서 처음 초기화했다. TCC 데이터베이스는 notParsec 항목을 읽기만 했으며 직접 쓰지 않았다. 관리자 권한으로 보호 기능을 끄거나 이전 앱의 서명을 흉내 내지 않는다. 사용자 재승인 후 기록·실제 영상 검사를 확인하고 결과를 갱신한다. 장기적으로는 지속적인 배포 서명 체계를 마련해야 하며, 이번 문제 해결을 위해 앱을 다시 빌드하거나 서명을 바꾸지는 않았다. [서명 대조·거부 로그·초기화·후속 검증 기록](evidence/mac-permission-repair.json) **후속 검증 결과:** 현재 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에서의 재접속 확인은 남았다.