Agente CtrlStation - Linux

Agente CtrlStation - Linux 

 O Agente CtrlStation é um daemon de sistema projetado para ambientes que necessitam de monitoramento e gerenciamento remoto de estações de trabalho Linux. 

 O que é o Agente CtrlStation? 

 O Agente é um serviço que roda em segundo plano no computador do usuário e executa as seguintes funções: 

 

 

 Monitoramento de Sessão : Envia notificações para um servidor central quando eventos de sessão ocorrem (Logon, Logout, Bloqueio e Desbloqueio de tela). 

 

 

 Comunicação Periódica : Efetua uma chamada de "heartbeat" a cada 30 segundos para o servidor, informando que a estação está ativa. 

 

 

 Execução de Ações Remotas : Recebe comandos do servidor para executar ações na máquina local, como: 

 

 

 Bloquear a sessão do usuário. 

 

 

 Encerrar a sessão do usuário (logoff). 

 

 

 Exibir notificações e avisos em formato de popup. 

 

 

 

 

 Como Baixar 

 A versão mais recente do pacote de instalação ( .deb ) pode ser baixada do link a seguir: 

 

 

 https://download.ctrlstation.com/ctrl-station-agent_1.2.0-1_amd64.deb 

 

 

 Será solicitado usuário e senha que são fornecidos pela LAB3 ou seu parceiro de revenda. 

 Requisitos de Sistema 

 

 

 Sistema Operacional : Ubuntu 20.04 LTS (ou superior) ou Debian 11 (ou superior). 

 

 

 Arquitetura : amd64 (x86_64). 

 

 

 Ambiente Gráfico : Necessário para a exibição de notificações (ex: GNOME, KDE, XFCE). 

 

 

 Conexão de Rede : Conectividade via porta 443 (HTTPS) com o servidor do CtrlStation 

 

 

 Instalação via Pacote ( .deb ) 

 A instalação é simples e deve ser feita através do terminal. O uso do comando  apt é recomendado pois ele instala automaticamente todas as dependências necessárias. 

 

 

 Abra um terminal. 

 

 

 Navegue até o diretório onde você baixou o arquivo .deb . 

 

 

 Execute o comando a seguir, substituindo o nome do arquivo pelo que você baixou: 

 

 

 sudo apt install ./ctrl-station-agent_1.2.0-1_amd64.deb 

 O terminal solicitará sua senha de administrador. Após a confirmação, o apt instalará o agente, suas dependências (como Python e Zenity) e configurará o serviço para iniciar automaticamente. 

 Desinstalação 

 Para remover completamente o Agente CtrlStation do sistema, utilize o seguinte comando no terminal: 

 sudo apt remove ctrl-station-agent 

 Isso removerá a aplicação. Se você também desejar remover os arquivos de configuração, utilize o comando purge : 

 sudo apt purge agente-ctrlstation 

 Funcionamento e Logs 

 Como Funciona 

 

 

 O Agente é instalado como um serviço de usuário global do systemd . 

 

 

 Isso significa que uma instância do serviço será iniciada automaticamente para cada usuário que fizer login no sistema. 

 

 

 O processo roda com as permissões do próprio usuário, garantindo a segurança e a integração com o ambiente gráfico. 

 

 

 O arquivo de configuração principal, que contém a URL do servidor e o token de acesso, está localizado em: 

 

 

 

 

 

 

 /etc/ctrl-station/config.ini 

 

 

 

 

 

 

 

 Nota para Administradores: Após a instalação, este arquivo deve ser editado para inserir as informações corretas do seu ambiente. 

 

 

 

 Verificando a Atividade (Logs) 

 Para monitorar a atividade do agente ou diagnosticar problemas, você pode visualizar seus logs em tempo real. Como o serviço roda no contexto do usuário, utilize o seguinte comando no terminal do usuário logado: 

 journalctl --user -u monitor-daemon.service -f