Saltar al contenido principal

Parámetros y flags

El comando reveal necesita recibir al menos un nombre de archivo o directorio donde realizar la búsqueda. Si ejecutamos el comando sin indicar eso, nos va a mostrar la lista de parámetros y flags disponibles junto a un resumen de lo que representa cada uno de ellos.

$ reveal
usage: reveal [<flags>] [<path>...]

A command-line application to find potential PAN numbers in files and directories.

Flags:
      --help              Show context-sensitive help (also try --help-long and --help-man).
  -v, --verbose           Add verbosity to the output
  -l, --pan-length=0      BIN length to consider (must be 16 or 19, or 0 for both)
  -b, --bin-length=6      Minimum BIN length to consider (0 to 8) - Default: 6
  -d, --delimited         Only consider PANs that are delimited by non numeric characters
  -p, --print             Print the lines containing possible PANs
  -P, --print-extended    Print the lines containing possible PANs with context (like -p -c)
  -s, --summary           Show a summary of findings on each file
  -S, --summary-extended  Show a summary of findings on each file with more information
  -t, --totals            Only display summary totals when processing sevaral files
  -c, --condensed         Print results in a condensed format (like a table) This is the default output format
      --paranoid          Consider all possible card numbers (ignoring BIN lists, just check Luhn)
      --distance=50       Confidence distance, is the max distance between keywords and the PAN (default: 50)
      --parallel          Perform search in parallel (optimized search with several files)
  -i, --interactive       Process results interactively in a TUI
      --nowhitelist       Do not use a whitelist file even if it exists
  -x, --export            Exports the results as an Excel file
  -e, --excel             Include Excel files in the search
  -E, --ignore            Exclude Excel files in the search when using the --massive option
  -w, --write             Write findings to a file
  -m, --massive           Perform a MASSIVE search, for huge volumes of files
      --limit=LIMIT       Limit the number of parallel processes. Default is the number of processors. It can be even a greater value
      --xmax=XMAX         Max size for Excel files to process in Mb (default 10)

Args:
  [<path>]  Files or directories to process.

A continuación veremos la lista de parámetros y flags junto a una breve descripción de cada uno. Para obtener información detallada de cada uno por favor referirse a la sección correspondiente.

file / path​

Lo primero que debemos indicar es al menos un nombre de archivo donde realizar la búsqueda, o un directorio donde realizarla. Podemos inidicar solo un nombre o una lista

--help​

Nos muestra esta pantalla de ayuda que es la misma que se muestra cuando no indicamos una ubicación a buscar

--verbose (-v)​

En la mayoría de los casos se muestra más información en la salida del comando

--pan-length (-l)​

Nos permite indicar si queremos considerar solamente valores de PAN de longitudes 16, 19, o ambos

--bin-length (-b)​

Podemos indicar la longitud mínima del BIN a considerar, por defecto 6. Si colocamos por ejemplo 8, vamos a estar siendo mas específicos en los BINes que tomaremos en cuenta

--delimited (-d)​

Solo vamos a considerar valores de tarjetas que estén delimitados por caracteres no numéricos

--print (-p)​

Vamos a mostrar en la salida el contenido de las líneas que contienen el número de tarjeta

--print-extended (-P)​

Vamos a mostrar en la salida no solo la línea que contiene el número encontrado, sino también el contexto

--summary (-s)​

Agrega un resumen de los valores encontrados al final de cada archivo procesado

--summary-extended (-S)​

Muestra un resumen conteniendo mas información sobre los datos encontrados al final de cada archivo procesado

--totals (-t)​

Muestra solamente los totales cuando se procesan múltiples archivos

--condensed (-c)​

Muestra los resultados en una forma compacta (en forma de tabla). Este es el formato de salida por defecto

--paranoid​

Se consideran todos los números posibles de tarjeta, ignorando las listas de BINes (solo se hace el chequeo Luhn)

--distance=​

Es la distancia máxima a considerar entre palabras clave y el posible número (en caracteres) para evaluar el nivel de confidencia

--paralel​

Fuerza el procesamiento en paralelo para reducir los tiempos cuando se procesan múltiples archivos

--interactive (-i)​

Una vez obtenidos los resultados, se muestra una pantalla interactiva (TUI) para poder navegar entre ellos

--nowhitelist​

Se ignora la presencia del archivo conteniendo la "lista blanca" aunque dicho archivo esté presente

--export (-x)​

Exporta los resultados como un archivo de Excel

--excel (-e)​

Incluye archivos de Excel en la búsqueda

--ignore (-E)​

Ignora los archivos de Excel cuando se utiliza la opción --massive

--write (-w)​

Escribe los resultados de la búsqueda en un archivo

--massive (-m)​

Realiza la búsqueda en forma masiva, procesando archivos en paralelo. Es útil para procesar cantidades grandes de archivos

--limit=​

Cuando se usa el procesamiento paralelo, se puede limitar la cantidad de procesos que se ejecutan en simultáneo. En defecto este valor es igual al número de procesadores disponible

--xmax=​

El procesamiento de archivos de Excel es lento y puede agotar la memoria disponible, por lo que podemos limitar el tamaño máximo de los archivos de Excel que vamos a procesar (en Mb, por defecto se asume 10Mb)