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.