BrowserविशेषताएँAuthentication and Identity

अवलोकन

स्क्रैपलेस क्रेडेंशियल सिस्टम को डेवलपर्स को स्वचालित ब्राउज़र सत्रों में उपयोग के लिए क्रेडेंशियल डेटा को सुरक्षित रूप से स्टोर करने, प्रबंधित करने और पुनः प्राप्त करने में मदद करने के लिए डिज़ाइन किया गया है।

व्यवहार में, यह सिस्टम डेवलपर्स को एक API के माध्यम से क्रेडेंशियल्स को प्रबंधित करने, पढ़ने और अपडेट करने की अनुमति देता है, जबकि ब्राउज़र ऑटोमेशन स्क्रिप्ट या AI एजेंट आवश्यकतानुसार इन क्रेडेंशियल्स को स्वचालित रूप से भर और एक्सेस कर सकते हैं। स्क्रैपलेस क्रेडेंशियल सिस्टम का उपयोग करके, डेवलपर्स ये कर सकते हैं:

  • विभिन्न वातावरणों या एप्लिकेशनों के लिए क्रेडेंशियल्स को केंद्रीय रूप से व्यवस्थित और संग्रहीत करें।
  • प्रमाणीकरण डेटा को सुरक्षित रूप से पुनः प्राप्त करें और इसे ब्राउज़र सत्रों में इंजेक्ट करें।
  • AI एजेंटों को कोडबेस में रहस्यों को उजागर किए बिना या हार्डकोड किए बिना क्रेडेंशियल डेटा को स्वचालित रूप से एक्सेस करने और भरने की अनुमति दें।

मुख्य सुरक्षा सिद्धांत
स्क्रैपलेस प्रमाणीकरण परत तीन प्रमुख सिद्धांतों का पालन करती है:

  • सुरक्षित भंडारण: क्रेडेंशियल्स को भंडारण और प्रसारण दोनों के दौरान एंटरप्राइज़-ग्रेड मानकों का उपयोग करके एन्क्रिप्ट किया जाता है।
  • नियंत्रित पहुंच: केवल अधिकृत API टोकन ही क्रेडेंशियल्स को पढ़ सकते हैं, जिससे डेटा को कैसे एक्सेस और उपयोग किया जाता है, इस पर पूर्ण नियंत्रण सुनिश्चित होता है।
  • सत्र अलगाव: इंजेक्ट किए गए क्रेडेंशियल्स उपयोग के बाद अनुपलब्ध रहते हैं, जिससे किसी भी प्रकार के डेटा रिसाव या रीप्ले हमलों को रोका जा सकता है।

1Password एकीकरण

1Password के साथ एकीकरण के माध्यम से, डेवलपर्स ब्राउज़र ऑटोमेशन परिदृश्यों के लिए रहस्यों या क्रेडेंशियल्स को सुरक्षित रूप से पुनः प्राप्त करने के लिए अपने 1Password वॉल्ट्स को स्क्रैपलेस से सुरक्षित रूप से जोड़ सकते हैं।

एक बार एकीकृत होने के बाद, डेवलपर्स सीधे 1Password से क्रेडेंशियल्स को पढ़ सकते हैं और उन्हें API के माध्यम से स्क्रैपलेस ब्राउज़र सत्रों में इंजेक्ट कर सकते हैं — प्रमाणीकरण डेटा को संभालने का एक सरल और सुरक्षित तरीका प्रदान करते हुए।

पूर्वापेक्षाएँ

1Password एकीकरण का उपयोग करने से पहले, आपको चाहिए:

  1. 1Password खाता: एक सक्रिय 1Password खाता जिसमें “Personal” से भिन्न वॉल्ट में उन रहस्यों तक पहुंच हो जिनका आप उपयोग करना चाहते हैं।
  2. स्क्रैपलेस API कुंजी: प्रमाणीकरण के लिए आपकी स्क्रैपलेस ब्राउज़र API कुंजी।
  • एक खाता बनाएं और स्क्रैपलेस डैशबोर्ड में लॉग इन करें।
  • अपनी स्क्रैपलेस API कुंजी जनरेट करें। image1.png

1Password सर्विस अकाउंट टोकन प्राप्त करना

  1. अपने 1Password खाते में लॉग इन करें।
  2. डेवलपर → डायरेक्टरी → सर्विस अकाउंट्स पर नेविगेट करें।
  3. सर्विस अकाउंट बनाएं पर क्लिक करें।
  4. अपने सर्विस अकाउंट को एक वर्णनात्मक नाम दें (उदाहरण के लिए, “Scrapeless Browser Automation”)।
  5. सर्विस अकाउंट को उन वॉल्ट्स तक पहुंच प्रदान करें जिनमें आपको आवश्यक रहस्य शामिल हैं।
  6. सर्विस अकाउंट टोकन कॉपी करें (ops_ से शुरू होता है) - आपको एकीकरण सेटअप के लिए इसकी आवश्यकता होगी।
सुरक्षा नोट

अपने सर्विस अकाउंट टोकन को सुरक्षित रूप से स्टोर करें। यह आपके 1Password रहस्यों तक पहुंच प्रदान करता है और इसे पासवर्ड की तरह माना जाना चाहिए।

आरंभ करें

1. 1Password एकीकरण बनाना

अपने वॉल्ट तक पहुंचने के लिए अपने 1Password API टोकन को कॉन्फ़िगर करने के लिए इस एंडपॉइंट का उपयोग करें। सिस्टम इसे संग्रहीत करने से पहले टोकन को मान्य करेगा।

API: PUT /browser/one-password/token

उदाहरण कर्ल अनुरोध:

curl -X PUT https://api.scrapeless.com/browser/one-password/token \
  -H "x-api-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "test",
    "token": "ops_eyJzaWduSW5BZGa13Da..."
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
namestringअधिकृत एकीकरण का नाम, जिसका उपयोग इस 1Password कॉन्फ़िगरेशन को पहचानने के लिए किया जाता है।
tokenstring1Password API एक्सेस टोकन।

2. संदर्भ द्वारा एक रहस्य पुनः प्राप्त करें

इसके संदर्भ का उपयोग करके 1Password से एक रहस्य पुनः प्राप्त करें।

API: POST /browser/one-password/secret

उदाहरण (कर्ल):

curl -X POST https://api.scrapeless.com/browser/one-password/secret \
  -H "x-api-token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "op://[vault]/[item]/[field]"
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
referencestring1Password में रहस्य का संदर्भ, op://[vault]/[item]/[field] के रूप में स्वरूपित।

3. संदर्भों द्वारा एकाधिक रहस्य पुनः प्राप्त करें

संदर्भों की एक सरणी का उपयोग करके एक ही अनुरोध में 1Password से कई रहस्य पुनः प्राप्त करें।

API: POST /browser/one-password/secrets

उदाहरण (कर्ल):

curl -X POST https://api.scrapeless.com/browser/one-password/secrets \
  -H "x-api-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "references": [ 
      "op://[vault]/[item]/[field1]",
      "op://[vault]/[item]/[field2]",
      "op://[vault]/[item]/[field3]"
    ]
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
referencesarray of strings1Password में रहस्यों के संदर्भों की एक सरणी, op://[vault]/[item]/[field] के रूप में स्वरूपित।

4. 1Password प्राधिकरण रद्द करें

एक बार रद्द होने के बाद, 1Password में संग्रहीत रहस्यों तक पहुंच अक्षम हो जाएगी जब तक कि एक नया टोकन कॉन्फ़िगर नहीं किया जाता है।

API: DELETE /browser/one-password/token

उदाहरण कर्ल अनुरोध:

curl -X DELETE https://api.scrapeless.com/browser/one-password/token \
  -H "x-api-token: YOUR_API_KEY"

समस्या निवारण

एकीकरण निर्माण विफल

  • अमान्य सर्विस अकाउंट टोकन: सत्यापित करें कि आपका टोकन ops_ से शुरू होता है और मान्य है।
  • अपर्याप्त अनुमतियाँ: सुनिश्चित करें कि सर्विस अकाउंट के पास आवश्यक वॉल्ट्स तक पहुंच है।

रहस्य लोड नहीं हो रहे हैं

  • अमान्य रहस्य संदर्भ: अपने रहस्य संदर्भों के स्वरूप की जांच करें (op://vault/item/field)।
  • सर्विस अकाउंट एक्सेस: सत्यापित करें कि सर्विस अकाउंट के पास निर्दिष्ट वॉल्ट्स और आइटम तक पहुंच है।
  • आइटम या फ़ील्ड नहीं मिला: सुनिश्चित करें कि वॉल्ट, आइटम और फ़ील्ड के नाम सही हैं और मौजूद हैं।

पर्यावरण चर उपलब्ध नहीं हैं

  • रहस्य संदर्भ स्वरूप की जांच करें: सुनिश्चित करें कि आपके रहस्य संदर्भ सही स्वरूप का पालन करते हैं।
  • एकीकरण आईडी सत्यापित करें: सुनिश्चित करें कि आप अपने सत्र कॉन्फ़िगरेशन में सही एकीकरण आईडी का उपयोग कर रहे हैं।

टीम क्रेडेंशियल प्रबंधन

टीम क्रेडेंशियल प्रबंधन API आपको एप्लिकेशनों और सेवाओं के लिए टीम-स्तरीय क्रेडेंशियल्स को सुरक्षित रूप से बनाने, अपडेट करने, पुनः प्राप्त करने और हटाने की अनुमति देता है। मल्टी-एनवायरनमेंट कॉन्फ़िगरेशन का समर्थन करने के लिए प्रत्येक क्रेडेंशियल को एक विशिष्ट ओरिजिन और नेमस्पेस से जोड़ा जा सकता है।

आरंभ करें

1. एक टीम क्रेडेंशियल बनाएं

एक एप्लिकेशन द्वारा आवश्यक प्रमाणीकरण डेटा को स्टोर और प्रबंधित करने के लिए एक टीम के लिए एक नया क्रेडेंशियल कॉन्फ़िगरेशन बनाएं।

API: POST /browser/credentials

उदाहरण कर्ल अनुरोध:

curl -X POST 'https://api.scrapeless.com/browser/credentials' \
  -H "x-api-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "https://example.com",
    "namespace": "production",
    "metadata": {
      "username": "admin",
      "password": "secure_password"
    }
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
originstringएप्लिकेशन या सेवा का मूल।
namespacestringxक्रेडेंशियल को स्कोप करने के लिए वैकल्पिक नेमस्पेस।
metadataobjectएप्लिकेशन द्वारा आवश्यक प्रमाणीकरण डेटा के कुंजी-मूल्य जोड़े।

2. एक टीम क्रेडेंशियल अपडेट करें

एक मौजूदा टीम क्रेडेंशियल कॉन्फ़िगरेशन अपडेट करें।

API: PUT /browser/credentials

उदाहरण कर्ल अनुरोध:

curl -X PUT 'https://api.scrapeless.com/browser/credentials' \
  -H "x-api-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "https://example.com",
    "namespace": "production",
    "metadata": {
      "username": "new_admin",
      "password": "new_secure_password"
    }
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
originstringएप्लिकेशन या सेवा का मूल।
namespacestringxक्रेडेंशियल को स्कोप करने के लिए वैकल्पिक नेमस्पेस।
metadataobjectएप्लिकेशन द्वारा आवश्यक अपडेट किए गए प्रमाणीकरण डेटा के कुंजी-मूल्य जोड़े।

3. एक टीम क्रेडेंशियल प्राप्त करें

एक टीम क्रेडेंशियल को उसके मूल और वैकल्पिक नेमस्पेस द्वारा पुनः प्राप्त करें।

API: GET /browser/credentials

उदाहरण कर्ल अनुरोध:

curl -X GET 'https://api.scrapeless.com/browser/credentials?origin=https://example.com&namespace=production' \
  -H "x-api-token: YOUR_API_TOKEN"

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
originstringएप्लिकेशन या सेवा का मूल।
namespacestringxक्रेडेंशियल को स्कोप करने के लिए वैकल्पिक नेमस्पेस।

4. एक टीम क्रेडेंशियल हटाएं

एक विशिष्ट टीम क्रेडेंशियल कॉन्फ़िगरेशन हटाएं।

API: DELETE /browser/credentials

cURL उदाहरण:

curl -X DELETE 'https://api.scrapeless.com/browser/credentials' \
  -H "x-api-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "https://example.com",
    "namespace": "production"
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
originstringएप्लिकेशन या सेवा का मूल।
namespacestringxक्रेडेंशियल को स्कोप करने के लिए वैकल्पिक नेमस्पेस।

सहायता

1Password एकीकरण के लिए अतिरिक्त सहायता के लिए:

  • 1Password सर्विस अकाउंट्स डॉक्यूमेंटेशन
  • market@scrapeless.com पर स्क्रैपलेस सहायता से संपर्क करें