प्रदाता अज्ञेयवादी
Use one endpoint for CSPM, CNAPP, endpoint, vulnerability, and SaaS security provider exports.
ग्राहक नियंत्रित
Customers own the webhook, relay, or export job. BlackShield receives normalized findings by API key.
ताजगी का पता लगाया गया
Each connector instance updates setup health after successful ingestion or repeated failures.
विन्यास
- के साथ एक एपीआई कुंजी बनाएं
ingest:external_findings. - POST प्रदाता-तटस्थ निष्कर्ष
/api/v1/ingest/external-findings. - एक अस्तबल का प्रयोग करें
providerऔरconnector_instanceताजगी, डिडुप्लीकेशन और समस्या निवारण के लिए। - मूल प्रदाता ऑब्जेक्ट को सुरक्षित रखें
raw_payloadऑडिट और भविष्य के एडॉप्टर अपग्रेड के लिए।
नमूना पेलोड
{
"provider": "generic",
"connector_instance": "external-prod",
"format": "blackshield_external_v1",
"findings": [
{
"external_id": "provider-finding-001",
"title": "Public storage bucket",
"severity": "high",
"status": "open",
"finding_type": "misconfiguration",
"resource": {
"type": "storage_bucket",
"id": "arn:aws:s3:::customer-data",
"cloud_provider": "aws",
"account_id": "123456789012",
"region": "us-east-1"
},
"source_url": "https://provider.example/findings/001",
"raw_payload": { "provider_object_id": "provider-finding-001" }
}
]
}SIEM & SOC Alert Stream Ingestion
निर्यात खोजने वाले निर्धारित प्रदाता के अलावा, बाहरी एसआईईएम (स्प्लंक, डेटाडॉग, इलास्टिक, माइक्रोसॉफ्ट सेंटिनल) कच्चे या सहसंबद्ध अलर्ट को सीधे ब्लैकशील्ड में स्ट्रीम कर सकते हैं POST /api/v1/ingest/siem:
{
"source": "splunk-es",
"alerts": [
{
"rule_name": "Multiple Failed Logins Followed by Success",
"severity": "high",
"target_user": "admin@example.com",
"source_ip": "198.51.100.42"
}
]
}पेलोड को HTTP 202 स्वीकृत और एक के साथ स्वीकार किया जाता है IngestionJobAcceptedResponse लिफ़ाफ़ा। पृष्ठभूमि कार्यकर्ता अलर्ट को एकीकृत निष्कर्षों में सामान्यीकृत करते हैं और उन्हें मौजूदा परिसंपत्तियों के साथ सहसंबंधित करते हैं।
सफलता की जाँच
- समापन बिंदु अंतर्ग्रहण कार्य आईडी के साथ 202 लौटाता है।
- कार्य निर्मित या अद्यतन निष्कर्षों के साथ पूरा होता है।
- कतारबद्ध कार्य स्वचालित पुनर्प्राप्ति की प्रतीक्षा कर सकता है। ब्लैकशील्ड 24 घंटे तक पुनर्प्राप्त करने योग्य विफलताओं का पुन: प्रयास करता है। इसके परिणाम का अनुसरण करने के लिए मूल कार्य आईडी रखें।
- अधिसूचना वितरण स्वतंत्र रूप से पुनः प्रयास करता है: विलंबित वेबहुक सहेजे गए निष्कर्षों को पूर्ववत नहीं करता है। असफल नौकरियाँ अंतिम त्रुटि दिखाती हैं; ब्लैकशील्ड 90 दिनों के लिए संगरोध साक्ष्य को बरकरार रखता है ताकि ऑपरेटर जांच कर सकें।
- कनेक्शंस में प्रदाता कार्ड कनेक्टर इंस्टेंस के लिए हालिया ताज़ाता दिखाता है।
- खोज स्रोत में प्रदाता, कनेक्टर इंस्टेंस, स्रोत यूआरएल और कच्चा पेलोड उद्गम शामिल है।