← MAPerit Manual de usuario · Versión 1.7.5

MaPeriT.SW

Analisis forense digital completo para sistemas Windows conforme a RFC 3227 y NIST SP 800-86

1. Introduccion

MaPeriT.SW es una herramienta de peritacion informatica forense profesional desarrollada integramente en PowerShell. Realiza una adquisicion forense completa de un equipo Windows, generando un informe HTML profesional en espanol apto para presentacion en juzgado.

La herramienta ejecuta 10 fases de adquisicion siguiendo el orden de volatilidad establecido en la RFC 3227, recopila centenares de artefactos forenses, construye una linea temporal unificada, detecta anomalias automaticamente y genera un informe pericial con cadena de custodia documentada.

Sin alterar las evidencias: MaPeriT.SW no modifica ni borra ninguno de los ficheros que recoge; las evidencias se escriben solo en el directorio de salida especificado. Los hives de registro de usuarios sin sesion se consultan sobre una copia de trabajo, nunca sobre el original. Aun asi, como toda adquisicion en vivo, ejecutar la herramienta deja trazas propias e inevitables en el equipo (registros de eventos, Prefetch de PowerShell y una instantanea VSS temporal que se elimina al finalizar).

1.1 Caracteristicas Principales

🔒
Integridad SHA-256Cada evidencia se hashea en el momento de adquisicion. Manifiesto completo y HMAC opcional.
📄
Cadena de CustodiaDocumentacion automatica de cada pieza de evidencia con formato apto para juzgado.
📊
Informe Pericial HTMLInforme profesional completo con portada, indice, hallazgos, anomalias y conclusiones.
🕑
Timeline UnificadaCorrelacion de eventos de 12+ fuentes ordenados cronologicamente.
⚠
Deteccion de AnomaliasMotor automatico que identifica 11 categorias de comportamiento sospechoso.
💾
Extraccion MFT RawAcceso directo al disco via P/Invoke para extraer la Master File Table.
📷
VSS SnapshotsCopia de ficheros bloqueados mediante Volume Shadow Copy Service.
🌐
Sin conexion a redLa herramienta no realiza ninguna conexion de red. Funcionamiento 100% local.

1.2 Normativa y Estandares

Estandares de Cumplimiento
EstandarDescripcionAplicacion en MaPeriT.SW
RFC 3227 (IETF) Guidelines for Evidence Collection and Archiving Orden de volatilidad en las fases de adquisicion (volatil primero), cadena de custodia, integridad de evidencias
NIST SP 800-86 Guide to Integrating Forensic Techniques into Incident Response Metodologia de adquisicion, verificacion de integridad SHA-256, documentacion de procedimientos
FIPS 180-4 Secure Hash Standard Algoritmo SHA-256 para hashing de todas las evidencias

Registro de Cambios

Revision completa y pruebas reales (v1.7.5, 16/11/2026):
  • Hives de usuarios sin sesion: se monta una copia de trabajo de NTUSER.DAT, nunca el original (antes reg load abria el fichero original en lectura-escritura).
  • ShimCache: el interprete leia la longitud de la ruta en una posicion equivocada y solo recorria los primeros 4 KB; ahora lee el formato de Windows 10/11 completo (comprobado con datos reales: 1.024 entradas legibles).
  • Verificacion con -VerifyPath: daba siempre "integridad comprometida" porque el manifiesto incluia el registro de ejecucion, que se sigue escribiendo; ademas devolvia siempre codigo 0. Con una ruta de salida relativa o abreviada (8.3) el manifiesto quedaba con rutas vacias.
  • Un unico elemento se perdia: en PowerShell 5.1 una sola anomalia (WMI, ADS, apagado inesperado, amenaza de Defender, certificado, COM), un solo evento de timeline o una sola fila de custodia se contaban como cero; el informe decia "sin anomalias".
  • -SkipPhases pasa a ser texto ("8,9"): la forma @(8,9) fallaba al invocar el script con -File.
  • Otros: perfiles Wi-Fi en Windows en espanol; hive DEFAULT exportado desde HKU\.DEFAULT; eventos de tareas actualizadas (140); cookies de Chrome/Edge 96+ (Network\Cookies); configuracion de OneDrive leida del perfil correspondiente y no del perito; enlace activo del indice del informe resaltado.
Verificacion end-to-end real y refuerzo de fiabilidad (v1.7.4, 12/07/2026): tras completar la auditoria de las 5 herramientas, se ejecuto una adquisicion OF -> AN -> TN real (disco sintetico montado con subst) para validar el ecosistema completo, no solo cada herramienta por separado. Se encontro y corrigio un fallo real de fiabilidad, mas tres mejoras de proceso:
  • HtmlEncode podia fallar en silencio: Add-Type -AssemblyName System.Web -ErrorAction SilentlyContinue puede no cargar el tipo incluso bajo PowerShell 5.1 (confirmado empiricamente en esta verificacion, no es exclusivo de PowerShell 7) - cuando falla, TODO el informe pericial se rompe con "No se encuentra el tipo". Ahora Common\HtmlEncoding.ps1 garantiza que el tipo System.Web.HttpUtility siempre este disponible, con un reemplazo minimo si el ensamblado real no carga.
  • Libreria compartida Common\: Get-RelativeEvidencePath (usada por SW y OF) ya no se mantiene como dos copias independientes que podian divergir o repetir el mismo bug por separado.
  • Conteo vacio con un solo fichero de evidencia: Test-HashManifest con un manifiesto de una sola fila mostraba "Total en manifiesto" vacio (mismo patron de aplanado de array de PowerShell ya documentado en el ecosistema). Corregido con @() en la captura de Import-Csv.
  • Lint de sintaxis en Build.ps1: cada compilacion verifica ahora automaticamente que el fichero resultante parsea bajo PowerShell 5.1 antes de darse por buena.
Mejoras de la segunda pasada (v1.7.3, 12/07/2026): tres mejoras identificadas durante la segunda auditoria, implementadas y verificadas (recompilado, parseo AST + motor real PowerShell 5.1, y prueba funcional real de -VerifyPath con un manifiesto sintetico: 1 fichero OK, 1 modificado y 1 faltante detectados correctamente):
  • Copy-ForensicDirectory comprueba ahora -ExcludePaths antes de crear la estructura de carpetas destino, en vez de despues: ya no quedan carpetas vacias residuales para rutas que el propio parametro pedia minimizar.
  • Fase 9 (SetupAPI logs): lectura de setupapi.dev.log en streaming linea a linea en vez de cargar el fichero completo en memoria de una vez — relevante en equipos con muchos años de uso donde este log puede crecer a cientos de MB.
  • Test-HashManifest (antes definida pero nunca usada) es ahora la unica implementacion de la verificacion de integridad: el modo -VerifyPath la reutiliza en vez de duplicar la misma logica de comparacion de hashes en dos sitios distintos del codigo.
Segunda pasada de auditoria (v1.7.2, 12/07/2026): revision completa, linea a linea, de los 24 ficheros fuente por segunda vez de forma independiente. Unico hallazgo: los campos de cabecera de los informes HTML (CaseNumber, ExaminerName, EvidenceDescription, ComputerName, OSVersion/OSBuild, ScriptPath) se interpolaban sin HtmlEncode en el titulo, barra lateral, portada, resumen ejecutivo, metodologia, conclusiones, firma y pie de InformePericial.html y CadenaCustodia.html — inconsistente con el resto del documento (tablas de evidencias y anomalias), que ya escapaba correctamente. Corregido en ambos generadores de informe. El resto de la auditoria (adquisicion, hashing, cadena de custodia, montaje/desmontaje de hives, las 6 opciones nuevas de v1.7.1) se revisó de nuevo sin encontrar defectos adicionales.
Auditoria de seguridad y fiabilidad forense (v1.7.1, 12/07/2026): revision linea a linea de todos los modulos de src\ centrada en tres riesgos: (1) que la herramienta pudiera escribir/modificar el equipo analizado pese a anunciarse como "solo lectura", (2) que un fallo en el calculo o registro de un hash SHA-256 comprometiera la cadena de custodia, y (3) que una fase reportase "OK" sin haber capturado realmente la evidencia. Se encontraron y corrigieron varios defectos reales en estas tres categorias; ver detalle abajo.
Correcciones Criticas (v1.7.1)
FixDescripcion
Hive de usuario sin desmontarDismount-OfflineUserHives (Fase 4) comprobaba el resultado del primer intento de reg unload pero no del reintento: si ambos fallaban, la clave HKEY_USERS\MAPE_<usuario> podia quedar montada de forma permanente en el registro del equipo analizado sin ningun ERROR que lo señalase — una modificacion real del sistema objetivo, en contra de la promesa de solo lectura. Ahora se hacen 3 intentos con esperas crecientes y, si el ultimo falla, se muestra un aviso critico en consola con la clave exacta a desmontar manualmente antes de devolver el equipo.
Montaje de hive fallido en silencioMount-OfflineUserHives: cuando reg load fallaba (codigo de salida distinto de 0), no se registraba ningun log — el usuario simplemente desaparecia de UserAssist/MRU/RDP History/COM Hijacking sin aviso. Ahora se registra ERROR explicito y se detectan montajes residuales de una ejecucion anterior interrumpida.
Hash invalido en cadena de custodiaCopy-ForensicFile devolvia exito incluso cuando el hash posterior a la copia no se pudo calcular (p. ej. un antivirus elimina la muestra justo despues de copiarla), y el texto de error podia quedar escrito en la columna SHA-256 del acta como si fuese un hash real. Ahora Add-ChainOfCustodyEntry valida el formato (64 hex) de todo hash antes de registrarlo, lo marca con el prefijo INVALIDO: si no es valido, y la copia ya no se cuenta como evidencia correctamente adquirida.
Fases que contaban copias fallidas como exito8 puntos de las Fases 3, 4 y 9 (SRUM, Amcache, ActivitiesCache, historial PowerShell, fichero hosts, NTUSER.DAT, UsrClass.dat, setupapi.dev.log) incrementaban el contador de elementos recopilados sin comprobar si Copy-ForensicFile habia tenido exito realmente. Corregido en los 8 puntos.
SSID de WiFi truncadoFase 2 (perfiles WiFi): -split ":" sin limite partia por todas las apariciones de : en la linea de netsh wlan show profiles; un SSID que contuviese : (p. ej. "Oficina:Invitados") quedaba truncado, y la consulta de detalle posterior fallaba o devolvia datos de otra red. Mismo patron que el bug ya corregido en MaPeriT.AN (split sin limite sobre un separador presente en el propio valor).
Rutas de servicio sin comillasFases 2 y 10: la resolucion del ejecutable de un servicio (PathName) fallaba con rutas sin comillas que contenian espacios y argumentos posicionales (el clasico patron "unquoted service path"), marcando el servicio como PathNotFound y excluyendolo en silencio de la verificacion de firma y de la deteccion de servicios sospechosos — justo el tipo de configuracion que la Fase 10 deberia señalar. Nueva funcion Resolve-ServiceExecutablePath con resolucion por candidatos progresivos.
Ruta relativa del manifiesto de hashesNew-HashManifest usaba .Replace($EvidenceRootPath,"") (sensible a mayusculas, sustituye cualquier aparicion, no solo el prefijo) en vez de un recorte anclado por prefijo como el resto del codigo. Podia corromper la ruta relativa en HashManifest.csv y producir falsos "FILE_MISSING" al verificar con -VerifyPath. Nueva funcion centralizada Get-RelativeEvidencePath.
Acta de cadena de custodia sin blindar por filaUna unica entrada con FileSize no numerico en ChainOfCustody.csv podia abortar la generacion de todo el acta HTML (documento legal). Ahora cada fila se procesa en su propio bloque protegido; una fila con error se marca y se continua con el resto.
Posible truncamiento de eventos sin avisarLas consultas Get-WinEvent -MaxEvents (Security, Sysmon, PowerShell, TaskScheduler, Defender, RDP, USB, etc.) no indicaban en ningun sitio si el resultado se habia truncado por alcanzar el limite configurado. Ahora se registra un WARNING explicito "EVENTOS_POSIBLEMENTE_TRUNCADOS" cuando el numero de eventos devueltos iguala el limite consultado.
Nuevas Funcionalidades (v1.7.1)
ParametroDescripcion
-DryRunPreflight de solo lectura: verifica que el entorno esta listo (privilegios, winpmem, perfiles de usuario, rutas de artefactos clave) sin crear VSS, sin montar hives y sin copiar ningun fichero. Probado end-to-end contra un equipo real durante la propia auditoria.
-SelfTestPrueba de humo de la cadena hash + copia + registro de custodia contra un fichero sintetico propio de la herramienta, antes de ir al equipo objetivo. Codigo de salida 0/1.
-ExcludePathsMinimizacion de datos: excluye rutas que coincidan con los patrones indicados en los dos puntos centrales de copia (cubre Fases 3, 4, 6, 7 y 8). Las exclusiones se registran siempre como SKIP.
-NetworkIsolationCheckDocumenta en 01_Volatile\NetworkIsolationCheck.json el estado de red del equipo (adaptadores activos, conexiones TCP establecidas) en el momento mas temprano posible de la adquisicion, antes incluso del VSS.
-ChainOfCustodyStrictModeSenalizacion agresiva (no aborto) de fallos de integridad: chequeo final marcado FALLIDO, alerta critica en el informe HTML y codigo de salida 2 para automatizacion.
-MaxEventsPerQueryPermite ampliar el limite de eventos por consulta desde la linea de comandos en sistemas con mucha actividad, sin tener que editar Config.ps1.
Correcciones de Errores (v1.7.0)
FixDescripcion
VSS CIMSustituido Get-WmiObject (incompatible con PS7+) por Invoke-CimMethod / Get-CimInstance para crear y eliminar snapshots VSS
VSS delete GUIDEl comando vssadmin delete shadows ahora usa /shadow={GUID} correcto. El GUID se parsea de la salida de creacion; antes se pasaba la ruta del dispositivo (incorrecto), dejando el snapshot sin eliminar
Numeracion Fase 1Corregido step header faltante para el paso 1.6 Endpoints UDP, que provocaba que todos los pasos siguientes se mostraran con un numero de menos en consola
$anomalyCountInicializada a 0 antes del bloque try de anomalias para evitar error de variable indefinida en el resumen final cuando el analisis falla
Test-HashManifestReemplazado parseo manual de CSV con Import-Csv; el split por coma fallaba silenciosamente con rutas que contenian comas
Buffer copia rawCopy-WithRawStream: buffer aumentado de 4 KB a 1 MB, reduciendo drasticamente el tiempo de copia de ficheros grandes (hives, OST, logs)
Clave HKU montaje offlinePrefijo de clave temporal cambiado de FOPE_ a MAPE_ para coincidir con el nuevo nombre de la herramienta
Mejoras (v1.7.0)
MejoraDescripcion
Timeout de fasesEl valor PhaseTimeoutMinutes ahora se aplica: si una fase supera el limite, se registra un WARNING en el log con la duracion real. Permite detectar fases que se cuelgan sin interrumpir la adquisicion.
Renombrado a MaPeriT.SWLa herramienta pasa a llamarse MaPeriT.SW v1.7.0. El binario compilado es MaPeriT.SW.ps1 y los directorios de salida usan el prefijo MaPeriT_
Namespace C#El namespace embebido pasa de ForensicPE a MaPeriT para consistencia con el nuevo nombre
Codigo muerto eliminadoEliminada Get-ForensicHashStream que existia en Hashing.ps1 sin ser llamada desde ningun lugar
Correcciones de Errores
FixDescripcion
-SkipRAMEl parametro ahora se comprueba correctamente antes de intentar el volcado de RAM
-CopyLargeFilesEl parametro ahora permite forzar la copia de PST/OST mayores de 500 MB
Hives offlineSe montan automaticamente los NTUSER.DAT de usuarios sin sesion activa, ampliando la cobertura de UserAssist, MRU, RDP y MountPoints2
ADS recursivoEl escaneo de Alternate Data Streams ahora explora subdirectorios (antes solo el nivel superior)
HashManifestSe usa Export-Csv en vez de concatenacion manual, evitando corrupcion con rutas que contienen comas o comillas
RegionesCorregidas las etiquetas #region duplicadas en todos los ficheros fuente
ContadoresEl resumen final distingue entre artefactos recopilados y piezas en cadena de custodia
RendimientoLos eventos de seguridad (4624, 4625, etc.) se parsean via Properties[] en vez de XML, mejorando la velocidad
Nuevas Funcionalidades
FuncionDescripcion
NUEVO Modo -VerifyPathVerifica la integridad de una adquisicion previa contra su manifiesto SHA-256. No requiere parametros de caso.
NUEVO Extraccion de IOCsConsolida IPs, dominios, hashes, hosts y URLs de todas las fuentes en Analysis/IOCs.csv
NUEVO Named PipesCaptura named pipes activos en Fase 1 (indicadores de C2 como Cobalt Strike, Metasploit)
NUEVO Certificados raizDetecta certificados raiz no estandar que puedan indicar MITM o adware (Fase 10)
NUEVO COM HijackingDetecta objetos CLSID registrados en HKCU que apuntan a ubicaciones de usuario (Fase 10)
NUEVO PS Module LoggingRecopila Event ID 4103 ademas del 4104 existente (Fase 5)
NUEVO Tareas XMLExporta cada tarea programada como XML crudo ademas del CSV resumen (Fase 2)

2. Requisitos del Sistema

RequisitoDetalle
Sistema OperativoWindows 10/11 o Windows Server 2016+
PowerShellVersion 5.1 o superior (incluido en Windows 10+)
PrivilegiosAdministrador requerido — El script incluye #Requires -RunAsAdministrator
Espacio en discoVariable segun el sistema (recomendado: >10 GB libres en destino)
RAM Dump (opcional)winpmem_mini_x64.exe en la carpeta tools\ para volcado de memoria

2.1 Instalacion

MaPeriT.SW no requiere instalacion. Es un script PowerShell portable que se puede ejecutar directamente desde una unidad USB o cualquier directorio.

Opcion A: Usar el script compilado (recomendado)

El fichero MaPeriT.SW.ps1 contiene todos los modulos compilados en un unico fichero. Copie este fichero al equipo objetivo o ejecutelo desde una unidad externa.

# Copiar a unidad USB
Copy-Item -Path ".\MaPeriT.SW.ps1" -Destination "E:\"
Opcion B: Volcado de RAM (opcional)

Para capturar un volcado de memoria RAM, descargue winpmem_mini_x64.exe y coloquelo en uno de estos directorios:

tools\winpmem_mini_x64.exe          # Junto al script, en subcarpeta tools\
.\winpmem_mini_x64.exe               # Mismo directorio que el script
C:\Tools\winpmem_mini_x64.exe        # Ruta fija del sistema

2.2 Sistema de Compilacion

Si ha modificado los ficheros fuente en src\, recompile el script unificado con:

.\Build.ps1

El sistema de compilacion concatena los 26 modulos fuente (24 propios y 2 compartidos de Common\) en orden correcto, anade las cabeceras #Requires y genera MaPeriT.SW.ps1 con su hash SHA-256.

Importante: No edite MaPeriT.SW.ps1 directamente. Modifique los ficheros fuente en src\ y recompile con Build.ps1.

3. Parametros de Ejecucion

Parametro Tipo Obligatorio Descripcion
-CaseNumber String Si Numero de caso o expediente. Se usa en el nombre del directorio de salida y en todos los informes.
-ExaminerName String Si Nombre completo del perito informatico. Aparece en la cadena de custodia y en el informe pericial.
-OutputPath String No Directorio de salida para evidencias. Por defecto: .\MaPeriT_<CaseNumber>_<timestamp>
-EvidenceDescription String No Descripcion del encargo pericial. Se incluye en el informe y la cadena de custodia.
-SkipPhases String No Numeros de fase (1-10) a omitir, separados por comas o espacios. Ejemplo: "8,9" omite Cloud Storage y USB. Desde v1.7.5 es texto: la forma @(8,9) fallaba al ejecutar el script con powershell -File.
-SkipRAM Switch No Omitir el volcado de memoria RAM (util si no se dispone de winpmem o por tiempo).
-CopyLargeFiles Switch No Copiar ficheros grandes (>500 MB) como PST/OST de Outlook. Por defecto solo se registran metadatos.
-HMACKey String No Clave para firmar el manifiesto de evidencias con HMAC-SHA256. Proporciona autenticacion adicional de integridad.
-VerifyPath String No Modo verificacion: comprueba la integridad de una adquisicion previa contra su manifiesto. No requiere -CaseNumber ni -ExaminerName.
-DryRun v1.7.1 Switch No Preflight de SOLO LECTURA: comprueba prerrequisitos, localiza winpmem, enumera perfiles de usuario y verifica rutas de artefactos clave. No crea VSS, no monta hives, no copia nada. No requiere -CaseNumber ni -ExaminerName.
-SelfTest v1.7.1 Switch No Prueba de humo de la cadena hash+copia+cadena de custodia contra un fichero sintetico propio de la herramienta. No toca el equipo objetivo. Codigo de salida 0/1. No requiere -CaseNumber ni -ExaminerName.
-ExcludePaths v1.7.1 String[] No Fragmentos de ruta a excluir de la copia (subcadena, sin distinguir mayusculas/minusculas). Minimizacion de datos cuando la autorizacion delimita el alcance. Las exclusiones quedan registradas como SKIP, nunca en silencio.
-NetworkIsolationCheck v1.7.1 Switch No Comprobacion de LECTURA que documenta en 01_Volatile\NetworkIsolationCheck.json si el equipo tenia adaptadores activos o conexiones TCP establecidas en el momento de la adquisicion. No aisla ni desconecta nada.
-ChainOfCustodyStrictMode v1.7.1 Switch No Si alguna evidencia queda con hash invalido, marca el chequeo final de integridad como FALLIDO (consola, informe HTML y codigo de salida 2). No aborta la adquisicion en curso: interrumpirla perderia datos volatiles irrecuperables de fases posteriores.
-MaxEventsPerQuery v1.7.1 Int No Sobrescribe en tiempo de ejecucion el limite por defecto (50.000) de eventos por consulta a los logs de Windows, sin editar Config.ps1.

3.1 Ejemplos de Uso

Ejecucion basica
.\MaPeriT.SW.ps1 -CaseNumber "2026-001" -ExaminerName "Juan Perez Garcia"

Ejecuta todas las fases y guarda las evidencias en un directorio con el formato MaPeriT_2026-001_YYYYMMDD_HHMMSS.

Salida a unidad externa con descripcion
.\MaPeriT.SW.ps1 -CaseNumber "CASO-2026-0457" `
    -ExaminerName "Ana Garcia Lopez" `
    -OutputPath "E:\Evidencias\CASO-0457" `
    -EvidenceDescription "Analisis del portatil HP del empleado para investigacion interna"
Omitir fases y firmar con HMAC
.\MaPeriT.SW.ps1 -CaseNumber "INC-789" `
    -ExaminerName "Carlos Martinez" `
    -SkipPhases "8,9" `
    -SkipRAM `
    -HMACKey "clave-secreta-peritaje-2026"

Omite las fases 8 (Cloud Storage) y 9 (USB), no hace volcado de RAM, y firma el manifiesto con HMAC-SHA256.

Verificar integridad de una adquisicion previa
.\MaPeriT.SW.ps1 -VerifyPath "E:\Evidencias\MaPeriT_CASO-001_20260602"

Comprueba todos los hashes SHA-256 del manifiesto contra los ficheros actuales. No modifica nada. Util para demostrar en juicio que las evidencias no han sido alteradas.

Adquisicion completa incluyendo ficheros grandes
.\MaPeriT.SW.ps1 -CaseNumber "JUD-2026-112" `
    -ExaminerName "Maria Fernandez Ruiz" `
    -OutputPath "F:\Peritajes\JUD-112" `
    -CopyLargeFiles `
    -HMACKey "hmac-judicial-2026"

3.2 Flujo de Ejecucion

Verificar Prerequisitos
➔
Cargar Helpers C#
➔
Crear Directorios
➔
Iniciar Logging
➔
Crear VSS Snapshot
➔
Fases 1-10
➔
Timeline
➔
Anomalias
➔
Hash Manifest
➔
Informes
➔
Limpieza VSS

4. Fases de Adquisicion

MaPeriT.SW ejecuta 10 fases de adquisicion en orden de volatilidad (RFC 3227). Los datos mas volatiles se recogen primero para minimizar la perdida de evidencias.

Fase 1: Datos Volatiles

1 Datos Volatiles — RFC 3227: Prioridad Maxima

Captura informacion que se pierde al apagar o reiniciar el equipo. Es la fase mas critica y se ejecuta primero.

PasoArtefactoFichero de Salida
1.1Fecha, hora y zona horaria del sistema, uptime, servidor NTPSystemTime.json
1.2Volcado de memoria RAM (requiere winpmem)MemoryDump/memory.raw
1.3Procesos en ejecucion (PID, ruta, linea de comandos, propietario)Processes.csv
1.3bHashes SHA-256 de todos los ejecutables de procesos activosProcessHashes.csv
1.4Modulos/DLLs cargados por cada procesoProcessModules.csv
1.5Conexiones TCP activas con proceso asociadoNetworkConnections_TCP.csv
1.6Endpoints UDP activosNetworkConnections_UDP.csv
1.7Usuarios conectados (sesiones de logon, query user)LoggedOnUsers.csv, QueryUser.txt
1.8Ficheros abiertos SMB y recursos compartidosOpenFiles.csv, NetFile.txt
1.9Contenido del portapapeles (texto)Clipboard.txt
1.10Cache DNS del clienteDnsCache.csv
1.11Cache ARP (tabla de vecinos)ArpCache.csv
1.12Tabla de rutas de redRoutingTable.csv
1.13Recursos compartidos y unidades mapeadas (net use)NetworkShares.csv, MappedDrives.txt
1.14Variables de entorno (Machine, User, Process)EnvironmentVariables.csv
1.15Tareas programadas activasActiveScheduledTasks.csv
1.16Named Pipes activos (indicadores de C2 y comunicacion entre procesos)NamedPipes.csv

Fase 2: Informacion del Sistema

2 Informacion del Sistema

Inventario completo del hardware, software, configuracion de red, seguridad y politicas del sistema.

PasoArtefactoFichero de Salida
2.1Inventario de hardware (CPU, RAM, discos, BIOS, placa base, GPU, NICs)HardwareInventory.json
2.2Informacion del SO (version, build, fecha instalacion, serial)OSInfo.json
2.3Volumenes y particiones de discoVolumes.csv, Partitions.csv
2.4Usuarios y grupos locales con miembrosLocalUsers.csv, LocalGroups.csv
2.5Software instalado (de 3 rutas de Uninstall del registro)InstalledSoftware.csv
2.6Servicios de Windows con estado de firma digitalServices.csv
2.7Tareas programadas completas (triggers, acciones, RunAs) + exportacion XML crudoScheduledTasks.csv, ScheduledTasksXML/
2.8Drivers cargados en el sistemaDrivers.csv
2.9Actualizaciones de Windows instaladas (hotfixes)WindowsUpdates.csv
2.10Configuracion de red (IPs, perfiles WiFi con claves)IPAddresses.csv, WiFiProfiles.csv
2.11Reglas de firewall activas con puertos y programasFirewallRules.csv
2.12Estado de cifrado BitLockerBitLocker.json
2.13Productos antivirus, estado de Defender y amenazas detectadasAntivirusStatus.json
2.14Politica de seguridad local (secedit export)SecurityPolicy.inf
2.15Resultado de politicas de grupo (gpresult)GPResult.html, GPResult.txt

Fase 3: Artefactos del Sistema de Ficheros

3 Artefactos del Sistema de Ficheros

Extraccion de artefactos NTFS criticos y ficheros con valor probatorio del sistema de ficheros.

PasoArtefactoFichero de Salida
3.1MFT (Master File Table) — extraccion raw via P/Invoke$MFT
3.2USN Journal (registro de cambios NTFS)UsnJournal.csv
3.3NTFS $LogFile (transacciones del sistema de ficheros)$LogFile
3.4Ficheros Prefetch (evidencia de ejecucion de programas)Prefetch/*.pf, PrefetchSummary.csv
3.5Ficheros recientes / LNK (accesos directos con rutas y timestamps)RecentFiles/, LNKParsed.csv
3.6Jump Lists (AutomaticDestinations y CustomDestinations)JumpLists/
3.7Papelera de reciclaje (ficheros $I parseados con nombre original y fecha)RecycleBin/, RecycleBinSummary.csv
3.8Thumbcache (miniaturas de imagenes visualizadas)Thumbcache/
3.9SRUM (System Resource Usage Monitor)SRUM/SRUDB.dat
3.10Amcache.hve (historial de ejecucion de aplicaciones)Amcache.hve
3.11ActivitiesCache (Windows Timeline)ActivitiesCache/
3.12BITS Transfer Jobs (transferencias en segundo plano)BITSJobs.txt
3.13Historial de PowerShell (ConsoleHost_history.txt por usuario)PowerShellHistory/
3.14Fichero hosts del sistemahosts
3.15Elementos de inicio (carpetas Startup de todos los usuarios)StartupItems/
3.16Informacion del volumen NTFS (MFT offset, clusters, serial)NTFSVolumeInfo.json

Fase 4: Registro de Windows

4 Registro de Windows

Copia binaria de los hives del registro y extraccion de valores forenses clave. En v1.5, se montan automaticamente los hives NTUSER.DAT de usuarios offline para que UserAssist, MRU, RDP y MountPoints2 cubran todos los usuarios, no solo los que tienen sesion activa.

PasoArtefactoFichero de Salida
4.0NUEVO Montaje automatico de hives NTUSER.DAT de usuarios sin sesion activa—
4.1Hives del sistema: SAM, SYSTEM, SOFTWARE, SECURITY, DEFAULTHives/
4.2NTUSER.DAT y UsrClass.dat de cada usuarioHives/Users/
4.3Hora del ultimo apagado del sistemaLastShutdown.json
4.4Zona horaria del registroTimeZone.json
4.5Historial de redes conectadas (perfiles, primera/ultima conexion)NetworkProfiles.csv
4.6Historial de dispositivos USB (USBSTOR con fechas de instalacion)USBSTORDevices.csv
4.7MountedDevices (volumenes montados)MountedDevices.csv
4.8UserAssist (programas ejecutados con ROT13 decodificado)UserAssist.csv
4.9ShimCache / AppCompatCache (historial de ejecucion)AppCompatCache.bin, ShimCache.csv
4.10BAM/DAM (Background Activity Monitor - ejecuciones recientes)BAM_DAM.csv
4.11Autoruns del registro (Run, RunOnce, Winlogon Shell/Userinit)Autoruns.csv
4.12Listas MRU (RunMRU, TypedPaths, TypedURLs)MRULists.csv
4.13Historial de conexiones RDP (servidores y usuarios)RDPHistory.csv
4.14Ultimo usuario que inicio sesionLastLoggedOnUser.json

Fase 5: Logs de Eventos

5 Logs de Eventos

Copia de todos los ficheros .evtx y analisis detallado de los eventos de seguridad mas relevantes.

PasoArtefactoFichero de Salida
5.1Copia de todos los ficheros .evtx del sistemaRawLogs/*.evtx
5.2Eventos de logon exitoso (Event ID 4624) con tipo, IP y usuarioSecurityLogon.csv
5.3Intentos de logon fallidos (Event ID 4625) con razon de falloSecurityFailedLogon.csv
5.4Gestion de cuentas (creacion, eliminacion, cambios de password, etc.)SecurityAccountChanges.csv
5.5Eventos de servicios (instalacion, crash, cambios de inicio)SystemServices.csv
5.6Arranques y apagados (incluyendo apagados inesperados 6008)SystemShutdowns.csv
5.7PowerShell Script Block Logging (scripts ejecutados, Event ID 4104)PowerShellScripts.csv
5.7bNUEVO PowerShell Module Logging (cmdlets invocados, Event ID 4103)PowerShellModuleLog.csv
5.8Eventos del Programador de Tareas (registro, eliminacion, ejecucion)TaskScheduler.csv
5.9Eventos de Windows Defender (detecciones, alertas)DefenderEvents.csv
5.10Sesiones RDP/Terminal Services (logon, shell, desconexion)RDPSessions.csv
5.11Eventos Sysmon (si esta instalado: procesos, red, ficheros)Sysmon.csv
5.12Errores de aplicacion (crashes, WER, hangs)AppCrashes.csv

Fase 6: Navegadores Web

6 Navegadores Web

Recopilacion de bases de datos y artefactos de todos los navegadores instalados, por cada perfil de usuario.

PasoArtefactoFichero de Salida
6.1Google Chrome: History, Cookies, Login Data, Bookmarks, Downloads, extensionesChrome/<user>/
6.2Microsoft Edge: mismos artefactos que Chrome (motor Chromium)Edge/<user>/
6.3Mozilla Firefox: places.sqlite, cookies, logins, formhistory, key4.dbFirefox/<user>/
6.4Internet Explorer: WebCacheV01.datInternetExplorer/<user>/
6.5Resumen de navegadores detectados con conteo de ficheros y tamanoBrowserSummary.csv

Fase 7: Comunicaciones

7 Comunicaciones

Artefactos de aplicaciones de correo y mensajeria instantanea.

PasoArtefactoFichero de Salida
7.1Microsoft Outlook: ficheros PST y OST (metadatos o copia segun tamano)Outlook/, OutlookFiles.csv
7.2Microsoft Teams: bases de datos, JSON, logs (New Teams y Classic)Teams/
7.3Skype: bases de datos SQLite y JSON de conversacionesSkype/
7.4Discord: Local Storage (leveldb) y deteccion de cacheDiscord/
Ficheros grandes: Los PST/OST de mas de 500 MB solo se copian si se usa el parametro -CopyLargeFiles. De lo contrario, se registran en OutlookFiles.csv con sus metadatos.

Fase 8: Almacenamiento en la Nube

8 Almacenamiento en la Nube

Logs y metadatos de sincronizacion de servicios cloud instalados localmente.

PasoArtefactoFichero de Salida
8.1Microsoft OneDrive: logs, settings, configuracion del registroOneDrive/
8.2Google Drive: bases de datos de metadatos y logs de DriveFSGoogleDrive/
8.3Dropbox: bases de datos, configuracion, info.jsonDropbox/
8.4Resumen con servicios detectados y tamano de datos recopiladosCloudStorageSummary.csv

Fase 9: Dispositivos USB/Externos

9 Dispositivos USB/Externos

Historial completo de dispositivos USB conectados al sistema con timeline de conexiones.

PasoArtefactoFichero de Salida
9.1Dispositivos USBSTOR y USB del registro (fabricante, serial, VID/PID)USBDevices.csv
9.2SetupAPI logs: fechas de instalacion de drivers USBsetupapi.dev.log, SetupAPIUSBEvents.csv
9.3MountPoints2 por usuario (volumenes montados por cada cuenta)MountPoints2.csv
9.4Discos conectados actualmente (separando discos USB)CurrentDisks.csv, CurrentUSBDisks.csv
9.5Timeline de conexiones USB (DriverFrameworks + Kernel-PnP)USBTimeline.csv

Fase 10: Mecanismos de Persistencia

10 Mecanismos de Persistencia

Deteccion de tecnicas de persistencia utilizadas por malware y actores maliciosos.

PasoArtefactoFichero de Salida
10.1Autoruns consolidados: 10 claves Run/RunOnce, Winlogon, carpetas Startup, tareas programadas con nivel de riesgoAutorunsConsolidated.csv
10.2Suscripciones WMI (EventFilter, EventConsumer, Bindings)WMIPersistence.csv
10.3Alternate Data Streams (ADS) sospechosos en directorios criticosAlternateDataStreams.csv
10.4Servicios en ejecucion con ejecutables sin firma digital validaUnsignedServices.csv
10.5Procesos ejecutandose desde ubicaciones inusuales (Temp, Users, Downloads...)SuspiciousProcesses.csv
10.6Servicios instalados en los ultimos 30 dias (Event ID 7045)RecentServiceInstalls.csv
10.7NUEVO Certificados raiz sospechosos en el almacen de confianza (Cert:\LocalMachine\Root)SuspiciousRootCerts.csv
10.8NUEVO COM Hijacking: objetos CLSID en HKCU que apuntan a ubicaciones de usuarioCOMHijacking.csv

5. Linea Temporal Unificada

MaPeriT.SW construye automaticamente una timeline unificada que correlaciona eventos de multiples fuentes en orden cronologico. Esto permite reconstruir la secuencia de actividades en el sistema.

Fuentes de datos integradas en la Timeline

FuenteTipo de Eventos
Security Event LogLogons exitosos, logons fallidos
System Event LogArranques, apagados, servicios instalados
PowerShell Event LogScripts ejecutados (Script Block Logging)
RDP/Terminal ServicesSesiones remotas (logon, shell, disconnect)
Task SchedulerTareas registradas, eliminadas
USB EventsConexiones y desconexiones de dispositivos
Registry BAM/DAMEjecucion de programas con timestamp
Registry UserAssistProgramas ejecutados por el usuario (con conteo)
PrefetchProgramas ejecutados (por fecha de modificacion)
Papelera de ReciclajeFicheros eliminados con fecha y nombre original
Windows DefenderDetecciones de amenazas (Warning/Error/Critical)

Ficheros generados

  • Analysis/Timeline.csv — Timeline completa con todos los eventos
  • Analysis/Timeline_Last7Days.csv — Solo eventos de los ultimos 7 dias

5.2 Extraccion de IOCs (Indicadores de Compromiso)

Nuevo en v1.5: MaPeriT.SW extrae y consolida automaticamente indicadores de compromiso de multiples fuentes en un fichero unificado.

Fuentes de IOCs

Tipo de IOCFuente
IPs externasConexiones TCP activas (excluye rangos privados RFC 1918)
DominiosCache DNS del cliente
Hashes SHA-256Ejecutables de procesos activos
IPs de ataqueLogons fallidos (agrupados por IP de origen)
Hosts RDPHistorial de conexiones RDP del registro
URLsTypedURLs del registro (IE/Explorer)

Ficheros generados

  • Analysis/IOCs.csv — IOCs deduplicados en formato CSV
  • Analysis/IOCs.json — IOCs en formato JSON para integracion con SIEM/SOAR

6. Deteccion de Anomalias

El motor de anomalias analiza automaticamente las evidencias recopiladas para identificar comportamientos sospechosos. Cada anomalia recibe un ID unico, una severidad y una recomendacion.

Niveles de Severidad

SeveridadDescripcion
CRITICAIndicadores claros de compromiso o actividad maliciosa confirmada
ALTAComportamiento altamente sospechoso que requiere investigacion inmediata
MEDIAActividad inusual que puede tener explicacion legitima pero debe verificarse
BAJAInformacion de interes forense con bajo riesgo

Tipos de Anomalias Detectadas

A3: Persistencia WMI — Suscripciones WMI (EventFilter/EventConsumer/Bindings). Mecanismo avanzado de persistencia frecuente en APTs y malware.
A4: Fuerza bruta — Mas de 10 intentos de logon fallidos por usuario o mas de 20 por IP de origen. Puede indicar ataque de fuerza bruta.
A8: Malware detectado — Amenazas registradas en Windows Defender. Confirma presencia de software malicioso.
A2: Servicios sin firma digital — Servicios en ejecucion cuyo ejecutable no tiene firma digital valida.
A5: Servicios sospechosos recientes — Servicios instalados en los ultimos 30 dias con rutas que apuntan a Users, Temp, o interpretes de comandos.
A9: Autoruns de alto riesgo — Entradas de autorun con rutas a directorios de usuario o interpretes de comandos.
A1: Procesos sospechosos — Procesos ejecutandose desde ubicaciones atipicas (Temp, Downloads, AppData, ProgramData, Public).
A6: Alternate Data Streams — ADS no estandar detectados en ficheros del sistema (excluye Zone.Identifier).
A7: Apagados inesperados — Eventos Event ID 6008 que pueden indicar desconexiones forzadas.
A10: Certificados raiz sospechosos NUEVO — Certificados en el almacen raiz de confianza que no pertenecen a CAs reconocidas. Puede indicar MITM, adware o proxies no autorizados.
A11: COM Hijacking NUEVO — Objetos COM registrados en HKCU con servidores que apuntan a directorios de usuario. Tecnica de persistencia y evasion.

7. Estructura de Salida

MaPeriT_CASO-001_20260602_143022/ ├── 01_Volatile/ ← Fase 1: Datos volatiles │ ├── SystemTime.json, Processes.csv, NetworkConnections_TCP.csv, NamedPipes.csv ... │ └── MemoryDump/ ← memory.raw (volcado RAM) ├── 02_SystemInfo/ ← Fase 2: Informacion del sistema │ └── HardwareInventory.json, OSInfo.json, Services.csv ... ├── 03_Filesystem/ ← Fase 3: Artefactos del sistema de ficheros │ ├── $MFT, UsnJournal.csv, Amcache.hve ... │ ├── Prefetch/, RecentFiles/, JumpLists/, RecycleBin/ │ └── PowerShellHistory/, Thumbcache/, SRUM/ ├── 04_Registry/ ← Fase 4: Registro de Windows │ ├── Hives/ ← SAM, SYSTEM, SOFTWARE, SECURITY, NTUSER.DAT ... │ └── ExtractedValues/ ← UserAssist.csv, BAM_DAM.csv, Autoruns.csv ... ├── 05_EventLogs/ ← Fase 5: Logs de eventos │ ├── RawLogs/ ← Todos los .evtx originales │ └── Analysis/ ← SecurityLogon.csv, PowerShellScripts.csv ... ├── 06_Browsers/ ← Fase 6: Navegadores web │ ├── Chrome/, Edge/, Firefox/, InternetExplorer/ │ └── BrowserSummary.csv ├── 07_Communications/ ← Fase 7: Comunicaciones │ └── Outlook/, Teams/, Skype/, Discord/ ├── 08_CloudStorage/ ← Fase 8: Almacenamiento en la nube │ └── OneDrive/, GoogleDrive/, Dropbox/ ├── 09_USB/ ← Fase 9: Dispositivos USB │ └── USBDevices.csv, USBTimeline.csv, setupapi.dev.log ... ├── 10_Persistence/ ← Fase 10: Mecanismos de persistencia │ └── AutorunsConsolidated.csv, WMIPersistence.csv, UnsignedServices.csv, SuspiciousRootCerts.csv, COMHijacking.csv ... ├── Analysis/ ← Analisis automatizado │ ├── Timeline.csv ← Timeline unificada completa │ ├── Timeline_Last7Days.csv │ ├── IOCs.csv ← Indicadores de compromiso │ ├── IOCs.json │ ├── Anomalies.csv ← Anomalias detectadas │ └── Anomalies.json ├── Report/ ← Informes generados │ ├── InformePericial.html ← Informe pericial completo │ └── CadenaCustodia.html ← Acta de cadena de custodia └── Logs/ ← Logs de la herramienta ├── ActionLog.csv ← Registro de todas las acciones ├── ChainOfCustody.csv ← Datos crudos de custodia ├── HashManifest.csv ← Hashes SHA-256 de todos los ficheros └── ManifestHMAC.txt ← HMAC del manifiesto (si se uso -HMACKey)

8. Informes Generados

InformePericial.html

Informe pericial HTML profesional completo que incluye:

  • Portada con numero de caso, perito, fecha y hash de la herramienta
  • Indice con 10 secciones navegables
  • Resumen ejecutivo con estadisticas clave (evidencias, ficheros, anomalias)
  • Metodologia con referencia a RFC 3227 y NIST SP 800-86
  • Identificacion del sistema (hardware, SO, usuarios, red)
  • Evidencias recopiladas con conteo por directorio
  • Hallazgos (sesiones, red, software, USB, navegacion, comunicaciones, persistencia)
  • Linea temporal de los ultimos 7 dias
  • Anomalias clasificadas por severidad con recomendaciones
  • Conclusiones con espacio para firma del perito
  • Anexos colapsables (procesos, servicios, scripts PowerShell)

El informe esta optimizado para impresion en A4 y esta completamente en espanol.

CadenaCustodia.html

Acta de cadena de custodia con formato judicial que documenta:

  • Datos del caso y del perito
  • Herramienta utilizada y su hash SHA-256
  • Inventario completo de evidencias (ID, timestamp, origen, destino, hash, metodo, tamano)
  • Verificacion de integridad
  • Espacio para firma del perito y testigo

9. Integridad y Cadena de Custodia

Mecanismos de Integridad

MecanismoDescripcion
Hash por evidencia Cada fichero se hashea con SHA-256 en el momento exacto de su adquisicion y se registra en ChainOfCustody.csv.
Manifiesto global Al finalizar, se recalculan los hashes SHA-256 de todos los ficheros del directorio de salida y se guardan en HashManifest.csv.
HMAC-SHA256 Si se proporciona -HMACKey, se firma el manifiesto con HMAC-SHA256. El resultado se guarda en ManifestHMAC.txt.
Auto-hash del script MaPeriT.SW calcula su propio hash SHA-256 al inicio y lo incluye en todos los informes.

Verificacion posterior (modo -VerifyPath)

Nuevo en v1.5: MaPeriT.SW incluye un modo de verificacion integrado que no requiere scripts externos.
# Verificar integridad con el modo integrado
.\MaPeriT.SW.ps1 -VerifyPath "E:\Evidencias\MaPeriT_CASO-001_20260602"

El modo -VerifyPath:

  • Localiza automaticamente el HashManifest.csv en el directorio
  • Recalcula el SHA-256 de cada fichero y lo compara con el manifiesto
  • Informa de ficheros faltantes y hashes que no coinciden
  • No requiere -CaseNumber ni -ExaminerName
  • No modifica ningun fichero
  • Termina con codigo de salida 0 si la integridad es correcta y 1 si hay discrepancias (desde v1.7.5), para poder usarlo en scripts
  • El registro de ejecucion Logs\ActionLog.csv no forma parte del manifiesto (se sigue escribiendo despues de generarlo); cada evidencia conserva ademas su hash en Logs\ChainOfCustody.csv

10. Arquitectura del Codigo

MaPeriT.SW esta organizado en modulos independientes que se compilan en un unico fichero para facilitar el despliegue.

Fichero FuenteFuncion
src/Main-Params.ps1Definicion de parametros del script (param block)
src/Config.ps1Constantes globales, nombres de fase, rutas del registro, textos en espanol
src/Core/Logging.ps1Motor de logging, cadena de custodia, exportacion CSV/JSON/TXT
src/Core/Hashing.ps1Funciones de hash SHA-256, manifiesto, HMAC, verificacion
src/Core/CSharpHelpers.ps1Codigo C# embebido para acceso raw NTFS (P/Invoke) y extraccion MFT
src/Core/FileAcquisition.ps1VSS snapshots, copia de ficheros bloqueados, raw stream copy
src/Core/Initialize.ps1Verificacion de privilegios, estructura de directorios, sesion forense
src/Phases/Phase1-Volatile.ps1Fase 1: Datos volatiles
src/Phases/Phase2-SystemInfo.ps1Fase 2: Informacion del sistema
src/Phases/Phase3-Filesystem.ps1Fase 3: Artefactos del sistema de ficheros
src/Phases/Phase4-Registry.ps1Fase 4: Registro de Windows
src/Phases/Phase5-EventLogs.ps1Fase 5: Logs de eventos
src/Phases/Phase6-Browsers.ps1Fase 6: Navegadores web
src/Phases/Phase7-Communications.ps1Fase 7: Comunicaciones
src/Phases/Phase8-CloudStorage.ps1Fase 8: Almacenamiento en la nube
src/Phases/Phase9-USB.ps1Fase 9: Dispositivos USB
src/Phases/Phase10-Persistence.ps1Fase 10: Mecanismos de persistencia
src/Analysis/Timeline.ps1Construccion de la linea temporal unificada
src/Analysis/IOCExtractor.ps1NUEVO Extraccion y consolidacion de IOCs
src/Analysis/Anomalies.ps1Motor de deteccion de anomalias (11 tipos de deteccion)
src/Report/ChainOfCustody.ps1Generador del acta de cadena de custodia HTML
src/Report/ReportTemplates.ps1Plantillas CSS y JS del informe pericial
src/Report/ReportGenerator.ps1Generador del informe pericial HTML
src/Main.ps1Punto de entrada: orquesta las fases, analisis e informes

11. Event IDs Monitorizados

Eventos de Seguridad (Security Log)

Event IDDescripcion
4624Inicio de sesion exitoso
4625Inicio de sesion fallido
4634, 4647Cierre de sesion
4648Uso de credenciales explicitas
4672Privilegios especiales asignados
4720Cuenta de usuario creada
4722, 4725, 4726Cuenta habilitada / deshabilitada / eliminada
4723, 4724Cambio de contrasena
4738Cuenta modificada
4740Cuenta bloqueada

Eventos de Sistema

Event IDDescripcion
7034Servicio crash
7040Cambio en tipo de inicio de servicio
7045Nuevo servicio instalado
1074Apagado/reinicio iniciado
6005Servicio de log de eventos iniciado (arranque)
6006Servicio de log de eventos detenido (apagado limpio)
6008Apagado inesperado
6009Arranque del sistema

Otros Logs

LogEvent IDsDescripcion
PowerShell/Operational4103, 4104Module Logging (4103) y Script Block Logging (4104)
TaskScheduler/Operational106, 140, 141, 200, 201Registro, actualizacion, eliminacion, inicio y fin de tareas
TerminalServices21, 22, 23, 24, 25Sesiones RDP: logon, shell, logoff, disconnect, reconnect
Application1000, 1001, 1002App crash, WER report, App hang
Sysmon/Operational1, 3, 5, 7, 8, 11, 12, 13, 22Procesos, red, ficheros, registro, DNS (si Sysmon esta instalado)

12. Claves de Registro Analizadas

ClaveProposito Forense
HKLM:\SYSTEM\CurrentControlSet\Enum\USBSTORHistorial de dispositivos USB de almacenamiento
HKLM:\SYSTEM\MountedDevicesVolumenes montados historicamente
HKLM:\SOFTWARE\Microsoft\Windows NT\...\NetworkListRedes WiFi/LAN conectadas con fechas
HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run*Programas que se ejecutan al inicio (HKLM y HKCU)
HKLM:\...\Winlogon (Shell, Userinit)Shell y proceso de inicializacion (persistencia)
HKU:\<SID>\...\UserAssistProgramas ejecutados por el usuario (codificado ROT13)
HKLM:\SYSTEM\...\AppCompatCacheShimCache: historial de ejecucion de aplicaciones
HKLM:\SYSTEM\...\bam\StateBAM: actividad en segundo plano con timestamps
HKU:\<SID>\...\RunMRUComandos ejecutados en el dialogo Ejecutar
HKU:\<SID>\...\TypedPathsRutas escritas manualmente en el Explorador
HKU:\<SID>\...\Terminal Server ClientHistorial de conexiones RDP del usuario
HKU:\<SID>\...\MountPoints2Volumenes montados por el usuario (USB, red)
HKLM:\...\Authentication\LogonUIUltimo usuario que inicio sesion

13. Resolucion de Problemas

ProblemaCausaSolucion
El script no se ejecuta Politica de ejecucion restrictiva Ejecute: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
"Se requieren privilegios de Administrador" Terminal no elevada Abra PowerShell como Administrador (clic derecho > Ejecutar como administrador)
Volcado de RAM no se realiza winpmem no encontrado Coloque winpmem_mini_x64.exe en la carpeta tools\ junto al script
VSS Snapshot falla Servicio VSS detenido o sin espacio La herramienta intenta vssadmin como fallback. Algunos ficheros bloqueados no se copiaran.
MFT no se extrae Acceso raw denegado o volumen no NTFS Se intenta fallback via VSS. Si ambos fallan, se registra como warning.
Fase de Event Logs muy lenta Gran volumen de eventos en los logs Se limita a 50.000 eventos por consulta (configurable en $Script:Defaults.MaxEventsPerQuery)
Ficheros PST/OST no se copian Ficheros mayores de 500 MB Use el parametro -CopyLargeFiles para forzar la copia
Error "already exists" en C# Helpers Script ejecutado dos veces en la misma sesion Es un warning inofensivo. Los helpers ya estan cargados.
Scan de ADS tarda mucho Muchos ficheros en directorios escaneados Se aplica timeout automatico de 120 segundos (configurable). Nota: el timeout se comprueba entre ficheros/directorios, no interrumpe una enumeracion muy grande ya en curso, asi que en directorios enormes puede tardar algo mas del limite configurado.
v1.7.1 "[!!!] AVISO CRITICO: EL EQUIPO ANALIZADO HA QUEDADO MODIFICADO" al finalizar Un hive de usuario montado temporalmente en HKEY_USERS\MAPE_<usuario> (Fase 4, para leer NTUSER.DAT/UsrClass.dat de usuarios sin sesion activa) no se pudo desmontar tras 3 intentos — normalmente porque algun proceso mantiene el hive abierto Ejecute manualmente reg unload HKU\MAPE_<usuario> desde una consola elevada en el equipo analizado antes de devolverlo o reiniciarlo. Mientras la clave siga montada, el perfil de ese usuario no cargara correctamente.
v1.7.1 Entrada INVALIDO:... en Logs\ChainOfCustody.csv El hash SHA-256 de esa evidencia no se pudo calcular tras la copia (p. ej. el fichero se elimino, se puso en cuarentena por un antivirus, o quedo bloqueado justo despues de copiarlo) Revise el log de ejecucion (ERROR HASH_POST_COPIA_NO_VALIDO) para identificar la causa y, si es necesario, repita la adquisicion de ese artefacto concreto
v1.7.1 "EVENTOS_POSIBLEMENTE_TRUNCADOS" en el log de ejecucion Una consulta de log de eventos alcanzo el limite -MaxEvents configurado; el sistema tenia mas eventos de los consultados Es informativo, no bloquea la adquisicion. Si necesita el historico completo de esa fuente, aumente el limite correspondiente en Config.ps1 ($Script:Defaults.MaxEventsPerQuery u otros) y repita la fase, o exporte el .evtx completo (ya copiado integro en Fase 5.1) con otra herramienta.
USO AUTORIZADO OBLIGATORIO
Esta herramienta realiza una adquisicion forense de evidencias digitales. Su uso debe estar autorizado por el propietario del equipo o por orden judicial. El uso no autorizado puede constituir un delito conforme a la legislacion vigente.

Garantias de la Herramienta

  • MaPeriT.SW no modifica ni borra ninguno de los ficheros que recoge del sistema analizado; como toda adquisicion en vivo, ejecutar la herramienta deja trazas propias e inevitables en el equipo (registros de eventos, Prefetch de PowerShell y una instantanea VSS temporal que se elimina al finalizar)
  • La unica escritura de datos se realiza en el directorio de salida especificado
  • Se crea un Volume Shadow Copy temporal que se elimina automaticamente al finalizar
  • Para leer el registro de usuarios sin sesion activa (Fase 4), la herramienta copia su NTUSER.DAT (con sus ficheros .LOG1/.LOG2) a la carpeta de salida y monta esa copia de trabajo bajo HKEY_USERS\MAPE_<usuario>; el fichero original nunca se monta (desde v1.7.5). Al terminar la fase se desmonta y la copia de trabajo se borra. Desde v1.7.1, si el desmontaje llegase a fallar tras 3 reintentos, la herramienta lo señala de forma explicita y visible en consola (ver "Resolucion de Problemas") en vez de dejarlo pasar desapercibido.
  • No se realizan conexiones de red por parte de la herramienta
  • Todas las evidencias se verifican mediante hash SHA-256; desde v1.7.1 un hash que no pueda calcularse queda marcado explicitamente como invalido en la cadena de custodia, en vez de registrarse sin distinguir
  • El script calcula su propio hash para garantizar su integridad

Alcance de la Evaluacion Automatica

MaPeriT.SW incluye un motor de deteccion automatica de anomalias que categoriza indicadores por severidad (CRITICA, ALTA, MEDIA, BAJA). Dicha evaluacion es de caracter orientativo y preliminar. Los indicadores detectados automaticamente:

  • No constituyen por si solos una conclusion pericial
  • Pueden generar falsos positivos en funcion de la configuracion del sistema analizado
  • Deben ser validados, contextualizados e interpretados por el perito firmante
  • No implican la existencia de actividad ilicita; pueden tener explicacion legitima

La responsabilidad sobre las conclusiones del informe recae exclusivamente en el perito informatico que lo suscribe. MaPeriT.SW es una herramienta de apoyo tecnico, no un sustituto del criterio profesional del perito.

Valores Configurables por Defecto

ParametroValorDescripcion
LargeFileThresholdMB500Umbral para considerar un fichero como "grande"
PhaseTimeoutMinutes10Timeout general por fase
ADSScanTimeoutSec120Timeout para escaneo de Alternate Data Streams
SignatureScanTimeout300Timeout para verificacion de firmas digitales
MaxEventsPerQuery50.000Maximo de eventos por consulta de Event Log
HashAlgorithmSHA256Algoritmo de hashing para evidencias

MaPeriT.SW — Herramienta de Peritacion Informatica Forense Profesional v1.7.5

26 modulos | Compilado como MaPeriT.SW.ps1

Manual actualizado el 12/07/2026