एआई प्रॉम्प्ट: Firebase के सुरक्षा नियम लिखो

इस प्रॉम्प्ट की मदद से, Google Antigravity जैसे एआई असिस्टेंट, आपके ऐप्लिकेशन के लिए Firebase Security Rules जनरेट कर सकते हैं और उन्हें बेहतर बना सकते हैं. इस प्रॉम्प्ट का इस्तेमाल करके, आम तौर पर इस्तेमाल होने वाले मामलों के लिए Security Rules का ड्राफ़्ट तैयार किया जा सकता है. जैसे, उपयोगकर्ता के हिसाब से ऐक्सेस देना, भूमिका के आधार पर अनुमतियां लागू करना, और डेटा की पुष्टि करना.

इस प्रॉम्प्ट का फ़ोकस, इनके लिए Security Rules जनरेट करने पर है:

  • Cloud Firestore: अपने ऐप्लिकेशन के लॉजिक के आधार पर, कलेक्शन और दस्तावेज़ों को सुरक्षित करें.
  • Cloud Storage for Firebase: सेव की गई फ़ाइलों के लिए, ऐक्सेस की अनुमतियों की पुष्टि करें.

इस प्रॉम्प्ट का इस्तेमाल करके, आपको मज़बूत सुरक्षा व्यवस्था के साथ शुरुआत करने में मदद मिल सकती है. हालांकि, आपको प्रोडक्शन में डिप्लॉय करने से पहले, अपने Security Rules की अच्छी तरह से जांच करनी चाहिए. Security Rules की टेस्टिंग के बारे में ज़्यादा जानकारी के लिए, Firebase Security Rules का इस्तेमाल शुरू करें: Security Rules की टेस्टिंग करें लेख पढ़ें.

ज़रूरी शर्तें

  • Firebase Security Rules के सबसे सही तरीकों के बारे में जानें.
  • Firebase Security Rules के लिए यूनिट टेस्ट चलाने और Firebase Local Emulator Suite का इस्तेमाल करने के लिए, Node.js और Firebase सीएलआई इंस्टॉल करें. ज़्यादा जानकारी के लिए, Firebase Local Emulator Suite को इंस्टॉल, कॉन्फ़िगर, और इंटिग्रेट करना लेख पढ़ें.
  • सुझाव: अगर आपने अब तक Antigravity इंस्टॉल नहीं किया है, तो कर लें. यहां दिए गए निर्देशों में, Security Rules जनरेट करने के लिए, Firebase एजेंट स्किल और एमसीपी सर्वर को चालू करने और इस्तेमाल करने का तरीका बताया गया है. अगर आपको किसी दूसरे एआई कोडिंग एजेंट का इस्तेमाल करना है, तो firebase-tools रिपॉज़िटरी से Cloud Firestore या Cloud Storage for Firebase के लिए प्रॉम्प्ट को कॉपी करके, अपने चुने हुए एआई कोडिंग एजेंट में चिपकाएं.
  • Firebase एजेंट स्किल और एमसीपी सर्वर, दोनों मिलकर उन प्रॉम्प्ट को ऐक्सेस करते हैं जो Firebase Security Rules को जनरेट और उसकी पुष्टि करते हैं. साथ ही, Security Rules की टेस्टिंग और डिप्लॉयमेंट में मदद करते हैं. Firebase Security Rules जनरेट करने के लिए इन टूल का इस्तेमाल करने से पहले, Firebase एमसीपी सर्वर इंस्टॉल करें.

सीमाएं

हम इस सुविधा को लगातार बेहतर बना रहे हैं. इसलिए, इसकी सीमाओं की इस सूची में बदलाव हो सकता है. अपडेट के लिए, समय-समय पर यहां देखते रहें.

  • इस प्रॉम्प्ट को Cloud Firestore और Cloud Storage for Firebase के लिए Firebase Security Rules जनरेट करने के लिए डिज़ाइन किया गया है. फ़िलहाल, यह Firebase Realtime Database के लिए Security Rules जनरेट नहीं कर सकता.

  • किसी सर्वर या अन्य बैकएंड एनवायरमेंट से आपके डेटाबेस या बकेट को ऐक्सेस करते समय, Firebase Security Rules को कॉल नहीं किया जाता. जैसे, Firebase Admin SDK का इस्तेमाल करते समय. अगर Admin SDK का इस्तेमाल किया जा रहा है, तो बैकएंड कोड में अनुमति और डेटा की पुष्टि को मैनेज करने की ज़िम्मेदारी आपकी है.

  • Firebase कंसोल में Gemini in Firebase, इस प्रॉम्प्ट का इस्तेमाल करने पर भी Firebase Security Rules जनरेट नहीं कर पा रहा है. इसके बजाय, किसी ऐसे एआई असिस्टेंट का इस्तेमाल करें जिसके पास आपके कोड बेस का ऐक्सेस हो. जैसे, Antigravity. इसके बारे में इस पेज पर बताया गया है.

प्रॉम्प्ट का इस्तेमाल करें

यह सुविधा, Firebase एमसीपी सर्वर और Firebase एजेंट स्किल का इस्तेमाल करने पर उपलब्ध होती है. इसके लिए, आपको इनके साथ काम करने वाले एआई असिस्टेंट (जैसे, Antigravity) का इस्तेमाल करना होगा, ताकि Security Rules और टेस्ट जनरेट किए जा सकें. ये टूल आपके सोर्स कोड का विश्लेषण करते हैं, ताकि Cloud Firestore और Cloud Storage के लिए डेटा स्कीमा और ऐक्सेस पैटर्न की पहचान की जा सके. इन्हें कम से कम अधिकारों के सिद्धांत के आधार पर, Security Rules का ड्राफ़्ट बनाने के लिए डिज़ाइन किया गया है. साथ ही, ये बार-बार "हमले" के सिम्युलेशन के ज़रिए, कमज़ोरियों का पता लगाने की कोशिश करते हैं. पुष्टि करने की आखिरी प्रोसेस में मदद करने के लिए, वे @firebase/rules-unit-testing का इस्तेमाल करके, शुरुआती यूनिट टेस्ट सुइट उपलब्ध कराते हैं. इससे आपको Firebase Local Emulator Suite का इस्तेमाल करके, स्थानीय तौर पर अपने सुरक्षा लॉजिक की पुष्टि करने की सुविधा मिलती है.

इन टूल का इस्तेमाल करने के लिए, तीन चरणों को पूरा करना ज़रूरी है. इनके बारे में इस सेक्शन में बताया गया है:

  1. Security Rules और टेस्ट जनरेट करें.

  2. Security Rules की पुष्टि और टेस्ट के नतीजे देखें.

  3. अपने Firebase प्रोजेक्ट में Security Rules को डिप्लॉय करें.

पहला चरण: Security Rules और टेस्ट जनरेट करना

टूल सेट अप करें और चलाएं:

  1. Firebase एजेंट स्किल चालू करें:

    • Google Antigravity: Antigravity Marketplace से Firebase प्लग इन इंस्टॉल करने के लिए, सेटअप करने के निर्देश देखें. प्रोजेक्ट लेवल पर भी स्किल इंस्टॉल की जा सकती हैं. इसके लिए, यह कमांड चलाएं:

      npx skills add firebase/agent-skills --agent=antigravity
    • अन्य एआई कोडिंग एजेंट: एजेंट की स्किल और एमसीपी सर्वर के लिए दिए गए निर्देशों का पालन करें.

  2. अपना एआई असिस्टेंट चालू करें. उदाहरण के लिए, सीएलआई के लिए अपने टर्मिनल में agy चलाएं या डेस्कटॉप ऐप्लिकेशन खोलें.

  3. अपने प्रोजेक्ट के रूट से, एजेंट को Cloud Firestore या Cloud Storage के लिए Security Rules जनरेट करने के लिए कहें. यह इस बात पर निर्भर करता है कि आपका एआई कोडिंग एजेंट, एमसीपी प्रॉम्प्ट के साथ कैसे इंटरैक्ट करता है:

    • Antigravity जैसे नैचुरल लैंग्वेज का इस्तेमाल करने वाले कोडिंग एजेंट के लिए, एजेंट को नैचुरल लैंग्वेज का इस्तेमाल करके प्रॉम्प्ट दें.

      • Cloud Firestore के लिए Security Rules जनरेट करें:

        Generate Firestore security rules for this project, then run the unit tests.
        

        पैरंट डायरेक्ट्री में, एजेंट एक firestore.rules फ़ाइल और एक नई security_rules_test_firestore डायरेक्ट्री बनाता है. इसमें जनरेट किए गए Security Rules के लिए यूनिट टेस्ट के साथ Node.js प्रोजेक्ट शामिल होता है.

      • Cloud Storage for Firebase के लिए Security Rules जनरेट करें:

        Generate Cloud Storage security rules for this project, then run the unit tests.
        

        पैरंट डायरेक्ट्री में, एजेंट एक storage.rules फ़ाइल और एक नई security_rules_test_storage डायरेक्ट्री बनाता है. इसमें जनरेट किए गए Security Rules के लिए यूनिट टेस्ट के साथ Node.js प्रोजेक्ट शामिल होता है.

    • स्लैश कमांड के साथ काम करने वाले कोडिंग एजेंट (जैसे, Claude Code) के लिए, इन कमांड का इस्तेमाल करें.

      • Cloud Firestore के लिए Security Rules जनरेट करें:

        /firestore:generate_security_rules
        
      • Cloud Storage for Firebase के लिए Security Rules जनरेट करें:

        /storage:generate_security_rules
        
    • एमसीपी प्रॉम्प्ट इंटिग्रेशन की सुविधा के साथ काम न करने वाले कोडिंग एजेंट के लिए, firebase-tools रिपॉज़िटरी से रॉ प्रॉम्प्ट टेंप्लेट को कॉपी करके, एजेंट की चैट में चिपकाया जा सकता है.

      • Cloud Firestore के लिए Security Rules जनरेट करें: Cloud Firestore से प्रॉम्प्ट कॉपी करें.
      • Cloud Storage for Firebase के लिए Security Rules जनरेट करें: Cloud Storage for Firebase से प्रॉम्प्ट कॉपी करें.

दूसरा चरण: Security Rules की पुष्टि और जांच के नतीजों की समीक्षा करना

  1. पक्का करें कि आपके एआई कोडिंग एजेंट ने ये काम किए हों. टूल के चलने के बाद, आपको जनरेट की गई खास जानकारी मिलनी चाहिए.

    • सिंटैक्स की पुष्टि करना: Security Rules जनरेट करने के बाद, आपका एआई कोडिंग एजेंट, Firebase एमसीपी सर्वर के firebase_validate_security_rules कमांड का इस्तेमाल करके, सिंटैक्स की पुष्टि अपने-आप करता है.

    • यूनिट टेस्ट: सिंटैक्स की पुष्टि करने के बाद, एआई कोडिंग एजेंट, Firebase Local Emulator Suite का इस्तेमाल करके जनरेट किए गए यूनिट टेस्ट को चलाने की कोशिश करता है.

  2. अगर टेस्ट अपने-आप नहीं चलते हैं, तो Firebase Local Emulator Suite को किसी अलग टर्मिनल में शुरू करें. इसके बाद, टेस्ट चलाने के लिए इनमें से कोई एक विकल्प इस्तेमाल करें:

    • पहला विकल्प: अपने एआई असिस्टेंट को टेस्ट चलाने के लिए कहें:

      Firebase Emulator Suite is running in a separate terminal. Please execute the tests.
      
    • दूसरा विकल्प: rules_test या storage_rules_test डायरेक्ट्री में मौजूद README.md फ़ाइल में दिए गए निर्देशों का पालन करके, मैन्युअल तरीके से टेस्ट चलाएं.

तीसरा चरण: अपने Firebase प्रोजेक्ट में Security Rules को डिप्लॉय करना

जनरेट किए गए Security Rules के नतीजे से संतुष्ट होने पर, Security Rules को अपने Firebase प्रोजेक्ट में डिप्लॉय करने के लिए, यहां दिए गए Firebase सीएलआई कमांड का इस्तेमाल करें:

  • Cloud Firestore

    firebase deploy --only firestore:rules
  • Cloud Storage for Firebase

    firebase deploy --only storage