اتصالات

استيعاب المزود الخارجي

ادفع نتائج الموفر إلى BlackShield دون منح BlackShield بيانات اعتماد سحابية طويلة الأمد.

مقدم الملحد

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.

التكوين

  • قم بإنشاء مفتاح API باستخدام ingest:external_findings.
  • نشر النتائج المحايدة لمزود الخدمة إلى /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

بالإضافة إلى عمليات التصدير المجدولة التي يقوم بها الموفر، يمكن لأنظمة SIEM الخارجية (Splunk وDatadog وElastic وMicrosoft Sentinel) دفق التنبيهات الأولية أو المرتبطة مباشرة إلى BlackShield عبر 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 Accepted و IngestionJobAcceptedResponse ظرف. يقوم العاملون في الخلفية بتطبيع التنبيهات في نتائج موحدة وربطها بالأصول الموجودة.

فحوصات النجاح

  • تقوم نقطة النهاية بإرجاع 202 مع معرف مهمة العرض.
  • تكتمل المهمة بالنتائج التي تم إنشاؤها أو تحديثها.
  • يمكن أن تكون المهمة الموجودة في قائمة الانتظار في انتظار الاسترداد التلقائي. تقوم BlackShield بإعادة محاولة حالات الفشل القابلة للاسترداد لمدة تصل إلى 24 ساعة. احتفظ بمعرف الوظيفة الأصلي لمتابعة نتائجه.
  • إعادة محاولة تسليم الإشعارات بشكل مستقل: لا يؤدي الرد التلقائي على الويب إلى التراجع عن النتائج المحفوظة. تظهر المهام الفاشلة خطأً نهائيًا؛ تحتفظ BlackShield بأدلة الحجر الصحي لمدة 90 يومًا حتى يتمكن المشغلون من التحقيق.
  • تعرض بطاقة الموفر في Connections الحداثة الحديثة لمثيل الموصل.
  • يتضمن مصدر البحث الموفر ومثيل الموصل وعنوان URL المصدر ومصدر الحمولة الأولية.
استيعاب المزود الخارجي