IT 담당자용 설치 · 배포 가이드

이 문서는 고객사 IT 담당자가 모캡쳐?를 여러 대에 배포하고 운영하기 위한 안내입니다. 프로그램은 사용자 프로필 안에만 설치되며 관리자 권한을 요구하지 않습니다. 서비스 · 드라이버 · HKLM 레지스트리를 쓰지 않으므로 시스템 무결성에 영향을 주지 않습니다.

1. 배포 파일

배포 전에 SHA-256이 무광소프트가 공지한 값과 같은지 확인해 주십시오.

Get-FileHash .\모캡쳐-설치.zip -Algorithm SHA256

2. 설치

2.1 사용자가 직접 (대화형)

설치.bat을 더블클릭합니다. 설치가 끝나면 프로그램이 바로 실행됩니다.

2.2 무인 설치 (권장)

설치.bat /S

/S(또는 /SILENT, /QUIET)를 붙이면 화면 출력도 일시정지도 없이 설치하고, 프로그램을 실행하지 않은 채 끝납니다. 성공하면 종료 코드 0, 실패하면 1을 돌려줍니다. 배치 스크립트에서 다음처럼 결과를 확인할 수 있습니다.

call "%~dp0설치.bat" /S
if errorlevel 1 exit /b 1

설치 과정은 이렇습니다.

1. 실행 중인 MoCapture.exe가 있으면 종료
2. %LOCALAPPDATA%\Programs\MoCapture\MoCapture.exe 로 복사
3. 바탕화면과 시작 메뉴에 모캡쳐 바로가기 생성
4. (대화형일 때만) 프로그램 실행

2.3 설치 위치를 바꾸고 싶다면

install.ps1의 $appDir 한 줄만 고치면 됩니다. 다만 공유 폴더나 Program Files 아래는 권장하지 않습니다. 사용자 프로필 안에 두는 덕분에 관리자 권한이 필요 없기 때문입니다.

3. 그룹 정책(GPO)으로 배포

프로그램이 사용자 프로필에 설치되므로 사용자 구성 → 로그온 스크립트가 가장 잘 맞습니다. 컴퓨터 시작 스크립트로는 사용자 프로필에 접근할 수 없습니다.

3.1 배포 스크립트 예시

\\파일서버\공유\MoCapture\ 에 압축을 푼 6개 파일과 아래 스크립트를 함께 두십시오.

@echo off
setlocal
set SRC=\\파일서버\공유\MoCapture
set VER=1.3.0
set STAMP=%LOCALAPPDATA%\Programs\MoCapture\installed-%VER%.txt

rem 이미 이 버전이 깔려 있으면 아무것도 하지 않습니다(로그온이 느려지지 않도록).
if exist "%STAMP%" exit /b 0

call "%SRC%\설치.bat" /S
if errorlevel 1 exit /b 1

rem 정책 파일 배포 (4장 참조)
copy /y "%SRC%\settings.json" "%APPDATA%\MoCapture\settings.json" >nul
copy /y "%SRC%\patterns.json" "%APPDATA%\MoCapture\patterns.json" >nul
attrib +r "%APPDATA%\MoCapture\settings.json"
attrib +r "%APPDATA%\MoCapture\patterns.json"

echo %VER% > "%STAMP%"
exit /b 0

3.2 적용 절차

1. 그룹 정책 관리 콘솔에서 대상 OU에 새 GPO를 만듭니다.
2. 사용자 구성 → 정책 → Windows 설정 → 스크립트 → 로그온 에 위 배치 파일을 등록합니다.
3. 공유 폴더는 대상 사용자에게 읽기 권한만 주면 충분합니다.
4. 제거는 같은 방식으로 제거.bat /S 를 로그온 스크립트로 돌립니다.

Intune이나 SCCM을 쓰신다면 사용자 컨텍스트 Win32 앱으로 등록하고 설치 명령에 설치.bat /S, 제거 명령에 제거.bat /S, 탐지 규칙에 %LOCALAPPDATA%\Programs\MoCapture\MoCapture.exe 존재 여부를 쓰시면 됩니다.

4. settings.json 정책 템플릿

%APPDATA%\MoCapture\settings.json 을 배포하면 모든 사용자가 같은 설정으로 시작합니다. 파일을 읽기 전용(attrib +r)으로 만들면 사용자가 설정창에서 값을 바꿔도 저장되지 않고, 다음 실행 때 정책 값으로 돌아옵니다. 프로그램은 저장 실패를 조용히 넘기고 그대로 동작합니다.

완전한 잠금(설정창에서 항목을 아예 못 바꾸게 하는 기능)은 현재 제품에 없습니다. 위 방식은 "사용자가 바꿔도 다음 실행에 되돌아온다"는 수준의 소프트 통제입니다. 하드 잠금이 필요하시면 별도 협의 사항입니다.

4.1 보수적인 정책 예시 (사내 표준)

{
  "hotkeys": {
    "region": "PrintScreen",
    "fullScreen": "Ctrl+PrintScreen",
    "activeWindow": "Alt+PrintScreen",
    "element": "Shift+PrintScreen",
    "repeatLast": "Ctrl+Shift+PrintScreen",
    "scroll": "Ctrl+Alt+PrintScreen",
    "masked": "Ctrl+Alt+Shift+PrintScreen"
  },
  "saveFolder": "D:\\회사자료\\캡처",
  "fileNamePattern": "{yyyy}{MM}{dd}_{HH}{mm}{ss}",
  "format": "png",
  "jpgQuality": 90,
  "afterCapture": "editor",
  "fullScreenScope": "all",
  "includeCursor": false,
  "magnifier": true,
  "sound": false,
  "closeAfterSave": false,
  "uiAutomation": true,
  "runAtStartup": true,
  "autoCopyOnEditor": true,
  "editorWidth": 0,
  "editorHeight": 0,
  "editorMaximized": false,
  "lastColor": "#17A86F",
  "lastThickness": 4,
  "lastRegion": null,
  "sensitiveMode": "auto",
  "detectAmounts": false,
  "traceFree": true,
  "clipboardClearSeconds": 60
}

4.2 정책에서 특히 중요한 세 항목

runAtStartup을 true로 두면 프로그램이 직접 HKCU\...\Run에 자신을 등록합니다. GPO로 시작 프로그램을 관리하신다면 이 값을 false로 두고 정책으로 등록하셔도 됩니다.

4.3 주의

• settings.json이 깨져 있으면 프로그램은 조용히 기본값으로 시작합니다. 배포 전에 JSON 문법을 확인해 주십시오.
• 필드 이름은 위 목록 그대로 써야 합니다. 모르는 필드는 무시되고, 빠진 필드는 기본값이 쓰입니다.

5. patterns.json — 회사 고유 패턴 배포

기본 감지 대상(계좌번호 · 주민등록번호 · 휴대폰 · 카드번호 · 이메일) 외에 회사에서 쓰는 번호 체계를 추가하려면 %APPDATA%\MoCapture\patterns.json 을 배포합니다.

[
  { "name": "사번",     "pattern": "사번 [A-Z]{2}\\d{6}",        "description": "사번 AB123456 형태" },
  { "name": "계약번호", "pattern": "CT-\\d{4}-\\d{6}",           "description": "CT-2026-000123 형태" },
  { "name": "사내메일", "pattern": "[\\w.\\-]+@example\\.co\\.kr", "description": "사내 도메인 주소" }
]

• pattern은 .NET 정규식입니다. JSON이므로 역슬래시는 \\ 두 개로 쓰는 것이 정석이지만, 1개만 적어도 프로그램이 알아서 읽어 줍니다.
• 잘못된 정규식은 그 줄만 건너뛰고 설정창에 빨간 글씨로 어떤 줄이 문제인지 알려 줍니다. 나머지 패턴과 기본 패턴은 그대로 동작합니다.
• 파일을 고치면 설정창을 다시 열거나 "다시 읽기"를 누를 때 반영됩니다.
• 포터블 모드에서는 실행 파일 옆에 둡니다.

6. 포터블 모드

MoCapture.exe 옆에 portable.txt 라는 빈 파일을 두면 포터블 모드가 됩니다.

• settings.json 과 patterns.json 을 실행 파일 옆에서 읽고 씁니다.
• %APPDATA% 를 쓰지 않으므로 USB나 공유 폴더에서 바로 실행할 수 있습니다.
• 설치도 레지스트리 쓰기도 없습니다. 쓰기 금지 매체에 두면 설정 변경만 저장되지 않고 동작은 정상입니다.

공유 폴더에서 실행하실 경우, 프로그램이 174MB이므로 로그온마다 네트워크로 읽어 오는 것보다 로컬로 한 번 복사해 두는 편(3장 방식)이 훨씬 빠릅니다.

7. 제거

제거하면 프로그램 폴더 · 바로가기 · 시작 프로그램 등록이 지워집니다. 저장해 둔 캡처 그림은 지워지지 않습니다. 설정까지 모두 지우려면 %APPDATA%\MoCapture 폴더를 삭제하십시오.

8. 단축키 충돌

전역 단축키는 먼저 잡은 프로그램이 가져갑니다. 모캡쳐?는 등록에 실패해도 대화상자를 띄우지 않고, 설정창의 해당 항목에 빨간 글씨로 표시한 뒤 30초마다 조용히 다시 시도합니다. 충돌하던 프로그램을 끄면 모캡쳐?를 다시 켜지 않아도 단축키가 살아납니다.

자주 부딪히는 것들

사내 표준 단축키를 바꾸시려면 4장의 hotkeys 항목을 정책으로 배포하십시오. 빈 문자열("")로 두면 그 기능에는 단축키를 지정하지 않습니다(기본값: masked가 빈 값).

관리자 권한으로 실행 중인 창(작업 관리자 등) 위에서는 Windows가 일반 권한 프로그램에 단축키를 전달하지 않습니다. 이때는 트레이 아이콘을 왼쪽 클릭하면 영역 캡처가 시작됩니다.

9. 동작 요구 사항과 점검

민감정보 가림과 글자 복사는 Windows에 들어 있는 OCR 언어팩을 씁니다. 한국어 언어팩이 없는 PC에서는 그 두 기능만 상태 표시줄에 안내를 띄우고 동작하지 않으며, 나머지 캡처·편집 기능은 그대로 쓸 수 있습니다. 설치 여부는 다음으로 확인합니다.

[Windows.Media.Ocr.OcrEngine,Windows.Foundation,ContentType=WindowsRuntime] | Out-Null
[Windows.Media.Ocr.OcrEngine]::AvailableRecognizerLanguages | ForEach-Object { $_.LanguageTag }

배포 후 점검 목록

1. 트레이에 아이콘이 있고, 왼쪽 클릭하면 영역 캡처가 시작되는가
2. 설정창 하단 버전이 1.3.0 인가
3. 설정창의 단축키 항목에 빨간 "등록 실패" 표시가 없는가
4. 정책을 배포했다면 저장 폴더 · 민감정보 감지 · 흔적 0 값이 의도대로 보이는가
5. 민감한 번호가 있는 화면을 캡처했을 때 가려지는가