PERSONALSOC · Última actualización: 2026-10-28

Manual de uso de PersonalSOC

Aquí se explica cómo usar la aplicación que reúne, de solo lectura y con un botón, los registros y el estado de las defensas de este equipo en un informe que se entiende de un vistazo. Primero se explican las operaciones en pantalla, y la línea de comandos se reúne en un capítulo posterior.

1. Qué es PersonalSOC

PersonalSOC es una aplicación que reúne los registros y el estado de las defensas de este equipo y los resume en hallazgos e informe. Está pensada para que una persona sin personal de seguridad dedicado vea, con pruebas, qué ocurre en su equipo y decida qué hacer a continuación.

Es de solo lectura, así que no cambia ajustes, no borra archivos ni bloquea comunicaciones. El análisis de los registros lo hacen analizadores de procedimiento fijo que no usan ni un LLM ni la red. La integración con LLM es opcional y está desactivada al principio.

Lo que no hace

2. Instalación e inicio

PersonalSOC es una app independiente de RoamSwitch, incluida en la distribución de RoamSwitch. Tiene su propio icono, no hay acceso desde el menú de RoamSwitch y se abre por sí sola como una app.

EntornoInstalación y apertura
MacEl DMG de RoamSwitch incluye PersonalSOC.app. Muévala a la carpeta «Aplicaciones» y abra «PersonalSOC». Se admite macOS 12 o posterior.
Linux (edición cliente)Se incluye en los paquetes deb, rpm, tarball y Arch de RoamSwitch. Abra «PersonalSOC» desde la lista de aplicaciones, o ejecute personalsoc-app en un terminal. La ventana necesita WebKitGTK 4.1, que deb y rpm instalan automáticamente. En Arch (Arch), instale webkit2gtk-4.1 como dependencia opcional.
Linux Server EditionSolo se incluye el comando. Ejecute personalsoc en un terminal (la app con ventana personalsoc-app no se incluye). Para la operación de la edición de servidor, consulte el Manual de operaciones (Linux Server).
También funciona sin RoamSwitch
PersonalSOC también se puede usar por sí solo. En un equipo con RoamSwitch instalado, además recoge del MCP de RoamSwitch (solo se usan herramientas de solo lectura) las detecciones sin resolver y los resultados del diagnóstico de configuración, y los reúne con los hallazgos de los registros en un único informe. Si RoamSwitch no está instalado, esa fuente de recopilación no se usa.

3. Primera comprobación del estado

Solo lee las fuentes fijas cuando pulsa «Comprobar estado». Las fuentes que no quiera que lea se pueden desactivar en los ajustes.

Pasos

  1. Abra la aplicación y pulse «Ajustes» en la esquina superior derecha.
  2. Debajo aparecen las fuentes que se leen en este sistema operativo. Desmarque las que no quiera que se lean.
  3. Pulse «Guardar» y luego «← Volver» para regresar a la pantalla de inicio.
  4. Pulse «Comprobar estado». Aparece una barra de progreso y, al terminar, las pestañas de resultados.

Al terminar aparecen los recuentos, por ejemplo «Comprobación completada. 3 detección(es) / 2 IOC». El capítulo siguiente explica las pestañas.

EntornoQué se lee
MacEl registro unificado de macOS (sudo y sshd de las últimas 24 horas) y los ajustes de MCP (Claude Code, Claude Desktop, opencode, Cursor, Windsurf, Gemini CLI, VS Code, Cline, Roo Code), así como los ajustes de Claude Code (~/.claude/settings.json y otros). También lee los registros de acceso de servidores web (el Apache incluido en macOS y nginx y httpd de Homebrew). Leer el registro de lo que Gatekeeper rechazó tarda unos 10 segundos, por lo que está desactivado al principio.
LinuxEl registro de autenticación (sshd), auditd, los registros de acceso web (nginx / apache, incluidos los registros separados por host virtual), los registros de consultas DNS (dnsmasq / named), los ajustes de MCP (Claude Code, Claude Desktop, opencode, Cursor, Windsurf, Gemini CLI, VS Code, Cline, Roo Code) y los ajustes de Claude Code (~/.claude/settings.json y otros).
AmbosSi RoamSwitch está instalado, también su MCP (solo con herramientas que únicamente leen). Puede desactivarse con la casilla «Obtener el historial de detecciones y el diagnóstico de configuración del MCP de RoamSwitch (solo lectura)».
Herramientas incluidasEl resumen de los diagnósticos de AccessScope y PathScope (si están instalados) y las amenazas de la capa LAN que RoamSwitch Sensor, que se ejecuta en este equipo, ha encontrado. PersonalSOC ejecuta comandos fijos con argumentos fijos y lee solo el resumen. Los argumentos no se pueden cambiar. Cada una de estas fuentes se puede desactivar en la lista de fuentes de arriba. Si falta alguna, la nota de esa fuente lo indica.

4. Cómo leer los resultados

PestañaQué se ve
PanelGráficos muestran el indicador del riesgo global (estimación), los recuentos por gravedad, las apariciones por categoría, la evolución en el tiempo y los recuentos de MITRE ATT&CK. Cuando hay material para ello, los recuadros de resumen muestran también la cobertura de las defensas de RoamSwitch (la parte que funciona ahora y los puntos ciegos), los resúmenes de los diagnósticos de las herramientas incluidas y los cambios desde la última comprobación.
InformeUn informe en Markdown que reúne las fuentes de recopilación, los hallazgos por categoría y los IOC. «Copiar Markdown» lo copia completo y «Mostrar el origen de Markdown» cambia al texto original.
HallazgosPuede recorrer las detecciones una a una, cada una con su gravedad, confianza, número ATT&CK, recuento y los números de línea del registro que la respaldan.
FuentesLa lista de lo que se comprobó. El estado es «Leído», «No presente», «No legible (permiso)», «Error» o «Desactivado», y las fuentes no legibles o con error no se han comprobado.
IOCLa lista de las IP, dominios, URL y hashes encontrados en los registros. Se muestran en forma neutralizada, como 198[.]51[.]100[.]7, para que nada se abra por error.
Resumen de entrada para un LLMEsta pestaña solo aparece cuando la integración con LLM está desactivada. Es un resumen para entregar a un LLM a mano y no contiene líneas de registro sin procesar. Use «Copiar».
Sobre la cifra del riesgo global
El riesgo global es una estimación de 0 a 100 que suma cada tipo de detección ponderado por gravedad y confianza. No es una probabilidad y no aumenta por mucho que se repita la misma detección. La confianza tiene tres niveles: «Confirmado», «Probable» e «Hipótesis».

5. Ajustes y ejecución periódica

«Ajustes», arriba a la derecha de la pantalla de inicio, se divide en pestañas por función. Después de cambiar algo, pulse «Guardar» y luego «← Volver» para regresar al inicio.

Idioma de visualización Además de «Automático (según el sistema)», puede elegir japonés, inglés, alemán, español, francés, italiano, coreano, portugués (Portugal), chino simplificado o chino tradicional, cada uno mostrado con su propio nombre.

Ejecución periódica (opcional)

Marque «Comprobar automáticamente a intervalos regulares» y guarde: en Mac se registra como agente de usuario de launchd y en Linux como temporizador de usuario de systemd. El intervalo se elige entre 7 niveles de 15 minutos a 24 horas y al principio es de 1 hora.

Solo se ejecuta personalsoc scan --notify, sin usar root. Solo se notifica cuando hay una detección que no estaba la última vez, y el mensaje contiene solo recuentos (en Linux hace falta notify-send). También puede desactivar la notificación con «Notificar solo si hay una detección que no estaba la última vez».

La ejecución periódica funciona con permisos de usuario normal, por lo que no puede leer los registros que solo root puede leer (autenticación, servidor web, auditd). Si hay registros que no se pudieron leer, la primera vez y cuando cambia la combinación de registros ilegibles, notifica «No se pudieron leer N registros: nombre». Si se leyeron todos, no notifica nada. Para revisar esos registros, ejecute sudo personalsoc scan.

Con personalsoc schedule status puede comprobar si la ejecución periódica está registrada, la hora de la última ejecución y los registros que no se pudieron leer. La pantalla de ajustes muestra lo mismo.

En Linux, si no hay notify-send (en Debian y Ubuntu, el paquete libnotify-bin), no se muestra ninguna notificación.

Los temporizadores de usuario de systemd no funcionan mientras la sesión está cerrada. En un servidor, ejecute una vez loginctl enable-linger.

Desmarque la casilla y guarde, y se elimina el registro.

6. Integración con LLM (opcional)

La integración con LLM es opcional y está desactivada al principio. Una vez activada, tras la comprobación del estado, el comando del LLM elegido hace una investigación adicional y redacta un informe como auditor. Los comandos que se pueden usar son opencode, claude, codex y agy.

Pasos

  1. Marque «Activar la integración con LLM».
  2. Elija el «LLM que se usará». Uno que aparezca como «(no instalado)» no tiene comando en este equipo.
  3. Si hace falta, cambie el modelo y el tiempo límite (segundos). Si deja el modelo vacío, se usa el predeterminado de ese LLM.
  4. Pulse «Guardar», vuelva al inicio y pulse «Comprobar estado». Tras la comprobación, la investigación del LLM se ejecuta a continuación.

Lo que llega al LLM

Sobre la restricción de herramientas

Cuando use un LLM cuyas herramientas no se pueden bloquear
Durante la investigación el LLM puede leer archivos por su cuenta, y lo que lee se envía al servicio de ese LLM. Para usarlo, marque la confirmación bajo «LLM que se usará». La confirmación es por LLM, y sin marcarla no se puede guardar ni investigar.
Relación con Zero Telemetry
El «Zero Telemetry» de RoamSwitch (no se envía al exterior el contenido de las comunicaciones ni los registros) describe a RoamSwitch en sí. Las comunicaciones que se producen al activar la integración con LLM de PersonalSOC no están incluidas. El destino y el tratamiento se rigen por las condiciones del LLM elegido y de su proveedor. Mientras la integración con LLM siga desactivada, PersonalSOC no envía el contenido de los registros fuera del equipo.

7. Usar la línea de comandos

El comando es personalsoc. En Linux está en /usr/bin/personalsoc y en Mac dentro de PersonalSOC.app/Contents/MacOS/.

En Mac, si la app está en la carpeta Aplicaciones, el comando está en /Applications/PersonalSOC.app/Contents/MacOS/personalsoc. Para llamarlo por su nombre corto, ejecute lo siguiente en el Terminal. Después basta con personalsoc.

sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/PersonalSOC.app/Contents/MacOS/personalsoc /usr/local/bin/personalsoc
ComandoQué hace
personalsoc scanComprueba automáticamente los registros de este equipo y RoamSwitch (MCP) y muestra las detecciones en una lista. Para los registros que solo root puede leer (autenticación, servidor web, auditd), ejecútelo con sudo.
personalsoc scan --reportMuestra el informe en Markdown (sin LLM).
personalsoc scan --llm <name>Muestra el informe que el LLM redactó como auditor tras investigar con herramientas de solo lectura. name es opencode, claude, codex, agy, etc.
personalsoc scan --notifyNotifica solo si hay una detección que no estaba la última vez. Es la forma que llama la ejecución periódica.
personalsoc scan --format <text|markdown|json|sarif>Muestra el resultado en forma legible por máquina. json y sarif (SARIF 2.1.0) escriben solo el resultado en la salida estándar. markdown muestra un informe en Markdown. json y sarif no se pueden combinar con --report ni con --llm.
personalsoc scan --fail-on <high|medium|low>Termina con el código 3 si hay una detección de esa gravedad o superior. Con --fail-on-partial, termina con el código 4 cuando alguna fuente no se pudo leer (que no haya detecciones no es prueba de seguridad).
personalsoc scan --since-lastMuestra la diferencia con la comprobación anterior y guarda esta en el historial. El historial se escribe solo en la ubicación propia de PersonalSOC (capítulo 8).
personalsoc scan --diff <file>
personalsoc scan --save-snapshot <file>
--diff compara con la salida de --format json o con un archivo escrito por --save-snapshot (no escribe nada y no se puede combinar con --since-last). --save-snapshot escribe este resultado en un archivo JSON (que solo usted puede leer y escribir).
personalsoc <type> <file>Analiza un archivo indicado. type es sshd, auditd, web, dns, unified, mcp, agent, inject o ioc. Si indica - como file, lee la entrada estándar, y también se pueden añadir --report, --brief y --llm.
--lang <lang>Se puede añadir a cualquier comando y fija el idioma de visualización, con prioridad sobre el ajuste. Los códigos son ja, en, de, es, fr, it, ko, pt-PT, zh-Hans y zh-Hant.
Los LLM en la línea de comandos
En la línea de comandos, ejecutar con --llm es la operación explícita que entrega datos al LLM, por lo que funciona aunque «Activar la integración con LLM» esté desactivado en los ajustes. Tampoco se pide confirmación para un LLM cuyas herramientas no se pueden restringir, así que al usar codex o agy hágalo solo tras entender que durante la investigación se pueden leer y enviar archivos.

8. Dónde se guardan los datos y actualizaciones

Qué se guarda

ElementoUbicación
Ajustes~/.config/personalsoc/settings.json (se guarda con permisos que solo usted puede leer y escribir)
Registro de las detecciones anteriores (para decidir las notificaciones)~/.local/state/personalsoc/last.json (solo hashes que hacen de huella de las detecciones; no se conserva texto de los registros)
Registro de la ejecución periódicaEn Mac, ~/Library/LaunchAgents/dev.personalsoc.scan.plist (la salida va a ~/Library/Logs/personalsoc-scan.log). En Linux, personalsoc-scan.timer y personalsoc-scan.service en ~/.config/systemd/user/.
Instantáneas de comprobaciones anteriores (historial)~/.local/state/personalsoc/history/snapshots.json (solo usted puede leerlo y escribirlo. Contiene solo el tipo, el título, el objetivo, la gravedad y el número de cada detección, si cada guardián está activado o no, los nombres de los servidores MCP, el estado de las fuentes y el riesgo global. Ni líneas de registro, ni pruebas, ni contenido de los ajustes, ni secretos. Hasta 60 comprobaciones y 400 detecciones por comprobación, 2 MiB; las más antiguas se eliminan primero, y si borra la carpeta, el historial desaparece. No se envía al exterior)

PersonalSOC no guarda en archivos los informes ni los registros recopilados. Si quiere conservarlos, use «Copiar Markdown» en pantalla o la salida de la línea de comandos. Para añadir más LLM, edite a mano profiles en el archivo de configuración; no se puede cambiar desde la pantalla. Solo se conservan los registros de comprobación (historial) que se usan para comparar con la ejecución anterior, como se indica en la tabla siguiente.

Actualizaciones

En Mac se actualiza desde «Actualizaciones» en Ajustes. Solo se conecta a lafine.net cuando pulsa «Buscar actualizaciones» y recibe la información de la última versión (un JSON público). No se envía nada sobre este equipo ni sus registros. Si hay una versión más reciente, pulse «Descargar e instalar». La firma del archivo descargado se verifica con la clave pública incrustada en la aplicación, y si falla no se instala nada. Al terminar, la aplicación se reinicia.

En Mac, actualizar RoamSwitch en sí no actualiza PersonalSOC. En Linux no hay función de actualización y PersonalSOC se incluye en las actualizaciones de los paquetes de RoamSwitch.

9. Si algo no funciona

SíntomaCausa y solución
Una fuente muestra «No legible (permiso)»Los registros de autenticación, del servidor web y de auditd no se pueden leer sin derechos de administrador. PersonalSOC no eleva sus privilegios; ejecútelo con sudo. Es distinto de «sin detecciones»: ese registro no se ha comprobado.
No se puede guardar la ejecución periódicaSi el Mac indica que la aplicación se ejecuta desde una ubicación temporal en cuarentena, mueva PersonalSOC.app a la carpeta Aplicaciones, ábrala de nuevo y guarde otra vez. Si indica que no se encontró el comando personalsoc, personalsoc debe estar en el mismo lugar que la propia aplicación.
La investigación con claude falla con «Not logged in»PersonalSOC inicia claude sin cargar sus propios ajustes (como env y apiKeyHelper en ~/.claude/settings.json). Las configuraciones que se autentican mediante esos ajustes, como un proxy, Bedrock o Vertex, fallan. Si añade a mano "llm_user_settings": ["claude"] al archivo de ajustes, claude se inicia con sus ajustes cargados. Las herramientas y MCP siguen desactivados.
← Página del producto PersonalSOC Al manual para Mac →