Iniciar o carregamento de ficheiros - API de deteção da cloud

Artigo
11/28/2024

Execute o pedido GET para iniciar o processo de carregamento. Esta chamada, a primeira das três, devolve um URL que será mais tarde utilizado para executar o pedido de carregamento (PUT).

Solicitação HTTP

GET /api/v1/discovery/upload_url/

Pedir parâmetros de URL

Parâmetro	Descrição
filename	Nome do ficheiro que pretende carregar para o processamento da cloud Discovery
source	O tipo de ficheiro de registo da cloud Discovery a ser carregado

Os seguintes tipos de origem são atualmente suportados:

BLUECOAT
BARRACUDA
BARRACUDA_NEXT_GEN_FW
BARRACUDA_NEXT_GEN_FW_WEBLOG
BARRACUDA_SYSLOG
BLUECOAT_SYSLOG
PONTO DE VERIFICAÇÃO
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
LULAS
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

Observação

Ao utilizar um analisador personalizado, Defender para Aplicativos de Nuvem utilizará o analisador personalizado anexado à origem de dados selecionada.
Se não conseguir encontrar o formato de ficheiro, execute um carregamento manual com o portal.

Parâmetros de resposta

Parâmetro	Descrição
url	O URL de destino que irá efetuar o carregamento da cloud Discovery.
fornecedor	"azure" ou "aws", uma indicação de que o carregamento é direcionado para o Armazenamento do Microsoft Azure e o armazenamento do AWS S3.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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"

Resposta

Eis um exemplo da resposta JSON.

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

Se tiver algum problema, estamos aqui para ajudar. Para obter assistência ou suporte para o problema do produto, abra um pedido de suporte.

Compartilhar via