Iniciar o upload de ficheiros - Cloud Discovery API

Aplica-se a: Microsoft Cloud App Security

Importante

Os nomes dos produtos de proteção contra ameaças da Microsoft estão a mudar. Leia mais sobre esta e outras atualizações aqui. Vamos atualizar nomes em produtos e nos documentos num futuro próximo.

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

Pedido HTTP

GET /api/v1/discovery/upload_url/

Solicitar parâmetros URL

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

Os seguintes tipos de origem são atualmente suportados:

  • BARRACUDA
  • CASACO AZUL
  • POSTO DE CONTROLO
  • CHECKPOINT_CEF_SYSLOG
  • CHECKPOINT_SMART_VIEW_TRACKER
  • CHECKPOINT_XML
  • CISCO_ASA
  • CISCO_ASA_FIREPOWER
  • CISCO_FIREPOWER_V6_SYSLOG
  • CISCO_FWSM
  • CISCO_IRONPORT_PROXY
  • CISCO_IRONPORT_WSA_II
  • CISCO_SCAN_SAFE
  • CLAVISTER
  • CORRATA
  • CUSTOM_PARSER
  • PONTA-DE-FORÇAS
  • FORCEPOINT_LEEF
  • FORTIGATE
  • GENERIC_CEF
  • GENERIC_LEEF
  • GENERIC_W3C
  • I_FILTER
  • IBOSS
  • JUNIPER_SRX
  • JUNIPER_SRX_SD
  • JUNIPER_SRX_WELF
  • JUNIPER_SSG
  • MACHINE_ZONE_MERAKI
  • MCAFEE_SWG
  • MICROSOFT_ISA_W3C
  • PALO_ALTO
  • PALO_ALTO_LEEF
  • SONICWALL_SYSLOG
  • SOPHOS_CYBEROAM
  • SOPHOS_SG
  • SOPHOS_XG
  • LULA
  • SQUID_NATIVE
  • ESCUDO DE TEMPESTADE
  • WEBSENSE_SIEM_CEF
  • WEBSENSE_V7_5
  • ZSCALER
  • ZSCALER_CEF
  • ZSCALER_QRADAR

Nota

  • Ao utilizar um analisador personalizado, o Cloud App Security utilizará o parser personalizado anexado à fonte de dados selecionada.
  • Se não conseguir encontrar o seu formato de ficheiro, execute um upload manual utilizando o portal.

Parâmetros de resposta

Parâmetro Descrição
url O URL-alvo que irá realizar o upload cloud Discovery.
provedor Ou "azure" ou "aws", uma indicação se o upload é o alvo para o Armazenamento Windows Azure e para o armazenamento AWS S3.

Exemplo

Pedir

Aqui está um exemplo do pedido.

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"

Resposta

Aqui está um exemplo da resposta do 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 seu problema de produto, abra um bilhete de apoio.