Files

107 lines
4.5 KiB
Python
Raw Permalink Normal View History

"""Configuración central: todo lo que cambia entre entornos sale del archivo .env."""
from functools import lru_cache
from pydantic import SecretStr, field_validator, model_validator
from pydantic_settings import BaseSettings, SettingsConfigDict
class Settings(BaseSettings):
model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8", extra="ignore")
# Almacenamiento
# local = carpeta del servidor (disco propio o unidad montada)
# smb = la API se conecta a un recurso compartido SMB (Samba/NAS) con usuario y clave
storage_type: str = "local"
storage_root: str = "./almacenamiento" # solo para storage_type=local
# Conexión SMB (solo para storage_type=smb)
smb_server: str = "" # IP o nombre del servidor SMB / NAS
smb_share: str = "" # nombre del recurso compartido
smb_base_path: str = "" # subcarpeta dentro del recurso (opcional)
smb_username: str = ""
smb_password: SecretStr = SecretStr("") # SecretStr: nunca se imprime en logs ni errores
smb_domain: str = "" # dominio o nombre del equipo si la cuenta es local
smb_port: int = 445
smb_encrypt: bool = True # cifra el tráfico (SMB 3)
smb_timeout: int = 15
# Carpetas que la API NUNCA devuelve, aunque FSCrawler las haya indexado
# (rutas relativas a la raíz, separadas por coma). Lo ideal es excluirlas también
# en FSCrawler (fs.excludes); esto es una segunda barrera.
exclude_folders: str = ""
# Elasticsearch (lo alimenta FSCrawler)
es_url: str = "https://localhost:9200"
es_index: str = "archivos" # el "name" del job de FSCrawler
es_username: str = ""
es_password: SecretStr = SecretStr("")
es_api_key: SecretStr = SecretStr("") # alternativa a usuario/clave
es_ca_cert: str = "" # ruta al http_ca.crt de Elasticsearch 8 (recomendado)
es_verify_tls: bool = True # False solo para pruebas: no verifica el certificado
es_timeout: int = 10
# Base de datos (solo para los logs de búsquedas y descargas)
database_url: str = "sqlite:///./api_archivos.db"
# Seguridad
jwt_secret: str = "cambiar-este-secreto"
jwt_algorithm: str = "HS256"
download_secret: str = "cambiar-este-otro-secreto"
download_link_ttl_minutes: int = 30
allowed_roles: str = "admin,rrhh"
# URLs / descargas
public_base_url: str = "http://localhost:8000"
download_mode: str = "direct" # direct | nginx
nginx_internal_prefix: str = "/protegido/"
cors_origins: str = "http://localhost"
log_file: str = "logs/api_archivos.log"
@field_validator("download_mode")
@classmethod
def _modo_valido(cls, v: str) -> str:
v = v.lower().strip()
if v not in {"direct", "nginx"}:
raise ValueError("DOWNLOAD_MODE debe ser 'direct' o 'nginx'")
return v
@field_validator("storage_type")
@classmethod
def _tipo_valido(cls, v: str) -> str:
v = v.lower().strip()
if v not in {"local", "smb"}:
raise ValueError("STORAGE_TYPE debe ser 'local' o 'smb'")
return v
@model_validator(mode="after")
def _coherencia(self) -> "Settings":
if self.storage_type == "smb":
faltan = [n for n in ("smb_server", "smb_share", "smb_username") if not getattr(self, n)]
if not self.smb_password.get_secret_value():
faltan.append("smb_password")
if faltan:
raise ValueError(f"Con STORAGE_TYPE=smb faltan: {', '.join(f.upper() for f in faltan)}")
if self.download_mode == "nginx":
# Nginx no puede leer una carpeta SMB que no está montada
raise ValueError("DOWNLOAD_MODE=nginx no es compatible con STORAGE_TYPE=smb; usá direct")
return self
# Helpers para convertir las listas separadas por coma
@property
def carpetas_excluidas(self) -> list[str]:
"""'DATOS POLICIA, INFORMATICA/claves' -> ['DATOS POLICIA', 'INFORMATICA/claves']
(se respeta mayúsculas/minúsculas: en Linux las rutas las distinguen)."""
return [c.strip().strip("/") for c in self.exclude_folders.split(",") if c.strip()]
@property
def roles_permitidos(self) -> set[str]:
return {r.strip().lower() for r in self.allowed_roles.split(",") if r.strip()}
@property
def origenes_cors(self) -> list[str]:
return [o.strip() for o in self.cors_origins.split(",") if o.strip()]
@lru_cache
def get_settings() -> Settings:
return Settings()