El objetivo de Reputator
es simple: comprobar la reputación de un bloque de hashes, IPs o dominios en VirusTotal
y devolver los resultados en una tabla.
La idea original surge de la herramienta Malwoverview
(mucho más completa y a años luz de lo que tienes delante, ¡revísala!) simplificando a un solo sitio, VirusTotal, y que pudiera ser ejecutado sin necesidad de dependencias de Phyton
y sin tener que levantar un sistema virtual con Remnux
para comprobar la reputación de unos cuantos hashes.
Posteriormente, en la versión 2, se ha incluido el sitio Hybrid-Analysis
para comprobar la reputación de los hashes, mostrándose el resultado en una nueva columna en la tabla.
Ejecutar reputator.ps1
con una de las siguientes opciones
-h
para indicar que se le va a proporcionar un listado de hashes.-i
para indicar que se le va a proporcionar un listado de direcciones IP.-d
para indicar que se le va a proporcionar un listado de dominios.-help
: Para mostrar la ayuda.
- Disponer de una API de
VirusTotal
. - Disponer de una API de
Hybrid-Analysis
. - Modificar el script con la ruta donde tengamos el fichero de texto con los elementos que se quieran comprobar o bien indicarla en la ejecución del script. Por ejemplo:
.\reputator.ps1 -h -hashFile "C:\ruta\a\hashes.txt"
.\reputator.ps1 -i -ipFile "C:\ruta\a\ips.txt"
.\reputator.ps1 -d -domainFile "C:\ruta\a\domains.txt"
- Disponer del módulo PSWriteColor:
Install-Module -Name PSWriteColor -Force
.
A continuación, ejemplos de ejecución de Reputator
:
- Comprobación de hashes.
C:\Users\test\Desktop>powershell.exe ./reputator.ps1 -h
MUESTRA HASH VT NOMBRE VT DETECCIONES VT PRIMER ANALISIS VT ULTIMO ANALISIS HYBRID-ANALYSIS
------- ---- --------- -------------- ------------------ ------------------ ---------------
Hash_1 00000075d77e227cdb2d386181e42f42b579eb16403143dc54cd4a3d17fc8622 lhgew.exe 65 2015-05-15 18:42:36 2023-10-01 05:22:31 malicious
Hash_2 0d7b9f1850db74b66b0b89af6ae89368600541f6bbfbbb2f6fed32ec44839699 deoakoy.exe 62 2015-05-30 11:00:25 2023-05-10 19:35:26 malicious
Hash_3 B99D61D874728EDC0918CA0EB10EAB93D381E7367E377406E65963366C874450 N/A N/A N/A N/A N/A
Hash_4 dcf5d6debde2d07ac911a86a68167dd44b538ee31eb66a48726a5b7327a2a7cc leifoi.exe 50 2015-12-25 11:16:38 2015-12-28 06:25:32 N/A
- Comprobación de IPs.
C:\Users\test\Desktop>powershell.exe ./reputator.ps1 -i
MUESTRA IP PAIS AV DETECCIONES VT PRIMER ANALISIS VT ULTIMO ANALISIS
------- -- ---- -------------- ------------------ ------------------
IP_1 45.133.5.148 AU 0 N/A N/A
IP_2 45.133.5.149 AU 0 N/A 2023-03-31 14:12:34
IP_3 45.133.5.143 AU 0 N/A N/A
IP_4 45.133.5.115 AU 0 N/A N/A
IP_5 35.205.61.67 BE 4 N/A 2023-08-01 01:19:58
IP_6 191.101.130.67 US 0 N/A N/A
IP_7 45.133.5.106 AU 0 N/A N/A
IP_8 45.133.5.145 AU 0 N/A 2023-04-05 14:57:06
IP_9 45.133.5.147 AU 0 N/A N/A
IP_10 107.180.173.9 US 0 N/A 2023-07-14 13:14:28
IP_11 23.216.147.76 US 1 N/A 2023-08-01 00:01:28
- Comprobación de dominios.
C:\Users\test\Desktop>powershell.exe ./reputator.ps1 -d
MUESTRA DOMINIO VT DETECCIONES VT CREACION DOMINIO VT ULTIMO ANALISIS
------- ------- -------------- ------------------- ------------------
Domain_1 finformservice.com 18 2023-06-28 00:00:00 2023-07-27 20:15:13
Domain_2 altimata.org 12 2023-05-18 00:00:00 2023-07-20 15:47:36
Domain_3 penofach.com 12 2023-05-18 00:00:00 2023-07-20 15:47:36
Domain_4 bentaxworld.com 13 2023-05-16 00:00:00 2023-07-20 18:45:13
Domain_5 wexonlake.com 20 2023-05-01 00:00:00 2023-07-27 11:01:18
Domain_6 ukrainianworldcongress.info 19 2023-06-26 00:00:00 2023-07-31 01:10:21
Domain_7 marca.com 0 1997-03-12 05:00:00 2023-08-01 02:14:13
Crear una variable de entorno para ejecutar el script desde cualquier ubicación de cmd o powershell
-
Abre el menú de Inicio y busca "Editar las variables de entorno del sistema". Haz clic en el resultado que dice "Editar las variables de entorno del sistema".
-
Se abrirá una ventana de "Propiedades del sistema". Haz clic en el botón "Variables de entorno" en la parte inferior de la ventana.
-
En la sección "Variables del sistema", busca la variable llamada "Path" y selecciónala. Luego, haz clic en el botón "Editar".
-
Aparecerá una nueva ventana llamada "Editar variable del sistema". Haz clic en "Nuevo" para agregar una nueva ruta.
-
Escribe la ruta completa del directorio que contiene
reputator.ps1
. Luego, haz clic en "Aceptar" para cerrar todas las ventanas. -
Asegúrate de abrir una nueva ventana del símbolo del sistema (cmd) después de hacer estos cambios, ya que los cambios en las variables de entorno no se aplicarán a las ventanas de cmd ya abiertas.
Alternativa:
setx PATH "%PATH%;C:\tu\ruta\scripts" /M
Versión 2.3
Esta versión incluye:
* Se ha implementado la validación de entradas para hashes, direcciones IP y dominios antes de procesarlas.
* Se ha añadido la funcionalidad de mostrar las detecciones en colores:
* Rojo para detecciones maliciosas.
* Verde para ausencia de detecciones.
* Se permite la configuración de las rutas de los archivos de entrada mediante parámetros.
Versión 2.2
Esta versión incluye:
* Se añade una columna "VT NOMBRE" para la consulta de hashes para añadir el nombre de cada hash según VirusTotal.
Versión 2.1
Esta versión incluye:
* Soluciona el problema de errores cuando el hash no existe en VirusTotal
Versión 2.0
Esta versión incluye:
* Consulta la reputación de hashes en Hybrid-Analysis.
* Mensaje de error en caso de ejecución incorrecta.
* Mensaje de ayuda.
* Color para las detecciones maliciosas.
Versión 1.0
Reputator es una herramienta de consulta de reputación de IOCs en VirusTotal.
* Consulta una lista de hashes en VT obteniendo su veredicto, fecha de primer scan y fecha de último scan.
* Consulta una lista de direcciones IP en VT obteniendo su veredicto, país, fecha de primer scan y fecha de último scan.
* Consulta una lista de dominios VT obteniendo su veredicto, fecha de primer scan y fecha de último scan.