macOS용 작업 마이닝 에이전트 설치

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 04월 27일
  • 소요 시간: 6분
  • macOS 워크스테이션에 작업 마이닝 데스크톱 에이전트를 설치하고 JAMF를 사용하여 관리되는 macOS 장치에 작업 마이닝 에이전트를 배포합니다. 이 절차는 엔터프라이즈 배포에 필요한 패키지, 스크립트, 정책 및 구성 프로파일을 만듭니다.

    시작하기 전에

    필요한 역할: 작업 마이닝 에이전트 설치
    주:
    에이전트를 설치 작업 마이닝 하려면 역할 itil, sn_tm_core.service_user 및 agent_client_collector_admin 역할이 있는 에이전트 설치 그룹에 속 작업 마이닝 해 있어야 합니다. 그룹이 없는 경우 해당 이름과 역할을 수동으로 사용하여 그룹을 만듭니다. 자세한 내용은 그룹에 역할 할당을 참조하세요.

    이 태스크 정보

    macOS용 작업 마이닝 에이전트는 .pkg 아카이브로 제공됩니다. 전체 다운로드 및 구성을 자동으로 처리하는 한 줄 터미널 스크립트를 사용하거나 설치 프로그램 패키지를 수동으로 다운로드하고 구성하여 설치할 수 있습니다.

    JAMF 배포는 두 개의 스크립트, 두 개의 정책 및 하나의 구성 프로파일을 생성합니다. 첫 번째 스크립트는 설치 관리자에 필요한 JSON 구성 파일을 생성합니다. 두 번째 스크립트는 에이전트가 설치되었는지 확인하고 설치되지 않은 경우 재설치를 트리거합니다. 첫 번째 정책은 패키지와 구성 스크립트를 결합하고 사용자 지정 트리거에서 실행됩니다. 두 번째 정책은 반복 일정에 따라 프로비저닝 스크립트를 실행합니다. 구성 프로파일은 에이전트가 데이터 캡처에 필요한 접근성 권한을 부여합니다.

    프로시저

    1. 인스턴스 URL등록 키를 가져옵니다.
      인스턴스 URL 및 등록 키 값은 Windows 및 macOS 에이전트에서 동일합니다.
      1. 다음으로 이동 모두 > 작업 마이닝 > 에이전트 설치.
      2. 기존 키를 선택하거나 새로 만듭니다.

        등록 키 선택의 스크린샷

      3. 에이전트 설치 페이지에서 인스턴스 URL등록 키를 복사합니다.

      인스턴스 URL 및 등록 키의 스크린샷입니다.

    2. 터미널 스크립트를 실행하여 macOS 에이전트를 설치합니다.
      1. 에이전트 설치 페이지에서 macOS 탭을 선택합니다.
      2. 다운로드 및 설치 옆에 있는 복사를 선택하여 한 줄 macOS 명령줄 스크립트를 수집합니다.
        macOS 명령줄의 스크린샷입니다.
      3. macOS 터미널 애플리케이션을 엽니다.
      4. 스크립트를 붙여넣고 Enter 키를 누릅니다.
      스크립트는 설치 관리자 패키지를 다운로드하고, 인스턴스 URL과 등록 키를 사용하여 필요한 구성 파일을 생성하고, 설치 관리자를 자동으로 실행합니다.
      주:
      수동 설치의 경우 Intel 및 Apple Silicon 및 JSON 파일을 다운로드합니다. 두 파일을 같은 폴더에 배치합니다. JSON 파일의 이름을 바꾸지 마십시오. .pkg 파일을 두 번 클릭(또는 키보드 단축키 사용)하여 설치 프로그램을 시작하고 화면의 지시를 따릅니다.
      JSON, Intel 및 Apple Silicon의 스크린샷.
    3. 에이전트 패키지를 JAMF에 추가합니다.
      1. JAMF 설정에서 패키지를 검색합니다.
      2. 새로 만들기를 선택합니다.
      3. 패키지 이름을 입력하고 에이전트를 보관 .pkg 업로드한 다음 패키지를 저장합니다.
    4. 구성 스크립트를 생성합니다.
      1. JAMF 설정에서 스크립트를 검색합니다.
      2. 새로 만들기를 선택합니다.
      3. 스크립트의 이름을 작업 마이닝 스크립트로 지정합니다.
      4. 스크립트 탭을 선택하고 적절한 스크립트 유형을 선택한 후 다음 스크립트를 입력합니다.
        #!/bin/bash
        #set these variables in the param sections 4 and 5
        REGAPIURL=$4
        REGKEY=$5
        TARGET="/Library/Application Support/JAMF/Downloads/"
        JSON="tm-macos-agent_installer.json"
        
        if [[ -z "REGAPIURL" || -z "REGKEY" ]]; then
            echo "reg api url and reg key must be set as 4 and 5 arguments"
            exit 1
        fi
        
        cd "$TARGET" || {
            echo "failed to change dir"
            exit 2
        }
        
        cat <<EOF > "$JSON"
        {
            "agent": {
                "reg-api-url": "$REGAPIURL",
                "reg-key": "$REGKEY"
            }
        }
        EOF
      5. 저장을 선택합니다.
    5. 프로비저닝 스크립트를 생성합니다.
      1. 새로 만들기를 선택하여 다른 스크립트를 추가합니다.
      2. 스크립트의 이름을 Task Mining Provisioning으로 지정합니다.
      3. 스크립트 탭을 선택하고 다음 스크립트를 입력합니다.
        #!/bin/bash
        APP_PATH="/Applications/Task Mining Agent.app"
        
        if [ ! -d "$APP_PATH" ]; then
            echo "taskmining is not installed -> triggering install via Jamf policy"
            if ! jamf policy -event taskmining_provisioning; then
                echo "error triggering jamf policy"
                exit
            fi
        else
            echo "taskmining app already installed"
        fi
      4. 저장을 선택합니다.
    6. 설치 관리자 정책을 생성합니다.
      1. JAMF 컴퓨터 범주에서 콘텐츠 관리 > 정책 을 클릭하고 새로 만들기를 선택합니다.
      2. 정책 이름을 작업 마이닝 설치 프로그램으로 지정합니다.
      3. 트리거 아래에서 사용자 지정을 선택하고 사용자 지정 이벤트 필드에 taskmining_provisioning를 입력합니다.
      4. 실행 빈도를진행 중으로 설정합니다.
      5. 저장을 선택합니다.
      6. 범위 탭에서 추가를 선택하고 대상 컴퓨터 또는 그룹을 선택한 다음 완료를 선택합니다.
      7. 사이드바에서 옵션 > 패키지 > 구성.
      8. 작업 마이닝 에이전트 패키지 옆에 있는 추가 를 선택합니다.
      9. 사이드바에서 스크립트 및 구성을선택합니다.
      10. 작업 마이닝 스크립트(작업 마이닝 프로비저닝 아님)를 찾아 추가를 선택합니다.
      11. 우선순위에서이전을 선택합니다.
      12. 인스턴스 URL을 매개변수 4 에 붙여넣고 등록 키를 매개변수 5에 붙여넣습니다.
      13. 저장을 선택합니다.
    7. 프로비저닝 정책을 생성합니다.
      1. 다음으로 이동 콘텐츠 관리 > 정책 을 클릭하고 새로 만들기를 선택합니다.
      2. 정책 이름을 작업 마이닝 프로비저닝으로 지정합니다.
      3. 트리거에서시작, 로그인반복 체크인을 선택합니다.
      4. 실행 빈도를진행 중으로 설정합니다.
      5. 범위 탭에서 설치 관리자 정책과 동일한 배포 대상을 추가합니다.
      6. 사이드바에서 스크립트 및 구성을 선택합니다.
      7. 작업 마이닝 프로비저닝(작업 마이닝 스크립트 아님)을 찾아 추가를 선택합니다.
        매개변수가 필요하지 않습니다.
      8. 이 정책에 패키지를 추가하지 마십시오.
      9. 저장을 선택합니다.
    8. 구성 프로파일을 생성합니다.
      1. JAMF 컴퓨터 범주에서 콘텐츠 관리 > 구성 프로파일 을 클릭하고 새로 만들기를 선택합니다.
      2. 프로파일에 작업 마이닝이라는 이름을 지정합니다.
      3. 사이드바에서 개인정보 기본 설정 정책 제어 를 선택하고 구성을 선택합니다.
      4. 다음 값을 입력하고 식별자 유형 목록에서 번들 ID를 선택합니다.
        • 식별자: com.servicenow.taskmining.agent
        • 코드 요구 사항:
          identifier "com.servicenow.taskmining.agent" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = AS2BZHDV7Q
        주:
        코드 요구 사항은 정적 값입니다. 이를 얻으려면 다음 터미널 명령을 실행합니다. codesign -dr - ./Task\ Mining\ Agent.app
      5. 추가를 선택합니다.
      6. 앱 또는 서비스에서 접근성을 선택합니다.
      7. 액세스 아래에서 허용을 선택합니다.
      8. 접근성 권한에 대해 저장 을 선택한 다음, 전체 프로필에 대해 페이지 하단에서 저장을 다시 선택합니다.
    9. 디먼을 관리되는 로그인 항목으로 표시합니다.
      1. 구성 프로파일에서 관리되는 로그인 항목을 선택합니다.
      2. 다음 값으로 규칙을 추가합니다.
        • 규칙 레이블: com.servicenowtaskmining.daemon
        • 팀 식별자: AS2BZHDV7Q
        주:
        팀 식별자는 제목과 같은 값입니다 . 이전 단계의 코드 요구 사항의 OU입니다.
      3. 저장을 선택합니다.

    다음에 수행할 작업

    macOS 장치에서 정책을 디버깅하려면 터미널에서 수동으로 트리거할 수 있습니다. 정책 식별자는 해당 정책을 편집할 때 JAMF URL의 ID 값입니다.
    sudo jamf policy -id policy-id