Tiedoston lataamisen aloittaminen – pilvietsintä-ohjelmointirajapinta
Käynnistä latausprosessi suorittamalla GET-pyyntö. Tämä kutsu, joka on ensimmäinen kolmesta, palauttaa URL-osoitteen, jota käytetään myöhemmin latauspyynnön (PUT) suorittamiseen.
HTTP-pyyntö
GET /api/v1/discovery/upload_url/
Pyynnön URL-parametrit
| Parametri | Kuvaus |
|---|---|
| tiedostonimi | Sen tiedoston nimi, jonka haluat ladata pilvitietojen etsinnän käsittelyyn |
| lähde | Ladattavan pilven etsintälokitiedoston tyyppi |
Seuraavia lähdetyyppejä tuetaan tällä hetkellä:
- SINITAKKINEN
- BARRAKUDA
- BARRACUDA_NEXT_GEN_FW
- BARRACUDA_NEXT_GEN_FW_WEBLOG
- BARRACUDA_SYSLOG
- BLUECOAT_SYSLOG
- TARKISTUSPISTE
- 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
- KALMARI
- 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
Huomautus
- Kun käytät mukautettua jäsennintä, Defender for Cloud Apps käyttää valittuun tietolähteeseen liitettyä mukautettua jäsennintä.
- Jos et löydä tiedostomuotoasi, suorita manuaalinen lataus portaalissa.
Vastausparametrit
| Parametri | Kuvaus |
|---|---|
| URL | Kohde-URL-osoite, joka suorittaa pilvilöydöslatauksen. |
| toimittaja | Joko "azure" tai "aws", mikä ilmaisee, onko lataus kohde Windows Azure Storagen ja AWS S3 -tallennustilaan. |
Esimerkki
Pyytää
Tässä on esimerkki pyynnöstä.
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"
Vastaus
Tässä on esimerkki JSON-vastauksesta.
{
"url": "https://<initiate_file_upload_response_url>",
"provider": "azure"
}
Jos kohtaat ongelmia, olemme täällä auttamassa. Jos haluat apua tai tukea tuoteongelmaasi varten, avaa tukipyyntö.