Manual de utilização do PersonalSOC

Este manual explica como usar a aplicação que reúne, só de leitura e com um botão, os registos e o estado das defesas deste dispositivo num relatório que se percebe de relance. Primeiro explicam-se as operações no ecrã, e a linha de comandos fica reunida num capítulo mais à frente.

1. O que é o PersonalSOC

O PersonalSOC é uma aplicação que reúne os registos e o estado das defesas deste dispositivo e os resume em constatações e num relatório. Foi pensada para que uma pessoa sem pessoal de segurança dedicado veja, com provas, o que se passa no seu dispositivo e decida o que fazer a seguir.

É só de leitura, por isso não altera definições, não apaga ficheiros nem bloqueia comunicações. A análise dos registos é feita por analisadores de procedimento fixo que não usam nem um LLM nem a rede. A integração com LLM é opcional e está desativada no início.

O que não faz

• É uma ferramenta para o único dispositivo em que corre. Não há função para ver vários dispositivos em conjunto.
• Nunca eleva os seus privilégios. Um registo que só o root consegue ler é mostrado como «ilegível» e o sudo não é usado.
• «Sem deteções» não é prova de segurança. O risco global também é apenas uma estimativa de 0 a 100, não uma probabilidade.
• Lê apenas um conjunto fixo de fontes. Não é possível indicar no ecrã ficheiros nem comandos a ler.

2. Instalação e arranque

O PersonalSOC é uma aplicação separada do RoamSwitch. Tem o seu próprio ícone e é distribuída junto com o RoamSwitch. Os menus do RoamSwitch não têm entrada para ela; abre-se como uma aplicação independente.

3. A primeira verificação do estado

Só lê as fontes fixas quando carrega em «Verificar estado». As fontes que não quer que leia podem ser desativadas nas definições.

Passos

1. Abra a aplicação e prima «Definições» no canto superior direito.
2. Por baixo aparecem as fontes lidas neste sistema operativo. Desmarque as que não quer que sejam lidas.
3. Prima «Guardar» e depois «← Voltar» para regressar ao ecrã inicial.
4. Prima «Verificar estado». Aparece uma barra de progresso e, no fim, os separadores de resultados.

No fim aparecem as contagens, por exemplo «Verificação concluída. 3 deteção(ões) / 2 IOC». O capítulo seguinte explica os separadores.

4. Como ler os resultados

5. Definições e execução periódica

«Definições», no canto superior direito do ecrã inicial, está dividido em separadores por função. Depois de alterar algo, prima «Guardar» e depois «← Voltar» para regressar ao início.

Idioma de apresentação Além de «Automático (seguir o sistema)», pode escolher japonês, inglês, alemão, espanhol, francês, italiano, coreano, português (Portugal), chinês simplificado ou chinês tradicional, cada um mostrado com o seu próprio nome.

Execução periódica (opcional)

Marque «Verificar automaticamente a intervalos regulares» e guarde: no Mac é registado como agente de utilizador do launchd e no Linux como temporizador de utilizador do systemd. O intervalo escolhe-se entre 7 níveis de 15 minutos a 24 horas e no início é de 1 hora.

Só é executado o personalsoc scan --notify, sem usar root. Notifica apenas quando existe uma deteção que não existia da última vez, e a mensagem contém só contagens (no Linux é preciso o notify-send). Também pode desativar a notificação com «Notificar apenas quando existir uma deteção que não existia da última vez».

Desmarque a caixa e guarde: o registo é removido.

6. Integração com LLM (opcional)

A integração com LLM é opcional e está desativada no início. Depois de ativada, após a verificação do estado, o comando do LLM escolhido faz uma investigação adicional e redige um relatório como auditor. Os comandos que pode usar são opencode, claude, codex e agy.

Passos

1. Marque «Ativar a integração com LLM».
2. Escolha o «LLM a utilizar». Um indicado como «(não instalado)» não tem o comando neste dispositivo.
3. Se necessário, altere o modelo e o tempo limite (segundos). Se deixar o modelo vazio, é usado o predefinido desse LLM.
4. Prima «Guardar», volte ao início e prima «Verificar estado». Depois da verificação, a investigação do LLM corre logo a seguir.

O que chega ao LLM

• São entregues o conteúdo das deteções, as linhas de registo que servem de prova, as cadeias devolvidas pelo MCP e as notas sobre as fontes. São entregues para que a situação seja investigada com rigor.
• Antes de os entregar, os segredos como chaves, tokens e palavras-passe são mascarados e os carateres invisíveis são removidos.
• O PersonalSOC não dá ao LLM nem uma shell nem ficheiros. O LLM limita-se a pedir o que quer investigar, e o PersonalSOC executa as ferramentas só de leitura que permite e devolve os resultados. Há no máximo 6 rondas de investigação.
• A saída do LLM não é considerada fiável e no relatório é tratada como uma citação. Um LLM pode ler uma deteção como mais grave do que é, por isso confirme sempre a conclusão nas «Constatações».

Sobre a restrição de ferramentas

• Na coluna «Estado» da tabela nas Definições, opencode e claude mostram «Ferramentas bloqueadas». O claude é iniciado com as ferramentas integradas, os servidores MCP e as skills desativados e sem carregar as suas próprias definições. O opencode é iniciado com todas as permissões negadas.
• codex e agy não se conseguem desativar deste modo, por isso mostram «Ferramentas não bloqueáveis».

7. Usar a linha de comandos

O comando é personalsoc. No Linux fica em /usr/bin/personalsoc e no Mac dentro de PersonalSOC.app/Contents/MacOS/.

8. Onde ficam os dados e atualizações

O que é guardado

O PersonalSOC não guarda em ficheiros os relatórios nem os registos recolhidos. Para os conservar, use «Copiar Markdown» no ecrã ou a saída da linha de comandos. Para acrescentar um LLM, edite à mão profiles no ficheiro de definições; não se pode alterar a partir do ecrã.

Atualizações

No Mac, atualiza-se a partir de «Atualizações» nas Definições. A aplicação só se liga a lafine.net quando prime «Procurar atualizações» e recebe a informação da versão mais recente (um JSON público). Não é enviado nada sobre este dispositivo nem sobre os seus registos. Se existir uma versão mais recente, prima «Transferir e instalar». A assinatura do ficheiro transferido é verificada com a chave pública incorporada na aplicação e, se falhar, não é instalado nada. No fim, a aplicação reinicia.

No Mac, atualizar o próprio RoamSwitch não atualiza o PersonalSOC. No Linux não há função de atualização e o PersonalSOC está incluído nas atualizações dos pacotes do RoamSwitch.

9. Quando algo corre mal