DepAlert Agent

CTWall

यह उपकरण CTWall प्लेटफ़ॉर्म का हिस्सा है। देखें: CTWall

विवरण

DepAlert आपके CI/CD पाइपलाइन के लिए एक ओपन-सोर्स सुरक्षा गेट है। यह मैलवेयर इंटेलिजेंस डेटा के मुकाबले SBOM का विश्लेषण करता है और जल्दी से बताता है कि आपके बिल्ड में ज्ञात दुर्भावनापूर्ण पैकेज शामिल हैं या नहीं।

DepAlert मुख्य सॉफ्टवेयर आपूर्ति-श्रृंखला समस्याओं का समाधान करता है जो सीधे रिलीज़ की गति, जोखिम और लागत को प्रभावित करती हैं:

• SBOM विश्लेषण को एक स्वचालित CI/CD रिलीज़ गेट में बदलकर मैलवेयर को प्रोडक्शन तक पहुँचने से रोकता है।
• प्रत्येक पाइपलाइन रन में टीमों को तेज़, निर्धारित निर्णय (MALWARE, CLEAN, UNKNOWN) देकर सुरक्षा अड़चनों को कम करता है।
• एक सुसंगत नीति मॉडल (fail-on) और ऑडिट योग्य अपवाद कार्यप्रवाह के साथ टीमों में जोखिम निर्णयों को मानकीकृत करता है।
• परिनियोजन से पहले, बाद में नहीं, प्रोजेक्ट-स्कोप्ड जाँचों को लागू करके घटना और अनुपालन जोखिम को कम करता है।
• मैन्युअल सुरक्षा हैंडऑफ़ को एक CLI चरण से बदलकर डेवलपर उत्पादकता में सुधार करता है जिसे किसी भी पाइपलाइन में पुनः उपयोग किया जा सकता है।

त्वरित आरंभ

चरण-दर-चरण निर्देशों के लिए 00_quick_start.md देखें।

उपकरण का उद्देश्य

depalert एक CI/CD CLI है जो:

1. SBOM को CTWall पर अपलोड करता है (POST /api/v1/ingest)
2. संशोधन निर्णय के लिए समकालिक रूप से प्रतीक्षा करता है (GET /api/v1/tests/{testId}/revisions/{revisionId}/depalert-verdict)
3. पाइपलाइन-अनुकूल परिणाम और एक्ज़िट कोड लौटाता है

उपकरण प्रोजेक्ट-स्कोप्ड है। आप लक्ष्य प्रोजेक्ट का चयन कर सकते हैं:

• project-id (UUID), या
• project-name (API के माध्यम से हल किया गया)।

यदि दोनों प्रदान किए जाते हैं, तो project-id को प्राथमिकता दी जाती है।

डेपअलर्ट परिणाम

DepAlert एक संशोधन परिणाम लौटाता है:

• CLEAN - कोई मैलवेयर खोज नहीं मिली - exit 0
• MALWARE - संशोधन में कम से कम एक मैलवेयर खोज पाई गई - exit 1
• UNKNOWN - विश्लेषण अभी पूरा नहीं हुआ है - exit 2 (या fail-on=NONE के साथ exit 0)

CLI आउटपुट प्रारूप:

VERDICT: <MALWARE|CLEAN|UNKNOWN> (malware=<n> clean=<n> unknown=<n> total=<n>, elapsed=<t>)

JSON मोड --format json (या CTWALL_OUTPUT=json) के माध्यम से उपलब्ध है।

JSON आउटपुट का उदाहरण:

{
  "version": "1.1.0",
  "status": "success",
  "exitCode": 0,
  "projectId": "28e241e3-b924-4e1a-abc2-d592e8dd811c",
  "testId": "13271a70-cf47-4f3b-9e33-cb41ed0c793e",
  "revisionId": "c4d1f1a4-c018-488e-9dd0-6cfdbed83bf3",
  "verdict": "CLEAN",
  "malwareComponents": 0,
  "cleanComponents": 12,
  "unknownComponents": 0,
  "totalComponents": 12,
  "elapsedMs": 1842,
  "timedOut": false,
  "failOn": "MALWARE",
  "message": "depalert completed"
}

अपेक्षित परिणाम

VERDICT: <MALWARE|CLEAN|UNKNOWN> (malware=<n> clean=<n> unknown=<n> total=<n>, elapsed=<t>)

• exit code 0 = पास
• exit code 1 = नीति विफल या रनटाइम त्रुटि
• exit code 2 = अंतिम निर्णय UNKNOWN है और fail-on NONE नहीं है

CLI और पर्यावरण कॉन्फ़िगरेशन

प्रोजेक्ट लक्ष्यीकरण नियम

• project-id या project-name में से कम से कम एक आवश्यक है।
• project-name GET /api/v1/projects का उपयोग करके हल किया जाता है।
• नाम मिलान केस-असंवेदनशील सटीक मिलान है।
• यदि एक से अधिक सक्रिय प्रोजेक्ट एक ही नाम से मेल खाते हैं, तो रन अस्पष्टता त्रुटि के साथ विफल हो जाता है।
• आवश्यक मान या तो फ़्लैग या एनवी वेरिएबल द्वारा प्रदान किए जा सकते हैं; फ़्लैग की प्राथमिकता होती है।

कनेक्शन

• गैर-स्थानीय होस्ट के लिए https आवश्यक है।
• परीक्षण/गैर-उत्पादन वातावरण के लिए आप उपयोग कर सकते हैं:
  • --allow-insecure, या
  • CTWALL_ALLOW_INSECURE=true।
• स्व-हस्ताक्षरित HTTPS प्रमाणपत्रों के लिए (केवल परीक्षण/गैर-उत्पादन) आप उपयोग कर सकते हैं:
  • --skip-tls-verify, या
  • CTWALL_SKIP_TLS_VERIFY=true।

सुरक्षा

कृपया देखें।

लाइसेंस

DepAlert BSD 3-क्लॉज़ लाइसेंस के तहत लाइसेंस प्राप्त है।