Referencia: Configuración

Documento de claves runtime y persistencia de configuración.

Fuente de Configuración

Módulo principal: src/url_monitor/config.py

Singleton runtime: config = Config()

Archivo persistido: data/settings.json

Contrato de Persistencia

• get_user_settings() exporta claves mutables.
• save_user_settings(settings) valida + aplica + persiste.
• load_user_settings() carga valores al inicio.

Claves Principales

Clave	Tipo	Default	Nota
PROXY_HOST	string	127.0.0.1	Host de escucha y proxy de sistema.
PROXY_PORT	int	8080	Rango válido 1..65535.
PROXY_AUTO_START	bool	false	Puede disparar flujo de auto-start.
MONITOR_AUTO_START	bool	false	Arranque automático de monitoreo.
UBLOCK_ENABLED	bool	true	Toggle maestro uBlock.
PHISHTANK_ENABLED	bool	true	Toggle maestro anti phishing.
PHISHTANK_DOMAIN_MATCH_ENABLED	bool	false	Por defecto URL-only para reducir FPs.
SUSPICIOUS_JS_LEVEL	string	balanced	monitor, balanced, strict.
UI_UPDATE_INTERVAL_MS	int	1000	Validado y clamped en runtime UI.
MAX_HISTORY_RECORDS	int	1000	Límite de historial.
DEFAULT_LANGUAGE	string	en	Normalizado por helpers i18n.
UI_THEME	string	light	light, soft, contrast.
LOG_LEVEL	string	WARNING	DEBUG/INFO/WARNING/ERROR.
LOG_TO_FILE	bool	true	Logging a archivo.

Notificaciones

Clave	Tipo	Default	Nota
desktop_notifications_enabled	bool	true	Gate global.
NOTIFICATION_BACKEND	string	tray	tray o native.
NOTIFICATION_COOLDOWN_SECONDS	int	20	Deduplicación temporal.
phishing_alerts_enabled	bool	true	Toggle por tipo.
secret_alerts_enabled	bool	true	Toggle por tipo.
malware_alerts_enabled	bool	true	Toggle por tipo.
AD_ALERTS_ENABLED	bool	false	Ads opcionales.
TRACKER_ALERTS_ENABLED	bool	false	Trackers opcionales.
NOTIF_DURATION	string	5 seconds	Mapeo a timeout ms.
NOTIF_SOUND_ENABLED	bool	true	Beep local.

Filtros y Feeds

Clave	Nota
UBLOCK_FILTER_URLS	Lista de fuentes uBlock.
PHISHTANK_URL	Fuente JSON PhishTank.
PHISHINGDATABASE_URL	Fuente texto Phishing.Database.
UBLOCK_AUTO_UPDATE	Auto-update uBlock.
UBLOCK_UPDATE_FREQUENCY	Daily/Weekly/Monthly/Manual.
PHISHTANK_AUTO_UPDATE	Auto-update phishing feeds.

Controles de Estabilidad

Clave	Propósito
DEFAULT_WHITELIST	Bypass para dominios confiables/ruidosos.
PHISHTANK_FALSE_POSITIVE_DOMAINS	Evita etiqueta phishing en infraestructura ruidosa.
SILENT_DOMAINS	Permite bloquear sin ruido de alertas UI.
SECRET_DETECTION_WHITELIST	Omite escaneo secretos en dominios seleccionados.
SKIP_JS_ANALYSIS_DOMAINS	Omite análisis JS profundo para estabilidad/performance.

Detección de Seguridad

Clave	Propósito
TLSH_MIN_SIZE	Tamaño mínimo para hash TLSH.
SECRET_PATTERNS	Regex de detección de secretos.
CRITICAL_SECRET_TYPES	Tipos considerados críticos.
CRITICAL_SECRETS_ONLY_ALERTS	Prioriza alertas críticas.