Inteligencia de riesgo telco en tiempo real

¿Qué es RISKNET?

RISKNET es un motor de scoring que consulta señales telco (Open Gateway) como SIM Swap, Device Status, Number Verification y Device Swap, las normaliza y calcula un score 0–100 con pesos configurables. Expone un endpoint REST para integrarse a onboarding, login, transacciones y antifraude, y suma un portal multi-tenant para que las áreas de riesgo monitoricen KPIs, SLA y señalización en tiempo real.

Arquitectura del Sistema y Flujo de Transacción

Desde el usuario final, una transacción se valida pasando por el Banco/App, el **RISKNET Engine** y las **APIs Open Gateway** de Telefónica, para devolver un score de riesgo en tiempo real y asegurar la operación.

Ejemplo de integración (REST)

POST /api/risk-eval.php
Content-Type: application/json

{
  "msisdn": "+541122358032",
  "country": "AR",
  "signalsEnabled": ["simSwap","deviceStatus","deviceSwap","lineVerified"],
  "signalWeights": { "simSwap": 40, "deviceStatus": 20, "deviceSwap": 20, "lineVerified": 20 }
}
        

Características técnicas clave

• ✅ Autenticación OIDC (Client ID + Secret) con cacheo automático del token.
• ⚡ Paralelismo de señales con control de latencia y fallback inteligente.
• 🧠 Scoring modular configurable (ponderación y activación de señales).
• 🔄 Cobertura de señales core: SIM Swap, Device Status, Device Swap y Number Verification.
• 📊 Logging estructurado y trazabilidad en JSON.

Cómo se calcula el Score

El motor convierte cada señal en una probabilidad de riesgo pi (0..1), normaliza los pesos wi de las señales activas y agrega por media geométrica ponderada. El resultado se expresa en 0..100.

αᵢ = wᵢ / Σⱼ wⱼ          (solo señales activas)
FraudProb = 1 - Πᵢ (1 - pᵢ)^(αᵢ)
riskScore = round(100 × FraudProb, 2)

Clasificación:
- low     si riskScore < 33
- medium  si 33 ≤ riskScore < 67
- high    si riskScore ≥ 67
    

Ejemplo: weights = {simSwap: 40, deviceStatus: 20, deviceSwap: 20, lineVerified: 20}
Σw = 100  →  α = {0.40, 0.20, 0.20, 0.20}
    

{
  "riskScore": 74.54,
  "riskLevel": "high",
  "signals": { "...valores crudos por señal..." },
  "signalProbabilities": { "simSwap": 0.90, "deviceStatus": 0.20, "deviceSwap": 0.85, "kycMatch": 0.45, ... },
  "signalWeights": { "simSwap": 30, "deviceSwap": 20, "kycMatch": 20, ... },
  "weightNormalized": { "simSwap": 0.40, "deviceSwap": 0.20, ... },
  "fraudProbability": 0.7454
}
    

Esta sección documenta exactamente lo que implementa el backend (compute_weighted_score()), por lo que el Gauge debe leer riskScore y el texto de nivel riskLevel del API sin recalcular.