दस्तावेज़ब्राउज़र और CrawlAgent Browserप्रमाणीकरण और पहचान

अवलोकन

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

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

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

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

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

1Password एकीकरण

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

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

पूर्वावश्यकताएँ

आप 1Password एकीकरण का उपयोग करने से पहले, आपको आवश्यकता होगी:

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

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

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

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

शुरुआत करें

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

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

API: PUT /browser/one-password/token

उदाहरण cURL अनुरोध:

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 कॉन्फ़िगरेशन की पहचान के लिए किया जाता है।
tokenstring✓1Password API पहुँच टोकन।

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

1Password में उसके संदर्भ का उपयोग करके एकल सीक्रेट पुनः प्राप्त करें।

API: POST /browser/one-password/secret

उदाहरण (cURL):

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]"
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
referencestring✓1Password में सीक्रेट के लिए संदर्भ, जिसे प्रारूप में दिया गया है op://[vault]/[item]/[field].

3. संदर्भों द्वारा कई सीक्रेट पुनः प्राप्त करें

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

API: POST /browser/one-password/secrets

उदाहरण (cURL):

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]"
    ]
  }'

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
referencesस्ट्रिंग्स की सरणी✓1Password में सीक्रेट के लिए संदर्भों की एक सरणी, प्रारूप में जैसा कि op://[vault]/[item]/[field].

4. 1Password प्राधिकरण वापस लें

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

API: DELETE /browser/one-password/token

उदाहरण cURL अनुरोध:

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 अनुरोध:

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 अनुरोध:

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 अनुरोध:

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 सर्विस अकाउंट डॉक्यूमेंटेशन
  • Scrapeless सपोर्ट से संपर्क करें market@scrapeless.com पर