Inicio de la carga de archivos: API de detección de nube

Artículo
11/28/2024

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
filename	Nombre del archivo que desea cargar en el procesamiento de la detección en la nube
source	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
PUNTO DE CONTROL
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 la detección en la nube.
proveedor	"azure" o "aws", una indicación de si la carga está destinada a Windows Azure Storage y al almacenamiento de AWS S3.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

Respuesta

Este es un ejemplo de la respuesta JSON.

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

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

Compartir a través de