Initiieren des Dateiuploads – Cloud Discovery-API

Artikel
11/28/2024

Führen Sie die GET-Anforderung aus, um den Uploadprozess zu initiieren. Dieser Aufruf, der erste der drei, gibt eine URL zurück, die später zum Ausführen der Uploadanforderung (PUT) verwendet wird.

HTTP-Anforderung

GET /api/v1/discovery/upload_url/

Anforderungs-URL-Parameter

Parameter	Beschreibung
filename	Name der Datei, die Sie in die Cloud Discovery-Verarbeitung hochladen möchten
source	Der Typ der hochzuladenden Cloud Discovery-Protokolldatei.

Die folgenden Quelltypen werden derzeit unterstützt:

BLUECOAT
BARRACUDA
BARRACUDA_NEXT_GEN_FW
BARRACUDA_NEXT_GEN_FW_WEBLOG
BARRACUDA_SYSLOG
BLUECOAT_SYSLOG
KONTROLLPUNKT
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
TINTENFISCH
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

Hinweis

Bei Verwendung eines benutzerdefinierten Parsers verwenden Defender for Cloud Apps den benutzerdefinierten Parser, der an die ausgewählte Datenquelle angefügt ist.
Wenn Sie Ihr Dateiformat nicht finden können, führen Sie einen manuellen Upload über das Portal aus.

Antwortparameter

Parameter	Beschreibung
url	Die Ziel-URL, die Ihren Cloud Discovery-Upload durchführt.
Anbieter	Entweder "azure" oder "aws", ein Hinweis darauf, ob der Upload auf Windows Azure Storage und AWS S3-Speicher ausgerichtet ist.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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"

Antwort

Hier sehen Sie ein Beispiel für die JSON-Antwort.

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

Wenn Probleme auftreten, helfen wir Ihnen gerne weiter. Um Unterstützung oder Support für Ihr Produktproblem zu erhalten, öffnen Sie bitte ein Supportticket.

Freigeben über