Ir para o conteúdo principal

Agente CtrlStation - MacOS

CtrlStation Agent para macOS

O que é?

O CtrlStation Agent é um serviço de segundo plano para macOS projetado para monitorar a atividade da sessão do usuário e interagir com um servidor de gerenciamento remoto.

Suas principais funções são:

  • Monitorar Eventos: Detecta e reporta quando o usuário realiza as seguintes ações:

    • Logon (início da sessão)

    • Logout (fim da sessão)

    • Bloqueio de Tela

    • Desbloqueio de Tela

  • Controle de Jornada: A cada 30 segundos, contata o servidor CtrlStation  para verificar se há comandos remotos para:

    • Bloquear a tela ou efetuar logout do usuário.

    • Exibir notificações de aviso em popup

O agente é configurado como um serviço de usuário (LaunchAgent), o que significa que ele inicia automaticamente quando o usuário faz login e para quando ele faz logout.

Requisitos

  • Sistema Operacional: macOS Ventura (versão 13.0) ou mais recente.

Download

O agente é distribuído como um pacote de instalação .pkg através de um link fornecido pela LAB3 ou seu parceiro de revenda

Instalação

A instalação é simples e guiada. Siga os passos abaixo:

  1. Execute o Instalador Dê um duplo clique no arquivo CtrlStationAgent-v1.2.1.pkg que você baixou.

  2. Siga as Instruções Prossiga pelas telas do instalador. Ele copiará os arquivos necessários para as pastas corretas e configurará o serviço.

  3. Aprove a Permissão de Automação Ao final da instalação, o sistema solicitará permissão para que o agente possa controlar eventos do sistema (necessário para o bloqueio de tela). Você deve clicar em "OK".

  4. Crie o Arquivo de Configuração (Passo Obrigatório) O agente não funcionará sem as informações do servidor. Você precisa criar este arquivo manualmente:

    • Caminho Exato: ~/.config/CtrlStationAgent/config.json

    • (O instalador abrirá a pasta ~/.config/CtrlStationAgent para você. Se não, crie-a manualmente).

    • Conteúdo do Arquivo (use o template abaixo, substituindo com seus dados

       

      {
    "apiURL": "https://[empresa].ctrlstation.com/api",
    "accessToken": "[disponivel em configurações - licença]"
}
      JSON

Após criar o arquivo config.json, o serviço, que já está rodando, o detectará e começará a funcionar normalmente.

Desinstalação

Para remover o agente, basta apagar do menu "Apps" ou apagar o diretório /Applications/CtrlStationAgent.app

Funcionamento e Logs

Como Funciona

  • O agente inicia junto com a sua sessão de usuário.

  • Ele permanece ativo em segundo plano, consumindo o mínimo de recursos.

  • Toda a comunicação com a API é registrada nos arquivos de log para fins de depuração.

Verificando os Logs

Para verificar os logs, utilize o comando:

Da última hora:

log show --debug --predicate 'subsystem == "com.lab3dvlp.CtrlStationAgent"' --last 1h
Voltar ao topo