ANCI-Kerno: librerías para gestión de riesgos en ciberseguridad
Este paquete implementa una serie de clases y funciones para la gestión de riesgos en ciberseguridad. Actualmente tiene dos clases: HawkesModel y IncidentList.
HawkesModel.py
Esta clase implementa un modelo Hawkes multivariado para la probabilidad instantánea de un conjunto de incidentes, con un kernel gamma para modelar la demora que ocurre entre la ocurrencia de un tipo de incidente y la posible activación de otros tipos de incidentes.
Base matemática
Un modelo Hawkes multivariado implementa tantos modelos Hawkes como tipos de incidentes existen, y define una función de intensidad que representa la probabilidad instantánea de ocurrencia de un tipo de incidente, basado en la historia de ocurrencias de otros incidentes. El valor de la función de intensidad aumenta cuando ocurren otros incidentes, y disminuye exponencialmente hasta llegar a un nivel base.
El modelo Hawkes "tradicional" usa una función de intensidad que aumenta instantáneamente luego de la ocurrencia de otros incidentes. Un modelo con un kernel gamma (o un delay kernel), en cambio, introduce una "demora" entre la ocurrencia de un incidente gatillador y el incidente modelado. Esta demora se utiliza para modelar el hecho de que ningún incidente genera aumentos instantáneos en otros incidentes: la demora depende de cada tipo de incidente, y representa el tiempo que se demoran los atacantes entre el descubrimiento de una vulnerabilidad y su explotación.
Por ejemplo, supongamos que ocurre una filtración de credenciales. Un atacante con acceso a estas credenciales toma un tiempo (desde pocos minutos a varios días) en descubrir cómo utilizar estas credenciales para montar un ataque de (por ejemplo) ransomware. Supongamos que en promedio los atacantes se demoran 14 días en este proceso; el aumento en la intensidad del ransomware llegará a su peak 14 días después de la ocurrencia de la filtración de credenciales.
Un modelo Hawkes, a diferencia de un modelo Poisson, no asume:
- Que la probabilidad de cada tipo de evento es estática;
- Que los tipos de eventos son independientes entre sí (en ciberseguridad, la ocurrencia de algunos tipos de incidente aumentan la probabilidad de ocurrencia de otros tipos).
La fórmula general de un modelo Hawkes multivariado con un kernel gamma es la siguiente:
$$\lambda_i(t) = \mu_i + \sum_{j=1}^M \sum_{t_{j,k} < t} \alpha_{ij} g_{ij}(t - t_{j,k})$$
Donde:
- $M$ es la cantidad de tipos de incidentes distintos;
- $\mu_i$ es la tasa base de ocurrencia de incidentes del tipo $i$; por ejemplo, en el caso del ransomware, es la tasa de ocurrencia aleatoria de ransomware, independiente de las campañas que puedan estar ocurriendo en un momento dado;
- $t_{j,k}$ es el timestamp del evento $k$-ésimo del incidente de tipo $j$.
- $\alpha_{ij}$ representa los coeficientes de la matriz de activación. Cada escalar $\alpha_{ij}$ representa cuánto aumenta el riesgo $i$ debido a un incidente de tipo $j$.
- $g_{ij}(\tau)$ es el kernel gamma. Esta función representa cuánto demora el riesgo $i$ en llegar a su peak debido al incidente de tipo $j$.
La fórmula para el kernel gamma es:
$$g_{ij}(\tau) = \beta_{ij}^2 \tau e^{-\beta_{ij}\tau}$$
Donde $\beta_{ij}$ representa el inverso del tiempo ($1/t$) que transcurre desde la ocurrencia de un incidente gatillador, y el peak del incidente consecuencia.
Métodos de la clase
Esta clase tiene tres métodos:
- El constructor
__init__(), que recibe un objeto JSON con los valores precalculados a utilizar; calculate_delay_kernel(i, j, t_event, t_current), que calcula la función $g_{ij}(\tau)$, dondet_eventes $\tau$, yt_currentes el instante en el que se está calculando la función (por default, el momento actual);calculate_intensity(i, past_events, t_current), que calcula la intensidad $\lambda_i(t)$ del incidente de tipoia partir de la lista de incidentespast_events.
IncidentList.py
Esta clase implementa una lista de incidentes de ciberseguridad, parseando un payload JSON y calculando los deltas de tiempo (tau) relativos a un timestamp ancla inmutable.
Métodos de la clase
Esta clase tiene cuatro métodos:
- El constructor
__init__(), que recibe un objeto JSON con los valores precalculados a utilizar; get_raw_events(self, target_event_type: int | None = None, t_current: float | None = None), que devuelve una lista de eventosget_anchor_time_in_days(self)get_indicator(self, target_event_type: int)
Metadata
Release files for anci-kerno 0.0.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| anci_kerno-0.0.5.tar.gz | 19.5 kB | Without provenance | Details for anci_kerno-0.0.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| anci_kerno-0.0.5-py3-none-any.whl | Python 3 | none | any | Details for anci_kerno-0.0.5-py3-none-any.whl |
Total release size: 30.8 kB
Release files / anci_kerno-0.0.5.tar.gz
| Download URL | anci_kerno-0.0.5.tar.gz |
|---|---|
| Size | 19.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5110cc009617df847e7f1a50a9f84539914c1593d1445f427ef3c704d2e3c43
|
|
BLAKE2b-256 checksum How to use checksums |
a142054a59177d5698acad8c8ee9cb990902e3551c7caa86febb1a6ff6f81fed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / anci_kerno-0.0.5-py3-none-any.whl
| Download URL | anci_kerno-0.0.5-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c126360d9f27790e2414341360e3a1f375b34728f4c02e111d521b3b518af69e
|
|
BLAKE2b-256 checksum How to use checksums |
5005648f5d1c4c3b8b474501521235b85af8c7db669fa0ff158a8b65e1840e35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for anci-kerno 0.0.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.