Start herejourney
Use this if
अधिक एकीकरणों का विस्तार करने से पहले अपना पहला स्कैन चलाएं, निष्कर्ष सबमिट करें और डेटा गुणवत्ता की पुष्टि करें।
Audience: सुरक्षा इंजीनियर, सीआई मालिक, और एकीकरण इंजीनियरTypical time: 10-15 मिनट
Start here
Step 5 of 7
1
2
3
4
5
6
7
शुरू करने से पहले
- /api-keys में एक अंतर्ग्रहण एपीआई कुंजी बनाएं और कच्ची कुंजी सहेजें (एक बार दिखाया गया है)।
- स्कैनर छवि public.ecr.aws/blackshield-security/pipeline-scanner:1.0.9 (या आपके प्रतिबिंबित public.ecr.aws उपनाम) का उपयोग करें।
- BLACKSHIELD_API_URL को अपने बैकएंड एंडपॉइंट पर सेट करें (स्थानीय: http://localhost:8000).
Do this now
1
चरण 1
स्कैनर छवि और पहला लक्ष्य चुनें
एक नियतात्मक लक्ष्य और एक ज्ञात स्कैनर छवि का उपयोग करें ताकि परिणामों को सत्यापित करना आसान हो।
- पहली बार चलाने के लिए `public.ecr.aws/blackshield-security/pipeline-scanner:1.0.9` (या अपना प्रतिबिंबित सार्वजनिक ईसीआर उपनाम) का उपयोग करें।
- पूर्वानुमानित प्रथम परिणामों के लिए `python:3.11-slim` जैसा ज्ञात लक्ष्य चुनें।
- स्कैनर क्लाइंट द्वारा समर्थित JSON मोड में ट्रिवी या सेमग्रेप चलाएँ।
- समस्या निवारण के लिए ब्रांच, कमिट या आर्टिफैक्ट मेटाडेटा रखें।
What success looks like
समस्या निवारण के लिए ब्रांच, कमिट या आर्टिफैक्ट मेटाडेटा रखें।
2
चरण 2
अंतर्ग्रहण एपीआई कुंजी बनाएं और उसका उपयोग करें
एपीआई कुंजी में एक कार्यस्थान कुंजी बनाएं और इसका उपयोग केवल स्कैनर अंतर्ग्रहण के लिए करें।
- `/api-keys` खोलें, एक कुंजी बनाएं, और कच्चे `sp_...` मान को तुरंत सहेजें।
- पर्यावरण चर के माध्यम से `BLACKSHIELD_API_URL` और `BLACKSHIELD_API_KEY` सेट करें।
- मिलान स्कैनर क्लाइंट एंट्रीपॉइंट या कंटेनर कमांड चलाएँ।
- स्वीकृत पेलोड के प्रमाण के रूप में प्रतिक्रिया लॉग कैप्चर करें।
What success looks like
स्वीकृत पेलोड के प्रमाण के रूप में प्रतिक्रिया लॉग कैप्चर करें।
3
चरण 3
गुणवत्ता और डिडुप्लीकेशन को मान्य करें
सुनिश्चित करें कि निष्कर्ष पूर्ण हैं, गंभीरता को सही ढंग से मैप किया गया है, और बार-बार अपलोड करने से समस्याएँ दोहराई नहीं जाती हैं।
- निष्कर्ष खोलें और स्कैनर और संसाधन द्वारा फ़िल्टर करें।
- सत्यापित करें कि `first_seen` और `last_seen` फ़ील्ड भरे हुए हैं।
- एक ही पेलोड को एक बार पुनः सबमिट करें और डिडुप्लीकेशन व्यवहार को सत्यापित करें।
What success looks like
एक ही पेलोड को एक बार पुनः सबमिट करें और डिडुप्लीकेशन व्यवहार को सत्यापित करें।
Demonstration only
This configuration is designed for ease of use. To deploy scanner clients at scale, please plan your deployment architecture accordingly or contact us for enterprise best practices.
यह चलाएँ
एपीआई के माध्यम से एक अंतर्ग्रहण एपीआई कुंजी बनाएं
TOKEN=$(curl -s -X POST "http://localhost:8000/api/v1/auth/login?email=admin@acme.com&password=changeme123" | python3 -c "import sys, json; print(json.load(sys.stdin)['access_token'])")
curl -s -X POST http://localhost:8000/api/v1/api-keys \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"label":"Pipeline Scanner","expires_in_days":90}'पहला पाइपलाइन स्कैन चलाएँ और निष्कर्ष ग्रहण करें
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
-e BLACKSHIELD_API_URL=http://localhost:8000 \
-e BLACKSHIELD_API_KEY=sp_your_key_here \
-e SCAN_TOOL=trivy \
-e SCAN_TARGET=python:3.11-slim \
public.ecr.aws/blackshield-security/pipeline-scanner:1.0.9What success looks like
- अंतर्ग्रहण कार्य की स्थिति निर्मित > 0 या अद्यतन > 0 के साथ पूर्ण हो जाती है।
- नए निष्कर्ष गंभीरता, स्रोत स्कैनर और टाइमस्टैम्प के साथ /findings में दिखाई देते हैं।
Continue
Keep your rollout moving with the next recommended step.
फाइंडिंग्स की समीक्षा करें और प्राथमिकता तय करें