Theft Deterrent Fix & Installer

Solución definitiva y script de autoconfiguración para Theft Deterrent en distribuciones Linux modernas y Windows.

Note

Basado en el trabajo de Jotalea/TheftDeterrent.
Todos los créditos del repositorio original, la paquetización base y la documentación primaria corresponden a Jotalea.

Tabla de Contenidos

• Compatibilidad
• El Problema
• La Solución
• Instalación rápida
• Instalación detallada
  • Linux (Debian / Ubuntu / derivadas)
  • Huayra 5 / 6
  • Windows 10 / 11
• Post-Instalación
• Referencias
• Licencia

Compatibilidad

Sistema operativo	Versión	Estado	Notas
Linux Mint	22.3	✓	Probado. Requiere install.sh
Windows	10 / 11	✓	Instaladores en windows/

El Problema

En distribuciones modernas (como Linux Mint 21+, Ubuntu 22.04+ o Huayra 6.5+), la instalación de los paquetes .deb originales presenta fallos críticos que impiden su funcionamiento:

1. Dependencias irresolubles: El paquete theftdeterrentclient exige dependencias deprecadas, lo cual rompe la base de datos de apt.
2. Crash silencioso del cliente: Los binarios están enlazados estáticamente contra libpython2.7, una librería que ya ha sido eliminada de los repositorios actuales.

Warning

Nota sobre parches previos:
El parche comunitario provisto por Maxelslasarte corrige los metadatos (cambiando la dependencia a Python 3), pero no soluciona el crash de los binarios, ya que estos siguen requiriendo la librería original (libpython2.7) en tiempo de ejecución.

La Solución

Esta solución introduce mejoras críticas al instalador automatizado (install.sh) original para resolver todos los conflictos de dependencias de forma dinámica y transparente para el usuario:

• Instalación de dependencias legacy: Obtiene libpython2.7 directamente del repositorio universe o mediante un fallback temporal al archivo de Ubuntu Jammy.
• Aplicación inteligente de parches: Despliega los metadatos parcheados de Guardian únicamente si el sistema carece de un entorno Python 2 nativo.
• Corrección de rutas: Soluciona un error tipográfico en la ruta del binario (TheftDeterrentclient vs TheftDeterrentClient) que impedía la ejecución en versiones anteriores.
• Soporte offline/local: Prioriza el uso de los paquetes .deb locales incluidos en el repositorio, permitiendo una instalación más rápida y sin requerir descargar los binarios nuevamente.
• Integración del sistema: Crea los enlaces simbólicos correctos para disponer del comando theftdeterrentclient de forma global.

Instalación (Linux)

Para distribuciones basadas en Debian (Ubuntu, Linux Mint, Kali, Huayra 6.5+), podés instalar el parche de dos maneras:

Opción A: Rápida (Recomendada)

wget -qO- https://raw.githubusercontent.com/lfmen/TheftDeterrent/main/install.sh | sudo bash

Opción B: Clonando el repositorio

git clone https://github.com/lfmen/TheftDeterrent.git
cd TheftDeterrent
sudo bash install.sh

Tip

Para instalaciones manuales o auditorías de seguridad, los paquetes .deb originales se encuentran aislados en el directorio deb/.

Huayra 5 / 6

Procede con la instalación convencional a través del gestor de paquetes (Synaptic o apt instalando el meta-paquete theft). Si ocurren conflictos de dependencias, recurre al método de instalación de Debian descrito en la sección anterior.

Windows 10 / 11

1. Ejecuta el instalador ubicado en windows/Theft Derrent Guardian.exe (asegúrate de habilitar la opción de desinstalación sin contraseña).
2. Ejecuta el instalador windows/Theft Derrent Agent.exe.
3. Reinicia el sistema operativo.

Post-Instalación

Una vez instalado, sigue estos pasos para vincular tu equipo:

1. Inicia el demonio o cliente ejecutando el comando theftdeterrentclient en la terminal, o búscalo en tu menú de aplicaciones.
2. Navega al panel de Configuración.
3. Configura el servidor correspondiente a tu red:
   • Red Juana Manso: citd.dgp.educ.ar
   • Otros equipos: tds.educacion.gob.ar

📦 Descargas Formales (Releases)

Las versiones estables y empaquetadas del instalador, junto con los ejecutables .deb y .exe aislados, se encuentran formalmente distribuidas en la pestaña Releases de este repositorio. Se recomienda descargar desde allí para entornos de producción.

Referencias y repositorios

• Jotalea/TheftDeterrent - Repositorio y documentación original.
• Parche de Maxelslasarte - Adaptación de metadatos de Guardian.
• HuayraLinux/theftdeterrent6 - Paquetización oficial para entornos Huayra 6.

Licencia

El cliente de Theft Deterrent es propiedad del Ministerio de Educación de la República Argentina.

El instalador, scripts y herramientas de despliegue de este repositorio se distribuyen bajo la Licencia MIT.

Desarrollado para mantener la compatibilidad en entornos educativos