Inicio de la carga de archivos: API de Cloud Discovery

Artículo
06/15/2022
Tiempo de lectura: 2 minutos

Nota

Hemos cambiado el nombre de Microsoft Cloud App Security. Ahora se llama Microsoft Defender for Cloud Apps. En las próximas semanas, actualizaremos las capturas de pantalla y las instrucciones aquí y en las páginas relacionadas. Para obtener más información sobre el cambio, consulte este anuncio. Para obtener más información sobre el cambio de nombre reciente de los servicios de seguridad de Microsoft, consulte el blog seguridad de Microsoft Ignite.
Microsoft Defender for Cloud Apps ahora forma parte de Microsoft 365 Defender. El portal de Microsoft 365 Defender permite a los administradores de seguridad realizar sus tareas de seguridad en una ubicación. Esto simplificará los flujos de trabajo y agregará la funcionalidad de los demás servicios Microsoft 365 Defender. Microsoft 365 Defender será el hogar de la supervisión y administración de la seguridad en las identidades, los datos, los dispositivos, las aplicaciones y la infraestructura de Microsoft. Para obtener más información sobre estos cambios, consulte Microsoft Defender for Cloud Apps en Microsoft 365 Defender.

Ejecute la solicitud GET para iniciar el proceso de carga. Esta llamada, la primera de las tres, devuelve una dirección URL que se usará más adelante para realizar la solicitud de carga (PUT).

Solicitud HTTP

GET /api/v1/discovery/upload_url/

Parámetros de dirección URL de solicitud

Parámetro	Descripción
nombreDeArchivo	Nombre del archivo que quiere cargar en el procesamiento de Cloud Discovery
origen	Tipo de archivo de registro de Cloud Discovery que se está cargando

Actualmente se admiten los siguientes tipos de origen:

BLUECOAT
BARRACUDA
BARRACUDA_NEXT_GEN_FW
BARRACUDA_NEXT_GEN_FW_WEBLOG
BARRACUDA_SYSLOG
BLUECOAT_SYSLOG
CHECKPOINT
CHECKPOINT_CEF_SYSLOG
CHECKPOINT_SMART_VIEW_TRACKER
CHECKPOINT_XML
CISCO_ASA
CISCO_ASA_FIREPOWER_SYSLOG
CISCO_ASA_SYSLOG
CISCO_FIREPOWER_V6_SYSLOG
CISCO_FWSM
CISCO_FWSM_SYSLOG
CISCO_IRONPORT_PROXY
CISCO_IRONPORT_PROXY_SYSLOG
CISCO_IRONPORT_WSA_II
CISCO_IRONPORT_WSA_III
CISCO_SCAN_SAFE
CLAVISTER_SYSLOG
CONTENTKEEPER_SYSLOG
CORRATA
FORCEPOINT
FORCEPOINT_LEEF_SYSLOG
FORTIGATE
FORTIGATE_SYSLOG
FORTIOS_SYSLOG
GENERIC_CEF
GENERIC_CEF_SYSLOG
GENERIC_LEEF
GENERIC_LEEF_SYSLOG
GENERIC_W3C
GENERIC_W3C_SYSLOG
I_FILTER
I_FILTER_SYSLOG
IBOSS
JUNIPER_SRX_SD_SYSLOG
JUNIPER_SRX_SYSLOG
JUNIPER_SRX_WELF_SYSLOG
JUNIPER_SSG_SYSLOG
MACHINE_ZONE_MERAKI
MACHINE_ZONE_MERAKI_SYSLOG
MCAFEE_SWG
MCAFEE_SWG_SYSLOG
MENLO_SECURITY_CEF
MICROSOFT_ISA_W3C
OPEN_SYSTEMS_SECURE_WEB_GATEWAY
PALO_ALTO
PALO_ALTO_LEEF
PALO_ALTO_LEEF_SYSLOG
PALO_ALTO_SYSLOG
SONICWALL_SYSLOG
SOPHOS_CYBEROAM_SYSLOG
SOPHOS_SG
SOPHOS_SG_SYSLOG
SOPHOS_XG
SOPHOS_XG_SYSLOG
CALAMAR
SQUID_NATIVE
SQUID_NATIVE_SYSLOG
STORMSHIELD_SYSLOG
WANDERA_SYSLOG
WATCHGUARD_XTM_SYSLOG
WEBSENSE_SIEM_CEF_SYSLOG
WEBSENSE_V7_5
ZSCALER
ZSCALER_CEF_SYSLOG
ZSCALER_QRADAR_SYSLOG
ZSCALER_SYSLOG

Nota

Al usar un analizador personalizado, Defender for Cloud Apps usará el analizador personalizado asociado al origen de datos seleccionado.
Si no encuentra el formato de archivo, realice una carga manual mediante el portal.

Parámetros de respuesta

Parámetro	Descripción
url	Dirección URL de destino que realizará la carga de Cloud Discovery.
provider	"azure" o "aws", una indicación de si la carga está destinadas a Windows Azure Storage y al almacenamiento de AWS S3.

Ejemplo

Solicitud

Este es un ejemplo de la solicitud.

curl -XGET -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.contoso.com/api/v1/discovery/upload_url/?filename=my_discovery_file.txt&source=GENERIC_CEF"

Response

Este es un ejemplo de la respuesta JSON.

{
  "url": "https://<initiate_file_upload_response_url>",
  "provider": "azure"
}

Si surgen problemas, estamos aquí para ayudarle. Para obtener ayuda o soporte técnico para el problema del producto, abra una incidencia de soporte técnico.