Configuración de la integración de la API de Microsoft Graph con SecureX

Introducción

Este documento describe el procedimiento para integrar la API de Microsoft Graph con SecureX, y el tipo de datos que se pueden consultar.

Prerequisites

• Cuenta de administrador de SecureX
• Cuenta de administrador del sistema de Microsoft Azure
• Acceso a SecureX Threat Response

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Pasos de integración

Paso 1.

Inicie sesión en Microsoft Azure como administrador del sistema.

Paso 2.

Haga clic en App Registrations en el portal de servicios de Azure.

Paso 3.

Haga clic en New registration.

Paso 4.

Escriba un nombre para identificar su nueva aplicación.

En Tipos de cuenta admitidos, elija la opción Accounts in this organizational directory only.

Paso 5.

Desplácese hasta la parte inferior de la pantalla y haga clic en Register.

Paso 6.

Vuelva a la página de servicios de Azure y haga clic en App Registrations > Owned Applications.

Identifique su aplicación y haga clic en el nombre. En este ejemplo, es SecureX.

Paso 7.

Aparecerá un resumen de su aplicación. Identifique estos datos relevantes:

ID de aplicación (cliente):

Directorio ID (arrendatario):

Paso 8.

Desplácese hasta Manage Menu > API Permissions.

Paso 9.

En Permisos configurados, haga clic en Add a Permission.

Paso 10.

En la sección Solicitar permisos de API, haga clic en Microsoft Graph.

Paso 11.

Seleccionar Application permissions.

En la barra de búsqueda, busque Security. Expandir Security Actions y seleccione

• Leer.Todo
• ReadWrite.All

• Eventos de seguridad y seleccione
  • Leer.Todo
  • ReadWrite.All
• Indicadores de amenazas y seleccione
  • ThreatIndicators.ReadWrite.OwnedBy

Haga clic en Add permissions.

Paso 12.

Revise los permisos seleccionados.

Haga clic en Grant Admin consent para su organización.

Aparecerá un mensaje que le preguntará si desea conceder el consentimiento para todos los permisos. Haga clic en Yes.

Aparece una ventana emergente similar a la mostrada en esta imagen:

Paso 13.

Desplácese hasta Manage > Certificates & Secrets.

Haga clic en Add New Client Secret.

Escriba una breve descripción y seleccione una Expires fecha. Se recomienda seleccionar una fecha de validez de más de 6 meses para evitar la caducidad de las claves API.

Una vez creada, copie y guarde en un lugar seguro la parte que dice Value, ya que se utiliza para la integración.

Cuando tenga toda la información, vuelva a la página Overview y copie los valores de su aplicación. A continuación, vaya a SecureX.

Paso 14.

Desplácese hasta Integration Modules > Available Integration Modules > seleccionar Microsoft Security Graph API, haga clic en Add.

Asigne un nombre y pegue los valores obtenidos en el portal de Azure.

Haga clic en Save y esperar a que la comprobación de estado se realice correctamente.

Realizar investigaciones

A partir de ahora, la API de Microsoft Security Graph no rellena el panel de SecureX con un mosaico. Más bien, la información de su portal de Azure se puede consultar con el uso de Investigaciones.

Tenga en cuenta que la API de Graph sólo se puede consultar para:

• ip
• domain
• nombre del host
• url
• file_name
• file_path
• sha256

En este ejemplo, la investigación utilizó este SHA c73d01ffb427e5b7008003b4eaf9303c1febd883100bf81752ba71f41c701148.

Como puede ver, tiene 0 avistamientos en el entorno de laboratorio, así que ¿cómo probar si Graph API funciona?

Abra WebDeveloper Tools, ejecute la investigación, busque un evento Post en visibility.amp.cisco.com, el archivo llamado Observables.

Verificación

Puede utilizar este enlace: Instantáneas de seguridad gráfica de Microsoft para obtener una lista de Instantáneas que le ayudarán a entender la respuesta que puede obtener de cada tipo de observable.

Puede ver un ejemplo como se muestra en esta imagen:

Expanda la ventana, puede ver la información proporcionada por la integración:

Tenga en cuenta que los datos deben existir en el portal de Azure y que la API de Graph funciona mejor cuando se utiliza con otras soluciones de Microsoft. Sin embargo, debe ser validado por el Soporte técnico de Microsoft.

Para obtener referencia sobre el alcance del TAC, consulte este documento: Verifique el alcance de soporte para securex.

Troubleshoot

• Mensaje de error de autorización:
  • Asegúrese de que los valores de Tenant ID y Client ID son correctas y que siguen siendo válidas.

• No se muestran datos en la investigación:
  • Asegúrese de copiar y pegar los valores adecuados para Tenant ID y Client ID.
  • Asegúrese de utilizar la información del campo Value desde Certificates & Secrets sección.
  • Utilice las herramientas de WebDeveloper para determinar si se consulta la API de Graph cuando se produce una investigación.
  • A medida que la API de Graph combina datos de varios proveedores de alertas de Microsoft, asegúrese de que OData es compatible con los filtros de consulta. (Por ejemplo, Seguridad y cumplimiento de Office 365 y ATP de Microsoft Defender).