Información general

El Inventario de seguridad de la API monitoriza el tráfico de tu API para proporcionar visibilidad de la postura de seguridad de tus API, incluyendo:

  • Autenticación: Tipo de autenticación utilizada, como autorización básica y mediante clave de API.
  • Exposición pública: Si la API procesa tráfico de Internet.
  • Estado de producción: Si la API se está ejecutando en un entorno de producción.
  • Flujos de datos confidenciales: Datos confidenciales gestionados por la API y flujos entre las API.
  • Exposición a ataques: Si el endpoint es objetivo de ataques (con la tecnología de la Gestión de amenazas a aplicaciones).
  • Vulnerabilidades: Si el endpoint contiene una vulnerabilidad (con la tecnología del Análisis de la composición del software).

Con el Inventario de seguridad de la API puedes:

  • Observar rápidamente tus endpoints expuestos públicamente que no requieren solicitudes autenticadas.
  • Observar rápidamente tus endpoints expuestos públicamente que gestionan datos confidenciales, como números de tarjetas de pago.
  • Ver qué endpoints están en riesgo y pasar directamente al servicio de Monitorización y protección contra amenazas para una mejor investigación o respuesta.
Página principal del Inventario de seguridad de la API

Configuración

Las siguientes versiones de biblioteca son compatible con el Inventario de seguridad de la API. Se requiere la configuración remota.

TecnologíaVersión mínimaCompatibilidad con el análisis de datos confidenciales
Pythonv2.1.6Solicitudes y respuestas
Javav1.31.0Sólo solicitudes
PHPv0.98.0Solicitudes y respuestas
.NET Corev2.42.0Solicitudes y respuestas
.NET Fxv2.47.0Solicitudes y respuestas
Rubyv1.15.0Sólo solicitudes
Golangv1.59.0Sólo solicitudes
Node.jsv3.51.0, v4.30.0 o v5.6.0Solicitudes y respuestas

Cómo funciona

El inventario de la API aprovecha la biblioteca de rastreo de Datadog con ASM habilitado para recopilar metadatos de seguridad sobre el tráfico de la API, incluido el esquema de la API, los tipos de datos confidenciales procesados y el esquema de autenticación.

El Inventario de seguridad de la API utiliza la configuración remota para gestionar y configurar reglas de análisis que detectan datos confidenciales y autenticaciones.

En cada endpoint se calculan los siguientes riesgos:

Servicio en producción

La etiqueta (tag) env se comprueba en busca de patrones que representen con frecuencia entornos de no producción. Por ejemplo, si detecta valores de dev, alpha, beta, sandbox, o similares, marca el entorno como de no producción. Todos los demás entornos se marcan como de producción.

Servicio bajo ataque

Este riesgo se detecta en los endpoints de API que han sufrido ataques en la última semana.

Procesamiento de datos confidenciales

ASM busca patrones conocidos de datos confidenciales en las solicitudes de API. Si encuentra una coincidencia, el endpoint se etiqueta con el tipo de dato confidencial procesado.

La coincidencia se produce dentro de tu aplicación y no se envía ningún dato confidencial a Datadog.

Tipos de datos compatibles

CategoríaFaceta de categoríaFaceta de tipo
Números de la seguridad social de Canadápiicanadian_sin
Números de la seguridad social de Estados Unidospiius_ssn
Números de la seguridad social del Reino Unidopiiuk_nin
Números de identificación de vehículos de EE. UU.piivin
Números de pasaportepiipassport_number
Direcciones de correo electrónicopiiemail
Token web JSON (JWT)credentialsjson_web_token
Tokens de portador (se encuentran en las cabeceras Authorization )credentialsbearer_token
Número de tarjeta American Expresspaymentcard
Número de tarjeta Diners Clubpaymentcard
Número de tarjeta JCBpaymentcard
Número de tarjeta Maestropaymentcard
Número de tarjeta Mastercardpaymentcard
Número de tarjeta VISApaymentcard
Número de cuenta bancaria IBANpaymentiban

Acceso público

Datadog marca un endpoint como público si la dirección IP del cliente está fuera de estos rangos:

  • 10.0.0.0/8
  • 172.16.0.0/12
  • 192.168.0.0/16
  • 169.254.1.0/16

Para obtener más información sobre la configuración de biblioteca requerida, consulta Configuración de una cabecera IP de cliente.

Endpoint no autenticado

La autenticación es determinada por:

  • La presencia de las cabeceras Authorization, Token o X-Api-Key.
  • La presencia de un ID de usuario en la traza (trace) (por ejemplo, el atributo @usr.id de APM).
  • La solicitud ha respondido con un código de estado 401 o 403.

Contiene vulnerabilidades explotables

Este riesgo se determina mediante el Análisis de la composición del software para el servicio que aloja el endpoint.

Impacto en el rendimiento

Por defecto, el Inventario de seguridad de la API evalúa una de cada diez solicitudes (frecuencia de muestreo del 10%).

Referencias adicionales

Additional helpful documentation, links, and articles: