콘텐츠로 이동

MDM으로 에이전트 배포하기

회사의 설치 패키지를 MDM에 등록하고 서비스·호스트 연결을 확인합니다.

기기 > 호스트 > 목록 > 에이전트 다운로드에서 회사에 적용된 설치 파일을 받습니다. 버전 번호를 문서에서 고정해 선택하지 말고 회사에 제공되는 패키지를 사용하세요.

운영체제패키지와 실행 권한
Windows제공된 EXE 또는 ZIP 구성 전체를 사용하며 SYSTEM 권한으로 설치합니다.
macOSPKG를 사용하며 root 권한으로 설치합니다.

먼저 시험 기기에서 설치·연결·수집·제거를 확인한 뒤 배포 대상을 확대합니다. ZIP은 압축을 푼 폴더와 payload를 함께 패키징해야 합니다. 인터넷이 제한된 환경은 설치 파일에 구성 요소가 포함됐는지와 설치 후 서버 통신 가능 여부를 각각 확인하세요.

MDM운영체제안내
Microsoft IntuneWindows, macOSIntune으로 배포하기
Jamf PromacOSJamf Pro로 배포하기
Workspace ONEWindows, macOSWorkspace ONE으로 배포하기

다른 MDM을 사용한다면 아래 설치 명령과 확인 방법을 기준으로 등록합니다.

Windows는 ZIP 번들의 설치 파일로 설치하고 제거합니다.

Terminal window
SmplyAgentSetup.exe /quiet /norestart
SmplyAgentSetup.exe /uninstall /quiet /norestart

EXE 파일명이 다르면 실제 받은 설치 파일명을 사용합니다. 배포 패키지에서 구성 요소를 임의로 분리하지 마세요.

macOS는 PKG를 root 권한으로 설치합니다.

Terminal window
installer -pkg <설치 파일>.pkg -target /

macOS 설치 파일은 앱(.app)을 설치하지 않고 백그라운드 서비스만 설치합니다. MDM에 따라 앱 형식의 패키지만 받는 등록 유형이 있으니 MDM별 안내를 확인하세요.

에이전트 1.1.0-42 이상에서 다음 명령을 사용합니다. 그 이전 버전에는 Smplyw 서비스가 없으므로 서비스 조회 실패만으로 설치 실패라고 판단하지 마세요. 이전 버전은 호스트 목록의 에이전트 버전·마지막 확인 시각과 실제 수집 결과로 연결 상태를 확인합니다.

Terminal window
Get-Service Smplyw
Get-Process smplyd

Smplyw는 Windows 서비스이며 로그인한 사용자 세션에서 smplyd를 실행합니다. 로그인한 사용자가 없을 때 두 번째 명령에 프로세스가 나오지 않을 수 있습니다. 서비스 실행과 사용자 로그인 후 프로세스를 나눠 확인하세요.

설치 후 LaunchDaemon을 확인합니다.

Terminal window
sudo launchctl print system/app.smply.smplyd

브라우저 자동화 등 필요한 권한은 회사의 MDM에서 PPPC 프로파일로 관리합니다. AppleEvents는 보내는 앱과 제어할 브라우저를 구분하고, 필요한 경우 Accessibility 권한도 확인합니다. Apple의 PPPC 설정 안내

프로파일의 식별자와 CodeRequirement는 실제 배포할 서명된 설치본을 기준으로 확인해야 합니다. 검증되지 않은 Team ID나 과거 브라우저 서명 값을 그대로 복사하지 마세요. 배포 후 실제 브라우저에서 필요한 정보가 수집되는지도 확인합니다.

에이전트의 백그라운드 실행은 Managed Login Items 프로파일로 관리할 수 있습니다. Team Identifier 규칙에 8VTZL72ZHQ(심플리)와 8VBZ3948LU(Fleet)를 추가합니다. Apple의 Managed Login Items 안내

Team ID는 받은 설치 파일에서 다시 확인할 수 있습니다. 터미널에서 pkgutil --check-signature <설치 파일>을 실행하면 서명자 이름 뒤 괄호 안에 표시됩니다.

  • 시험 기기에서 설치와 제거 명령을 확인합니다.
  • Windows 서비스 또는 macOS LaunchDaemon 실행을 확인합니다.
  • 호스트 목록에서 버전과 마지막 확인 시각을 확인합니다.
  • 기존 기기와 연결하고 사용자 정보를 확인합니다.
  • 운영체제 권한과 실제 사용 정보 수집을 확인합니다.

설치에 실패하면 설치 로그와 패키지 구성, 필요한 런타임을 확인합니다. 서비스는 실행되지만 호스트가 보이지 않으면 네트워크와 회사별 설치 파일을 확인하세요. macOS에서 브라우저 정보만 누락되면 자동화 권한을 확인합니다.