← MAPerit Manual de usuario · Versión 1.1.2

MaPeriT.TN

Navegacion y analisis visual de evidencias recopiladas por MaPeriT.SW o MaPeriT.OF — CSV · EVTX · MFT · JSON · Hex · IOC · Timeline

1. Introduccion

MaPeriT.TN es el visor forense interactivo del ecosistema MaPeriT. Proporciona una interfaz grafica de escritorio para navegar, visualizar y analizar las evidencias recopiladas por MaPeriT.SW y analizadas por MaPeriT.AN, sin necesidad de herramientas externas ni acceso a internet.

La aplicacion esta construida en PowerShell 5.1 sobre Windows Presentation Foundation (WPF) y no requiere instalacion: es un script portable. Se abre directamente sobre el directorio de un proyecto MaPeriT y presenta todos sus artefactos organizados por fase de adquisicion, con visores especializados para cada tipo de fichero.

Operacion completamente offline y no destructiva: MaPeriT.TN solo lee el directorio de evidencias. La unica escritura que realiza es el fichero TN_Bookmarks.json cuando el perito crea marcadores, y los informes exportados manualmente.

1.1 Caracteristicas Principales

📁
Navegacion de proyectosCarga proyectos MaPeriT.SW completos con las 10 fases organizadas en un arbol. Detecta y muestra tambien el modulo ANALISIS_AN si esta presente.
📄
Visores especializadosVisores dedicados para CSV, EVTX, MFT, JSON, texto/log, HTML y binario (Hex). Cada uno con filtrado, ordenacion y exportacion.
🚫
Deteccion IOC automaticaTodas las filas CSV y EVTX se analizan automaticamente al cargar. IPs externas, hashes SHA256, ejecutables sospechosos y rutas anomalas se resaltan con color por severidad.
🔍
Escaner IOC de proyectoEscanea todos los ficheros del proyecto (CSV, JSON, TXT, LOG) en segundo plano y muestra una vista consolidada de todos los indicadores detectados, exportable a HTML o CSV.
⏱
Timeline consolidadaCruza eventos EVTX, timestamps MFT y columnas de fecha de artefactos CSV en una sola vista cronologica ordenada, con hasta 50.000 eventos. Exportable a CSV.
📌
Sistema de marcadoresMarca ficheros o artefactos como relevantes con severidad, etiqueta y nota libre. Los marcadores se persisten en el proyecto y se pueden exportar como informe HTML o CSV.
🔎
Busqueda global multi-formatoBusca texto en todos los ficheros del proyecto (CSV, JSON, TXT, LOG, XML, INF) en segundo plano. Resultados con doble clic para abrir el fichero directamente.
📊
Dashboard de proyectoVista inicial con estadisticas del proyecto: fases presentes, total de artefactos, anomalias detectadas por SW, tamano total y estado de cada fase de adquisicion.
☰
Menus contextuales en filas y pestanasClic derecho en cualquier fila de un DataGrid: copiar fila, crear marcador a nivel de linea o lanzar un escaneo IOC. Clic derecho en una pestana: cerrar, cerrar las demas, cerrar todas o copiar su ruta.
📌
Marcadores a nivel de lineaLos marcadores ya no son solo de fichero: pueden referenciar una linea concreta, columna y valor de celda de cualquier artefacto CSV, EVTX, MFT o timeline. El informe de exportacion incluye todos los campos de contexto.

1.2 El Ecosistema MaPeriT

Tres herramientas, un flujo de trabajo forense completo
ModuloFuncionCuando se usa
MaPeriT.SWAdquisicion forense en vivo en el equipo objetivoEn el equipo sospechoso, con admin local
MaPeriT.ANAnalisis profundo offline: MFT, EVTX, SQLite, USNEn el laboratorio del perito, sobre las evidencias
MaPeriT.TNVisor grafico interactivo para revision y analisis visualEn cualquier momento para revisar evidencias
MaPeriT.SWAdquisicion forense en equipo objetivo (10 fases)
MaPeriT.ANAnalisis offline profundo (MFT, EVTX, SQLite, correlacion)
MaPeriT.TNRevision visual, IOC scan, timeline, marcadores
InformeExportacion de hallazgos como HTML/CSV para el expediente

2. Requisitos del Sistema

Requisitos
PowerShell5.1 (incluido en Windows 10/11). No requiere PowerShell 7.
Sistema operativoWindows 10 / Windows 11 / Windows Server 2016+ (64 bits)
PermisosUsuario normal. No requiere Administrador para el visor. Si requiere admin si se quiere leer ficheros EVTX protegidos.
RAMMinimo 2 GB. Recomendado 4 GB+ para proyectos grandes (MFT con 500K+ registros).
Dependencias externasNinguna. Solo .NET Framework 4.7+ incluido en Windows 10/11.
ResolucionMinimo 1280x720. Recomendado 1920x1080 o superior.
MaPeriT.TN no requiere instalacion de Python, pip, ni ninguna libreria externa. Funciona con lo que viene incluido en Windows 10/11.

3. Lanzar la Aplicacion

3.1 Desde PowerShell

Ejecucion directa
# Abrir la aplicacion sin argumentos (pantalla de inicio)
powershell.exe -ExecutionPolicy Bypass -File ".\MaPeriT.TN.ps1"

# Abrir directamente un proyecto MaPeriT.SW
powershell.exe -ExecutionPolicy Bypass -File ".\MaPeriT.TN.ps1" -ProjectPath "D:\Forense\MaPeriT_2026-001"

# Abrir directamente un fichero individual
powershell.exe -ExecutionPolicy Bypass -File ".\MaPeriT.TN.ps1" -OpenFile "D:\Evidencias\Security.evtx"

3.2 Parametros de Inicio

ParametroTipoReq.Descripcion
-ProjectPath String No Ruta al directorio de salida de MaPeriT.SW. TN verifica que sea un proyecto valido (contiene HashManifest.csv o carpetas de fase).
-OpenFile String No Ruta a un fichero individual (CSV, EVTX, JSON, etc.). TN lo abre directamente en el visor correspondiente.

3.3 Sistema de Compilacion

MaPeriT.TN sigue la misma arquitectura modular que SW y AN. El fichero MaPeriT.TN.ps1 es el resultado de compilar todos los modulos src\ con Build.ps1:

.\Build.ps1

El compilador concatena los 19 modulos fuente en orden, imprime la lista de ficheros incluidos y genera el SHA-256 del compilado. No edite el compilado directamente; modifique los ficheros en src\ y recompile.

4. Ventana Principal

Zonas de la interfaz
ZonaDescripcion
Barra de menuMenus Archivo, Vista, Analisis, Ayuda. Acceso a todas las funciones.
Barra de herramientasBotones Abrir Proyecto / Abrir Archivo, nombre del proyecto activo y caja de busqueda global.
Panel izquierdo (Explorador)Arbol de carpetas del proyecto organizado por fase. Filtro de arbol en la parte superior.
Separador redimensionableArrastrarlo para ajustar el ancho del explorador.
Area de pestanasVisores de ficheros, dashboard, resultados de busqueda, IOC scan, timeline y marcadores.
Barra de estadoInformacion contextual: fichero activo, numero de filas, estado de operaciones.

4.1 Panel Explorador

El explorador muestra el contenido del proyecto organizado segun la estructura de fases de MaPeriT.SW. Las fases se presentan en orden numerico; dentro de cada fase, los ficheros se ordenan alfabeticamente.

  • Clic en un fichero: lo abre en el visor correspondiente (nueva pestana)
  • Clic derecho en un fichero: muestra el menu contextual con opciones de analisis
  • Filtro de arbol: escribe para filtrar en tiempo real por nombre de fichero o carpeta
  • Tooltip: pasa el raton sobre un fichero para ver su tamano y ruta completa
Los iconos de color de los ficheros indican su tipo: ▮ CSV, ▮ JSON, ▮ EVTX, ▮ HTML, gris para el resto.

4.2 Sistema de Pestanas

Cada fichero que se abre genera una pestana independiente. Las pestanas se pueden cerrar individualmente con el boton × o con Ctrl+W. Si se abre un fichero ya abierto, la pestana existente toma el foco en lugar de duplicarse.

Menu contextual en la cabecera de pestana

Un clic derecho sobre la cabecera de cualquier pestana muestra un menu contextual con las siguientes opciones:

OpcionAccion
CerrarCierra esta pestana (equivalente al boton ×)
Cerrar las demasCierra todas las pestanas excepto la que se ha pulsado
Cerrar todasCierra todas las pestanas abiertas
Copiar rutaCopia al portapapeles la clave de la pestana (ruta del fichero en pestanas de fichero; identificador interno en pestanas especiales como Dashboard o Timeline)

4.3 Menu Analisis

El menu Analisis agrupa todas las funciones avanzadas:

OpcionAtajoDescripcion
Escanear IOCs en proyectoCtrl+IEscaneo asíncrono de todos los ficheros del proyecto en busca de IOCs
Timeline consolidadaCtrl+TConstruccion asíncrona de la timeline cruzando EVTX, MFT y CSVs con timestamps
Marcadores—Abre el panel de marcadores del proyecto actual
Busqueda globalCtrl+FBusqueda de texto en todos los formatos del proyecto

5. Abrir un Proyecto MaPeriT

Un proyecto MaPeriT es el directorio de salida generado por MaPeriT.SW. Contiene la estructura de fases de adquisicion y, opcionalmente, el subdirectorio ANALISIS_AN\ generado por MaPeriT.AN.

Para abrir un proyecto haga clic en Abrir Proyecto MaPeriT en la barra de herramientas o en el menu Archivo, y seleccione el directorio raiz del proyecto. TN verifica que sea un proyecto valido antes de cargarlo.

Estructura de proyecto que reconoce MaPeriT.TN
MaPeriT_NOMBRE_YYYYMMDD_HHMMSS\ (OF: MaPeriT_OF_NOMBRE_...) ├── 01_Volatile\ 1 · Datos volatiles (OF: solo una nota) ├── 02_SystemInfo\ OSInfo.json: nombre del equipo ├── 03_Filesystem\ $MFT raw, Amcache.hve, papelera ├── 04_Registry\ Hives de registro y valores extraidos ├── 05_EventLogs\ Ficheros .evtx ├── 06_Browsers\ SQLite de navegadores ├── 07_Communications\ ├── 08_CloudStorage\ ├── 09_USB\ ├── 10_Persistence\ ├── Analysis\ Anomalias y timeline de SW ├── Report\ InformePericial.html: nombre del perito ├── Logs\ │ └── HashManifest.csv ← SW; TN lo usa para detectar el proyecto ├── HashManifest.csv ← OF (en la raiz) ├── ANALISIS_AN\ Presente si se ejecuto MaPeriT.AN └── TN_Bookmarks.json ← creado por TN al guardar marcadores

5.1 Dashboard de Proyecto

Al abrir un proyecto, TN muestra automaticamente un Dashboard con las estadisticas generales:

  • Numero de caso (del nombre de la carpeta), equipo (de 02_SystemInfo\OSInfo.json) y perito (del informe pericial de SW u OF)
  • Fases capturadas: numero de fases de adquisicion presentes
  • Artefactos CSV/JSON: total de ficheros analizables en el proyecto
  • Anomalias SW: entradas en Analysis\Anomalies.csv (0 si SW no detecto ninguna o si el proyecto es de OF). Hasta v1.1.1, sin ese fichero se contaban por error los programas de inicio de AutorunsConsolidated.csv
  • Tamano total: espacio ocupado por los artefactos
  • Mapa de fases: indicador visual de que fases estan presentes (verde) o ausentes (gris)
  • Badge AN Disponible: si el directorio ANALISIS_AN\ existe

6. Abrir un Archivo Individual

MaPeriT.TN puede abrir cualquier fichero de forma independiente, sin necesidad de un proyecto. Haga clic en Abrir Archivo o use el menu Archivo. Los formatos soportados y sus visores son:

Extension(es)Visor asignadoNotas
.csvCSV ViewerCarga asincrona. Limite 50.000 filas por defecto.
.evtxEVTX ViewerLimite 10.000 eventos. Coloreado por EventID.
.jsonJSON ViewerPretty-print automatico.
MFT_*.csvMFT ViewerDetectado por nombre. Banner informativo y filtro de rutas de sistema.
$MFTMFT InfoFichero binario: muestra tamano y guia para usar AN.
.log .txt .inf .xmlText ViewerCon numeracion de lineas y busqueda.
.html .htmHTML ViewerBoton para abrir en el navegador del sistema.
.bin .raw .hve .dat .pfHex ViewerVisor hex completo con scroll, busqueda y navegacion por offset.
SAM, SYSTEM, SOFTWARE, SECURITYHex ViewerHives de registro en binario.
RestoText ViewerFallback generico.

7. Visor CSV

El visor CSV es el mas completo de MaPeriT.TN. Utiliza carga asincrona mediante un Runspace de PowerShell en segundo plano para no bloquear la interfaz con ficheros grandes.

Funciones del Visor CSV
FuncionComo usarla
Filtrar filasEscribir en la caja de filtro de la barra superior. Busca en todas las columnas simultaneamente.
Ordenar por columnaClic en la cabecera de cualquier columna.
Redimensionar columnasArrastrar los bordes de las cabeceras.
Seleccion multipleShift+clic o Ctrl+clic en filas.
Copiar seleccionBoton "Copiar sel." o Ctrl+C. Copia en formato TSV (pegable en Excel).
Exportar CSV filtradoBoton "Exportar CSV". Exporta solo las filas visibles tras el filtro.
Resaltado IOCAutomatico al cargar. Las filas con IOCs se colorean por severidad.
Limpiar filtroBoton "Limpiar" o borrar el texto del filtro.

7.1 Codigo de colores por severidad

ColorSeveridadDisparado por
CRITICACriticalComandos codificados en Base64, campos Severity=Critical, Event IDs criticos (1102, 4698, 7045...)
ALTAHighRutas anomalas (Temp, AppData\Local\Temp), ejecutables sospechosos (cmd, powershell, mshta, rundll32...), Event IDs altos
MEDIAMediumEvent IDs medios (6005, 6006, 4616...)
INFOInfoIPs externas (excluye RFC 1918), hashes SHA256
TIMESTOMPTimestompingSolo en Visor MFT: filas con Timestomping = True segun MaPeriT.AN (el motivo esta en RazonTimestomp)

8. Visor EVTX

El visor EVTX carga ficheros de eventos de Windows (.evtx) usando Get-WinEvent. Muestra hasta 10.000 eventos por fichero con columnas fijas: Fecha/Hora, EventID, Nivel, Proveedor, Mensaje, Usuario y Equipo.

Las filas se colorean automaticamente segun el EventID usando la clasificacion de severidad de MaPeriT (lista configurable en Config.ps1). El filtro de texto busca en EventID, Mensaje y Proveedor.

Limite de 10.000 eventos por fichero: Para el analisis profundo sin limite de EVTX utilice MaPeriT.AN, que procesa todos los eventos usando XPath binario.

9. Visor MFT

El visor MFT tiene dos modos segun el tipo de fichero:

MFT_*.csv (resultado de AN)

Visor completo con DataGrid, filtro de texto, filtro "Solo fuera de System32/WinSxS" y exportacion. Colorea en purpura los registros que AN marca con timestomping (columna Timestomping) y en azul los borrados (Estado = BORRADO). El filtro de sistema usa la columna RutaCompleta. Todas las fechas estan en UTC. Banner informativo segun el tipo: Completo, Timestomping o Borrados.

$MFT (fichero binario raw)

Muestra el tamano del fichero y una guia sobre como analizarlo con MaPeriT.AN para obtener los CSV parseados (MFT_Completo.csv, MFT_Timestomping.csv, MFT_Borrados.csv).

10. Visor JSON

Carga el JSON y aplica pretty-print con indentacion automatica antes de mostrarlo. Boton "Copiar" para copiar todo el contenido al portapapeles.

11. Visor Texto / Log

Muestra el fichero con numeracion de lineas en el panel izquierdo (fondo oscuro) y el contenido a la derecha, con fuente monoespaciada (Cascadia Code o Consolas). Funciones:

  • Busqueda: escribir en la caja de busqueda y pulsar Enter. Hace scroll hasta la primera ocurrencia. Siguiente ocurrencia: Enter de nuevo. El fondo de la caja se pone verde si encuentra, rojo si no.
  • Copiar todo: boton "Copiar todo" o clic derecho en el area de texto → Copiar todo.
  • Anadir marcador del archivo: clic derecho en el area de texto → Anadir marcador del archivo... abre el dialogo de marcadores para ese fichero.

12. Visor Hex

Visor hexadecimal real para ficheros binarios. Muestra hasta 64 KB con el formato clasico: offset | hex | ASCII. Funciones:

ControlFuncion
Caja "Ir a offset (hex)"Escribir un offset hexadecimal (ej: 1A00 o 0x1A00) y pulsar Enter. Hace scroll a esa posicion.
Caja "Buscar texto"Busca texto ASCII en el volcado hex. Enter va a la primera ocurrencia.
Boton "Copiar vista"Copia todo el volcado hex visible al portapapeles.
ScrollScroll vertical y horizontal completo. El visor muestra el fichero completo (hasta 64 KB).
Para ficheros mayores de 64 KB se muestran los primeros 64 KB con nota del tamano total. Para analisis forense de binarios completos (volcados de memoria, hives grandes) use herramientas especializadas como HxD o 010 Editor.

13. Escaner IOC de Proyecto

El Escaner IOC (Analisis → Escanear IOCs en proyecto o Ctrl+I) analiza todos los ficheros del proyecto de forma asincrona y presenta una vista consolidada de todos los indicadores detectados.

13.1 Patrones IOC implementados

TipoSeveridadQue detecta
Comando codificado CRITICA EncodedCommand, DownloadString, Invoke-Expression, IEX, FromBase64
Ruta anomala ALTA Actividad en \Temp\, \AppData\Local\Temp\, \Downloads\, \Public\, \ProgramData\ (excluye Microsoft)
Ejecutable sospechoso ALTA cmd, powershell, wscript, cscript, mshta, rundll32, regsvr32, schtasks, bitsadmin, certutil, msiexec, wmic, psexec
IP externa INFO IPs publicas (excluye RFC 1918: 10.x, 172.16-31.x, 192.168.x, 127.x, 0.0.0.0)
Hash SHA-256 INFO Secuencias hexadecimales de exactamente 64 caracteres

13.2 Uso del escaner

  • El escaneo se ejecuta en segundo plano (Runspace separado). La UI no se bloquea.
  • Ficheros analizados: .csv, .json, .txt, .log menores de 30 MB.
  • Los resultados se ordenan: Critical primero, High, Info al final.
  • El filtro de la toolbar filtra por tipo IOC, fichero o coincidencia.
  • Doble clic en un resultado abre el fichero origen en su visor.
  • Exportar a CSV o HTML con los botones de la toolbar.
  • Para escanear un fichero individual: clic derecho → "Escanear IOCs en fichero".

14. Timeline Consolidada

La Timeline (Analisis → Timeline consolidada o Ctrl+T) construye una cronologia unificada cruzando tres fuentes de datos del proyecto de forma asincrona.

Fuentes integradas en la Timeline
FuenteColor en TNQue aporta
EVTXRojo / Naranja (segun severidad)Todos los eventos de los .evtx del proyecto (hasta 10.000 por fichero)
MFT CSVPurpuraFecha SI_Modificado_UTC (o, si falta, SI_Creado_UTC / FN_Creado_UTC) de los primeros 3.000 registros por CSV, sin repetir registros; solo se colorean los que AN marca con timestomping
CSV con timestampsSin color especialColumnas con nombre que contenga Time, Date, Created, Modified, Timestamp... (500 filas por CSV)

La timeline muestra hasta 50.000 eventos ordenados del mas reciente al mas antiguo. El filtro de texto busca en Fuente, Tipo, Descripcion y Artefacto. Exportable a CSV con el boton de la toolbar.

La busqueda global (Ctrl+F enfoca la caja en la toolbar; pulsa Enter o el boton lupa para lanzarla) busca el texto introducido en todos los ficheros del proyecto de forma asincrona.

Formatos incluidos en la busqueda

La busqueda recorre todos los ficheros .csv, .json, .txt, .log, .xml e .inf del proyecto menores de 20 MB. La busqueda es insensible a mayusculas.

Los resultados aparecen en una nueva pestana con columnas Tipo, Fichero, Linea y Contenido. Doble clic en cualquier resultado abre el fichero directamente.

16. Sistema de Marcadores

Los marcadores permiten al perito anotar ficheros o artefactos relevantes durante la revision. Se accede mediante Analisis → Marcadores o mediante el menu contextual del explorador.

16.1 Tipos de marcador

MaPeriT.TN soporta dos niveles de granularidad para los marcadores:

Marcador de fichero

Referencia a un fichero completo. Se crea desde el menu contextual del explorador (arbol de proyecto) o desde el menu contextual del Visor de Texto. Campos: Fichero, Etiqueta, Severidad, Nota.

Marcador de linea

Referencia a una fila concreta de un artefacto. Se crea desde el menu contextual de cualquier DataGrid (CSV, EVTX, MFT, IOC Scan, Timeline, Busqueda). Incluye ademas: numero de linea, nombre de columna y valor de celda.

16.2 Crear un marcador

Desde el explorador (marcador de fichero):

  1. Clic derecho sobre cualquier fichero en el arbol del explorador → Anadir marcador...
  2. En el dialogo, rellenar: Etiqueta, Severidad y Nota.
  3. Clic en Guardar. El marcador se persiste en TN_Bookmarks.json.

Desde un DataGrid (marcador de linea):

  1. Clic derecho sobre cualquier fila en un visor CSV, EVTX, MFT, IOC Scan, Timeline o Busqueda Global → Anadir marcador en fila...
  2. El dialogo muestra el contexto de la fila: numero de linea, columna y valor de celda (solo lectura).
  3. La etiqueta se pre-rellena automaticamente con el nombre del fichero, la linea y la columna.
  4. Rellenar Severidad y Nota, y clic en Guardar.
Si un marcador identico (mismo fichero + linea + columna) ya existe, el dialogo abre con los valores actuales y los actualiza al guardar. Esto permite editar la nota o cambiar la severidad de un marcador existente.

16.3 Gestionar marcadores

La pestana de Marcadores (Analisis → Marcadores) muestra todos los marcadores del proyecto en una tabla con las columnas: Severidad, Etiqueta, Archivo, Linea, Columna, Valor, Nota y Fecha.

  • Doble clic en un marcador: abre el fichero asociado en su visor
  • Boton Eliminar sel.: elimina los marcadores seleccionados (seleccion multiple con Ctrl/Shift)
  • Boton Exportar HTML: abre el dialogo de guardado, donde se elige el formato: informe HTML con todos los campos (para el expediente) o CSV con todos los marcadores (para post-procesado)
Los marcadores son especificos de cada proyecto. Cada proyecto tiene su propio TN_Bookmarks.json. El formato es compatible hacia atras: los marcadores creados con versiones anteriores (solo fichero) se cargan correctamente sin Linea ni Columna.

17. Menus Contextuales

MaPeriT.TN dispone de tres menus contextuales independientes, accesibles con clic derecho segun el elemento sobre el que se pulse.

17.1 Menu contextual del Explorador (arbol de proyecto)

Clic derecho sobre cualquier fichero en el arbol del explorador:

OpcionAccion
Abrir en pestanaAbre el fichero en su visor (equivalente a clic simple)
Anadir marcador...Abre el dialogo de marcador de fichero completo
Escanear IOCs en ficheroEscanea solo ese fichero y muestra resultados en nueva pestana
Copiar rutaCopia la ruta completa del fichero al portapapeles
Abrir ubicacionAbre el Explorador de Windows con el fichero seleccionado

17.2 Menu contextual de fila (DataGrid)

Clic derecho sobre cualquier fila de un visor con tabla (CSV, EVTX, MFT, IOC Scan, Timeline, Busqueda Global) selecciona automaticamente la fila bajo el cursor y muestra:

OpcionAccion
Copiar filaCopia todos los campos de la fila seleccionada al portapapeles en formato TSV (pegable en Excel)
Anadir marcador en fila...Abre el dialogo de marcador pre-rellenado con el contexto de la fila: numero de linea, columna y valor de celda. Extrae automaticamente la ruta del fichero origen si el visor la proporciona (columna Ruta en IOC Scan y Busqueda Global).
Escanear IOCs en filaLanza el escaneo IOC de fichero individual usando la ruta del fichero origen de la fila (si disponible). Util en IOC Scan y Busqueda Global para ir directamente al fichero con hallazgos.
En visores con columna Ruta (IOC Scan, Busqueda Global), "Anadir marcador en fila" y "Escanear IOCs en fila" operan sobre el fichero origen de esa fila, no sobre el proyecto completo.

17.3 Menu contextual de la cabecera de pestana

Clic derecho sobre la cabecera de cualquier pestana abierta. Documentado en la seccion 4.2.

18. Atajos de Teclado

AtajoAccion
Ctrl+WCerrar la pestana activa
Ctrl+FEnfocar la caja de busqueda global en la toolbar
Ctrl+IAbrir / ir al Escaner IOC de proyecto
Ctrl+TAbrir / ir a la Timeline consolidada
Enter (en busqueda de texto/log)Ir a la siguiente ocurrencia del termino buscado
Enter (en offset hex)Scroll al offset indicado en el visor Hex
Ctrl+C (en DataGrid CSV/EVTX)Copiar filas seleccionadas en formato TSV

19. Arquitectura del Codigo

Modulos fuente (orden de compilacion)
MAPERIT_TN\ ├── MaPeriT.TN.ps1 ← compilado (ejecutar este) ├── Build.ps1 ← compilador ├── manual.html ← este manual └── src\ ├── Main-Params.ps1 Parametros -ProjectPath / -OpenFile ├── Config.ps1 Colores, IOC patterns, Event IDs, ViewerMap ├── Core\ │ ├── Initialize.ps1 Assemblies WPF, DPI, dark title bar │ ├── Logging.ps1 Utilidades de log │ ├── ProjectLoader.ps1 Carga de proyecto, metadatos, arbol │ ├── AsyncLoader.ps1 Carga asincrona CSV via Runspace │ └── Bookmarks.ps1 Sistema de marcadores y anotaciones ├── Analysis\ │ ├── IOCHighlighter.ps1 Coloracion por severidad en filas/celdas │ ├── IOCScanner.ps1 Escaner IOC asincrono de proyecto completo │ └── TimelineBuilder.ps1 Timeline consolidada EVTX+MFT+CSV ├── Viewers\ │ ├── TextViewer.ps1 Visor texto con numeracion y busqueda │ ├── JSONViewer.ps1 Pretty-print JSON │ ├── CSVViewer.ps1 DataGrid con filtro, IOC, exportacion │ ├── MFTViewer.ps1 Visor MFT CSV con timestomping │ └── EVTXViewer.ps1 Visor eventos Windows └── UI\ ├── XAML.ps1 Definicion de la ventana y estilos WPF ├── Dashboard.ps1 Vista resumen del proyecto ├── MainWindow.ps1 Logica de ventana, tabs, busqueda, IOC, hex └── Main.ps1 Punto de entrada: init WPF, cargar XAML

19.1 Principio de diseno: sin closures

Todos los handlers de eventos en MaPeriT.TN usan el patron param($sender, $e) con el estado almacenado en la propiedad .Tag del control emisor. Esto evita los problemas de closures de PowerShell en contextos WPF donde las variables capturadas no se actualizan correctamente.

19.2 Carga asincrona

Los ficheros grandes (CSV, IOC Scan, Timeline) se cargan en Runspaces de PowerShell separados. Un DispatcherTimer en el hilo UI verifica cada 150-500 ms si el Runspace ha terminado y actualiza la interfaz. Esto garantiza que la UI nunca se bloquea independientemente del tamano del fichero.

20. Resolucion de Problemas

Problemas comunes
ProblemaCausa probableSolucion
La aplicacion no arranca PowerShell menor que 5.1 o politica de ejecucion restrictiva Comprobar $PSVersionTable.PSVersion. Lanzar con -ExecutionPolicy Bypass.
"El directorio seleccionado no parece un proyecto de MaPeriT.SW ni de MaPeriT.OF" El directorio no contiene HashManifest.csv ni carpetas de fase reconocidas Verificar que se ha seleccionado el directorio raiz del proyecto SW, no una subcarpeta.
CSV no carga o carga vacio Fichero con codificacion distinta a UTF-8, delimitador diferente a coma, o error de permisos Intentar abrirlo con el Visor de Texto para ver el contenido raw. MaPeriT.TN usa Import-Csv con UTF-8.
EVTX muestra "Error al leer" Sin permisos para leer el .evtx, o fichero corrupto Ejecutar TN como Administrador si el .evtx esta en una ubicacion protegida. Si el fichero esta corrupto, usarlo desde MaPeriT.AN.
IOC Scan no encuentra resultados El proyecto no contiene CSV/TXT/LOG, o los ficheros superan 30 MB Normal en proyectos con solo datos binarios. Verificar la fase 5 (EVTX) y las fases de persistencia.
Timeline tarda mucho Proyecto con muchos EVTX grandes o MFT CSV con muchos registros Normal en proyectos grandes. La barra de estado indica "Construyendo timeline..." mientras trabaja. No cerrar la ventana.
Marcadores no se guardan Sin permisos de escritura en el directorio del proyecto, o directorio en red de solo lectura Copiar el proyecto a un directorio local con permisos de escritura antes de abrir TN.
La busqueda global no devuelve resultados esperados Los .evtx no se buscan en la busqueda global (solo ficheros de texto) Para buscar en eventos EVTX usar el filtro del Visor EVTX directamente, o el Escaner IOC de proyecto.

21. Registro de Cambios

Revision completa y pruebas reales (v1.1.2, 16/11/2026):
  • Timeline consolidada: el MFT no entraba nunca (se buscaban nombres de columna en ingles que AN no genera); ahora usa las columnas reales, no repite registros y solo colorea los de timestomping. Nueva columna Zona horaria: EVTX y MFT en UTC; la de cada CSV segun su origen.
  • Visor MFT: no coloreaba timestomping ni borrados y el filtro "Solo fuera de System32/WinSxS" no hacia nada; ahora usa las columnas de AN.
  • Dashboard: sin Anomalies.csv contaba como anomalias los programas de inicio; el perito no se mostraba nunca (ahora se lee del informe pericial) y con proyectos de OF el caso aparecia como "OF_<caso>".
  • Barra de titulo clara en el tema claro; textos que omitian MaPeriT.OF; boton "Exportar CSV" en espanol; Build.ps1 aborta si falta una fuente.
Bug critico: 0 fases detectadas en cualquier proyecto real (v1.1.1, 12/07/2026): tras completar la auditoria de las 5 herramientas del ecosistema, se ejecuto una verificacion end-to-end real (adquisicion sintetica con MaPeriT.OF, analisis con MaPeriT.AN, y carga del resultado en MaPeriT.TN) que revelo el fallo mas grave encontrado en toda la auditoria: el diccionario $Script:SW_PhaseNames (Config.ps1) usaba claves como "Phase1_Volatile", "Phase2_SystemInfo", etc., que nunca coincidian con los nombres de carpeta reales que generan MaPeriT.SW y MaPeriT.OF ($Script:OutputDirs en sus respectivos Config.ps1 usa el prefijo numerico real: 01_Volatile, 02_SystemInfo, ... 10_Persistence). Consecuencia: el arbol de fases y el contador del Dashboard mostraban siempre 0 de 10 fases reconocidas en cualquier proyecto real jamas cargado con TN desde su version inicial -- los ficheros seguian siendo accesibles por la rama generica de "carpetas no reconocidas", pero sin iconos, nombres ni conteo de fase. Se elimino ademas la clave fantasma "MemoryDump" (no es una carpeta de nivel superior real, esta anidada dentro de 01_Volatile). El mismo patron de ruta incorrecta ("Phase10_Persistence\...") se encontro y corrigio en dos sitios mas: Core\ProjectLoader.ps1 y la copia realmente ejecutada en tiempo de ejecucion dentro de UI\MainWindow.ps1. Verificado con prueba real antes/despues contra una adquisicion generada por MaPeriT.OF: PhaseCount paso de 1 (roto) a 13 (las 13 carpetas reales correctamente detectadas).
Auditoria de fiabilidad (v1.1.0, 12/07/2026): revision completa linea a linea de los 19 ficheros fuente (segunda pasada independiente sobre este proyecto). Un bug corregido y una limpieza de codigo muerto, verificados con parseo AST + motor real PowerShell 5.1 y prueba funcional directa de la logica corregida.
Correccion (v1.1.0)
FixDescripcion
Nombre de equipo siempre vacio en el DashboardEl Dashboard intentaba leer Logs\session.json para Equipo, Perito y Fecha de adquisicion -- un fichero que ni MaPeriT.SW ni MaPeriT.OF generan nunca, asi que "Equipo" quedaba en blanco en todos los proyectos reales pese a que el dato si existe en 02_SystemInfo\OSInfo.json. Corregido con un fallback que lee ese fichero (columna NombreEquipo en SW, CSName en OF). "Perito" y "Fecha de adquisicion" siguen sin mostrarse: ninguna de las dos herramientas de adquisicion persiste ese dato en un fichero legible por separado hoy (queda documentado como limitacion conocida, no oculto).
Limpieza de codigo (v1.1.0)
CambioDescripcion
Logica de metadatos duplicadaGet-ProjectMetadata (Core\ProjectLoader.ps1) nunca se llamaba desde ningun sitio -- la logica realmente usada en tiempo de ejecucion era una copia casi identica dentro de Load-ProjectTree (UI\MainWindow.ps1). Se corrigieron ambas copias de forma consistente.
16 ficheros .bak sueltos en src\Restos de ediciones anteriores dispersos directamente en las carpetas de codigo fuente (no interferian con la compilacion, pero incumplian la norma de mantener los backups en una unica carpeta). Retirados del codigo fuente.
MaPeriT.TN es una herramienta de visualizacion forense informatica. Su uso debe estar autorizado por el propietario de los datos o por orden judicial. El uso no autorizado puede constituir un delito conforme a la legislacion vigente.

MaPeriT.TN opera en modo de solo lectura sobre el directorio de evidencias. La unica excepcion es el fichero TN_Bookmarks.json, que se crea o actualiza cuando el perito guarda marcadores, y los informes que el perito genera y guarda explicitamente mediante los botones de exportacion.

Los informes de marcadores e IOCs generados por MaPeriT.TN son de caracter tecnico y orientativo. Los hallazgos detectados automaticamente (IOCs, severidad de eventos, timestomping) deben ser validados, contextualizados e interpretados por un perito informatico cualificado antes de ser utilizados en un informe pericial o procedimiento judicial.

Limitaciones de la deteccion automatica

  • Los patrones IOC pueden generar falsos positivos en entornos con software de administracion legitimo que use los mismos ejecutables o rutas
  • La coloracion de severidad es orientativa y no equivale a una conclusion pericial
  • La timeline consolida fuentes heterogeneas que pueden tener desfases horarios si el equipo tenia la zona horaria mal configurada
  • El timestomping detectado en el Visor MFT requiere validacion manual antes de ser afirmado en un informe


MaPeriT.TN — Visor Forense del Ecosistema MaPeriT v1.1.2

Parte del ecosistema MaPeriT de Peritacion Informatica Forense

Manual actualizado el 16/11/2026 — v1.1.2 (timeline y visor MFT con las columnas reales de AN, zona horaria, recuento de anomalias)