Instale o agente Mineração de tarefas para macOS

  • Versão de lançamento: Australia
  • Atualizado 27 de abr. de 2026
  • 5 min. de leitura
  • Instale o agente de mineração de tarefas para desktop nas estações de trabalho macOS e implante o agente de mineração de tarefas em dispositivos macOS gerenciados usando o JAMF. Este procedimento cria o pacote, os scripts, as políticas e o perfil de configuração necessários para a implantação empresarial.

    Antes de Iniciar

    Função necessária: Mineração de tarefas Instalação do agente
    Nota:
    Você deve fazer parte do Mineração de tarefas Grupo de instalação do agente com funções itil, sn_tm_core.service_user e agent_client_collector_admin para instalar o. Mineração de tarefas agente. Se o grupo não existir, crie um grupo com esse nome e essas funções manualmente. Para obter mais informações, consulte Atribua uma função a um grupo .

    Por Que e Quando Desempenhar Esta Tarefa

    O agente Mineração de tarefas para macOS é entregue como .pkg arquivo. Ele pode ser instalado usando um script de terminal de uma linha, que lida com todo o download e configuração automaticamente, ou baixando e configurando o pacote do instalador manualmente.

    A implantação do JAMF cria dois scripts, duas políticas e um perfil de configuração. O primeiro script gera o arquivo de configuração JSON de que o instalador precisa. O segundo script verifica se o agente está instalado e aciona uma reinstalação caso contrário. A primeira política combina o pacote e o script de configuração e é executada em um gatilho personalizado. A segunda política executa o script de provisionamento em uma programação recorrente. O perfil de configuração concede as permissões de acessibilidade que o agente requer para a captura de dados.

    Procedimento

    1. Obtenha o. URL da instância e. Chave de registro .
      Os valores da URL da instância e da chave de registro são os mesmos para agentes do Windows e do macOS.
      1. Navegar até Tudo > Mineração de tarefas > Instalação do agente.
      2. Selecione uma chave existente ou crie uma.

        Captura de tela da seleção da chave de registro.

      3. Copie o. URL da instância e. Chave de registro Na página Instalação do agente.

      Captura de tela do URL da instância e da chave de registro.

    2. Instale o agente do macOS executando o script do terminal.
      1. Selecione MacOS na Instalação do agente página.
      2. Selecione Cópia ao lado de Download e instalação Para coletar o script de linha de comando de uma linha do macOS.
        Captura de tela da linha de comando do macOS.
      3. Abra o macOS Terminal aplicação.
      4. Cole o script e pressione Insira .
      O script baixa o pacote do instalador, gera o arquivo de configuração necessário usando o URL da instância e a chave de registro e executa o instalador automaticamente.
      Nota:
      Para uma instalação manual, baixe os arquivos JSON e Silicon da Intel e da Apple. Coloque ambos os arquivos na mesma pasta. Não renomeie o arquivo JSON. Clique duas vezes (ou use o atalho de teclado) no arquivo .pkg para iniciar o instalador e siga as instruções na tela.
      Captura de tela de JSON e Intel e Apple Silicon.
    3. Adicione o pacote do agente ao JAMF.
      1. Em Configurações do JAMF, pesquise por Pacotes .
      2. Selecione Novo.
      3. Insira o nome do pacote e carregue o agente .pkg arquive e salve o pacote.
    4. Crie o script de configuração.
      1. Em Configurações do JAMF, pesquise por Scripts .
      2. Selecione Novo.
      3. Nomeie o script Script de mineração de tarefas .
      4. Selecione Script escolha o tipo de script apropriado e insira o seguinte script:
        #!/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. Selecione Save (Salvar).
    5. Crie o script de provisionamento.
      1. Selecione Novo para adicionar outro script.
      2. Nomeie o script Provisionamento de mineração de tarefas .
      3. Selecione Script e insira o seguinte script:
        #!/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. Selecione Save (Salvar).
    6. Crie a política do instalador.
      1. No JAMF Computadores categoria, navegue até Gestão de conteúdo > Políticas e selecione Novo .
      2. Nomeie a política Instalador de mineração de tarefas .
      3. Em Gatilho , selecione Personalizado e insira taskmining_provisioning em Evento personalizado campo.
      4. Definido Frequência de execução para Em andamento .
      5. Selecione Save (Salvar).
      6. Em Escopo selecione Adicionar , selecione os computadores ou grupos de destino e selecione Concluído .
      7. Na barra lateral, selecione Opções > Pacotes > Configurar.
      8. Selecione Adicionar Ao lado do pacote Agente de mineração de tarefas.
      9. Na barra lateral, Scripts e. Configurar .
      10. Localizar Script de mineração de tarefas (Não provisionamento de mineração de tarefas) e selecione Adicionar .
      11. Em Prioridade , selecione Antes .
      12. Cole o URL da instância em Parâmetro 4 E a chave de registro em Parâmetro 5 .
      13. Selecione Save (Salvar).
    7. Crie a política de provisionamento.
      1. Navegar até Gestão de conteúdo > Políticas e selecione Novo .
      2. Nomeie a política Provisionamento de mineração de tarefas .
      3. Em Gatilho , selecione Inicialização , Login e. Check-in recorrente .
      4. Definido Frequência de execução para Em andamento .
      5. Em Escopo adicione os mesmos destinos de implantação da política do instalador.
      6. Na barra lateral, selecione Scripts e. Configurar .
      7. Localizar Provisionamento de mineração de tarefas (Não script de mineração de tarefas) e selecione Adicionar .
        Nenhum parâmetro é necessário.
      8. Não adicione nenhum pacote a esta política.
      9. Selecione Save (Salvar).
    8. Crie o perfil de configuração.
      1. No JAMF Computadores categoria, navegue até Gestão de conteúdo > Perfis de configuração e selecione Novo .
      2. Nomeie o perfil Mineração de tarefas .
      3. Na barra lateral, selecione Controle de política de preferências de privacidade e selecione Configurar .
      4. Insira os seguintes valores e selecione ID do pacote em Tipo de identificador lista:
        • Identificador : com.servicenow.taskmining.agent
        • Requisito de código :
          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
        Nota:
        O requisito de código é um valor estático. Para obtê-lo, execute o seguinte comando de terminal: Co-design -dr - ./Task Mining Agent.app
      5. Selecione Adicionar.
      6. Em App ou serviço , selecione Acessibilidade .
      7. Em Acesso , selecione Permitir .
      8. Selecione Salvar para a permissão de acessibilidade, selecione Salvar novamente na parte inferior da página para todo o perfil.
    9. Marque o daemon como um item de login gerenciado.
      1. No perfil de configuração, selecione Itens de login gerenciados .
      2. Adicione uma regra com os seguintes valores:
        • Rótulo de regra : com.servicenowtaskmining.demon
        • Identificador da equipe : AS2BZHDV7Q
        Nota:
        O Identificador da equipe tem o mesmo valor que Assunto.OU no requisito de código da etapa anterior.
      3. Selecione Save (Salvar).

    O que Fazer Depois

    Para depurar políticas em um dispositivo macOS, você pode acioná-las manualmente no Terminal. O identificador de política é o valor do ID no URL do JAMF ao editar essa política.
    sudo jamf policy -id policy-id