उपयोगकर्ताओं और समूहों के लिए सुरक्षित डेटा एक्सेस

कई सहयोगी ऐप्स उपयोगकर्ताओं को अनुमतियों के एक सेट के आधार पर डेटा के विभिन्न हिस्सों को पढ़ने और लिखने की अनुमति देते हैं। उदाहरण के लिए, दस्तावेज़ संपादन ऐप में, उपयोगकर्ता अवांछित पहुंच को रोकते हुए कुछ उपयोगकर्ताओं को अपने दस्तावेज़ पढ़ने और लिखने की अनुमति देना चाह सकते हैं।

समाधान: भूमिका-आधारित अभिगम नियंत्रण

आप अपने ऐप में भूमिका-आधारित पहुंच नियंत्रण लागू करने के लिए क्लाउड फायरस्टोर के डेटा मॉडल के साथ-साथ कस्टम सुरक्षा नियमों का लाभ उठा सकते हैं।

मान लीजिए कि आप एक सहयोगी लेखन एप्लिकेशन बना रहे हैं जिसमें उपयोगकर्ता निम्नलिखित सुरक्षा आवश्यकताओं के साथ "कहानियां" और "टिप्पणियां" बना सकते हैं:

  • प्रत्येक कहानी का एक स्वामी होता है और इसे "लेखकों", "टिप्पणीकारों" और "पाठकों" के साथ साझा किया जा सकता है।
  • पाठक केवल कहानियाँ और टिप्पणियाँ देख सकते हैं। वे कुछ भी संपादित नहीं कर सकते.
  • टिप्पणीकारों के पास पाठकों तक सभी पहुंच होती है, और वे किसी कहानी में टिप्पणियां भी जोड़ सकते हैं।
  • लेखकों के पास टिप्पणीकारों तक सभी पहुंच होती है, और वे कहानी सामग्री को संपादित भी कर सकते हैं।
  • मालिक कहानी के किसी भी हिस्से को संपादित कर सकते हैं और साथ ही अन्य उपयोगकर्ताओं की पहुंच को नियंत्रित कर सकते हैं।

डेटा संरचना

मान लें कि आपके ऐप में stories संग्रह है जहां प्रत्येक दस्तावेज़ एक कहानी का प्रतिनिधित्व करता है। प्रत्येक कहानी में एक comments उपसंग्रह भी होता है जहां प्रत्येक दस्तावेज़ उस कहानी पर एक टिप्पणी होती है।

पहुंच भूमिकाओं पर नज़र रखने के लिए, एक roles फ़ील्ड जोड़ें जो भूमिकाओं के लिए उपयोगकर्ता आईडी का एक मानचित्र है:

/कहानियां/{कहानीआईडी}

{
  title: "A Great Story",
  content: "Once upon a time ...",
  roles: {
    alice: "owner",
    bob: "reader",
    david: "writer",
    jane: "commenter"
    // ...
  }
}

टिप्पणियों में केवल दो फ़ील्ड हैं, लेखक की उपयोगकर्ता आईडी और कुछ सामग्री:

/कहानियां/{कहानीआईडी}/टिप्पणियां/{टिप्पणीआईडी}

{
  user: "alice",
  content: "I think this is a great story!"
}

नियम

अब जब आपके पास डेटाबेस में उपयोगकर्ताओं की भूमिकाएँ दर्ज हैं, तो आपको उन्हें मान्य करने के लिए सुरक्षा नियम लिखने होंगे। ये नियम मानते हैं कि ऐप फायरबेस ऑथ का उपयोग करता है ताकि request.auth.uid वैरिएबल उपयोगकर्ता की आईडी हो।

चरण 1 : एक बुनियादी नियम फ़ाइल से प्रारंभ करें, जिसमें कहानियों और टिप्पणियों के लिए खाली नियम शामिल हैं:

service cloud.firestore {
   match /databases/{database}/documents {
     match /stories/{story} {
         // TODO: Story rules go here...

         match /comments/{comment} {
            // TODO: Comment rules go here...
         }
     }
   }
}
step1-invalid.rules

चरण 2 : एक सरल write नियम जोड़ें जो मालिकों को कहानियों पर पूर्ण नियंत्रण देता है। परिभाषित फ़ंक्शन उपयोगकर्ता की भूमिकाएं निर्धारित करने में सहायता करते हैं और यदि नए दस्तावेज़ मान्य हैं:

service cloud.firestore {
   match /databases/{database}/documents {
     match /stories/{story} {
        function isSignedIn() {
          return request.auth != null;
        }

        function getRole(rsc) {
          // Read from the "roles" map in the resource (rsc).
          return rsc.data.roles[request.auth.uid];
        }

        function isOneOfRoles(rsc, array) {
          // Determine if the user is one of an array of roles
          return isSignedIn() && (getRole(rsc) in array);
        }

        function isValidNewStory() {
          // Valid if story does not exist and the new story has the correct owner.
          return resource == null && isOneOfRoles(request.resource, ['owner']);
        }

        // Owners can read, write, and delete stories
        allow write: if isValidNewStory() || isOneOfRoles(resource, ['owner']);

         match /comments/{comment} {
            // ...
         }
     }
   }
}
step2.rules

चरण 3 : ऐसे नियम लिखें जो किसी भी भूमिका के उपयोगकर्ता को कहानियाँ और टिप्पणियाँ पढ़ने की अनुमति दें। पिछले चरण में परिभाषित फ़ंक्शन का उपयोग करने से नियम संक्षिप्त और पठनीय रहते हैं:

service cloud.firestore {
   match /databases/{database}/documents {
     match /stories/{story} {
        function isSignedIn() {
          return request.auth != null;
        }

        function getRole(rsc) {
          return rsc.data.roles[request.auth.uid];
        }

        function isOneOfRoles(rsc, array) {
          return isSignedIn() && (getRole(rsc) in array);
        }

        function isValidNewStory() {
          return resource == null
            && request.resource.data.roles[request.auth.uid] == 'owner';
        }

        allow write: if isValidNewStory() || isOneOfRoles(resource, ['owner']);

        // Any role can read stories.
        allow read: if isOneOfRoles(resource, ['owner', 'writer', 'commenter', 'reader']);

        match /comments/{comment} {
          // Any role can read comments.
          allow read: if isOneOfRoles(get(/databases/$(database)/documents/stories/$(story)),
                                      ['owner', 'writer', 'commenter', 'reader']);
        }
     }
   }
}
step3.rules

चरण 4 : कहानी लेखकों, टिप्पणीकारों और मालिकों को टिप्पणियाँ पोस्ट करने की अनुमति दें। ध्यान दें कि यह नियम यह भी मान्य करता है कि टिप्पणी का owner अनुरोध करने वाले उपयोगकर्ता से मेल खाता है, जो उपयोगकर्ताओं को एक-दूसरे की टिप्पणियों पर लिखने से रोकता है:

service cloud.firestore {
   match /databases/{database}/documents {
     match /stories/{story} {
        function isSignedIn() {
          return request.auth != null;
        }

        function getRole(rsc) {
          return rsc.data.roles[request.auth.uid];
        }

        function isOneOfRoles(rsc, array) {
          return isSignedIn() && (getRole(rsc) in array);
        }

        function isValidNewStory() {
          return resource == null
            && request.resource.data.roles[request.auth.uid] == 'owner';
        }

        allow write: if isValidNewStory() || isOneOfRoles(resource, ['owner'])
        allow read: if isOneOfRoles(resource, ['owner', 'writer', 'commenter', 'reader']);

        match /comments/{comment} {
          allow read: if isOneOfRoles(get(/databases/$(database)/documents/stories/$(story)),
                                      ['owner', 'writer', 'commenter', 'reader']);

          // Owners, writers, and commenters can create comments. The
          // user id in the comment document must match the requesting
          // user's id.
          //
          // Note: we have to use get() here to retrieve the story
          // document so that we can check the user's role.
          allow create: if isOneOfRoles(get(/databases/$(database)/documents/stories/$(story)),
                                        ['owner', 'writer', 'commenter'])
                        && request.resource.data.user == request.auth.uid;
        }
     }
   }
}

step4.rules

चरण 5 : लेखकों को कहानी की सामग्री को संपादित करने की क्षमता दें, लेकिन कहानी की भूमिकाओं को संपादित करने या दस्तावेज़ के किसी अन्य गुण को बदलने की नहीं। इसके लिए कहानियां write नियम को create , update करने और delete के लिए अलग-अलग नियमों में विभाजित करने की आवश्यकता है क्योंकि लेखक केवल कहानियों को अपडेट कर सकते हैं:

service cloud.firestore {
   match /databases/{database}/documents {
     match /stories/{story} {
        function isSignedIn() {
          return request.auth != null;
        }

        function getRole(rsc) {
          return rsc.data.roles[request.auth.uid];
        }

        function isOneOfRoles(rsc, array) {
          return isSignedIn() && (getRole(rsc) in array);
        }

        function isValidNewStory() {
          return request.resource.data.roles[request.auth.uid] == 'owner';
        }

        function onlyContentChanged() {
          // Ensure that title and roles are unchanged and that no new
          // fields are added to the document.
          return request.resource.data.title == resource.data.title
            && request.resource.data.roles == resource.data.roles
            && request.resource.data.keys() == resource.data.keys();
        }

        // Split writing into creation, deletion, and updating. Only an
        // owner can create or delete a story but a writer can update
        // story content.
        allow create: if isValidNewStory();
        allow delete: if isOneOfRoles(resource, ['owner']);
        allow update: if isOneOfRoles(resource, ['owner'])
                      || (isOneOfRoles(resource, ['writer']) && onlyContentChanged());
        allow read: if isOneOfRoles(resource, ['owner', 'writer', 'commenter', 'reader']);

        match /comments/{comment} {
          allow read: if isOneOfRoles(get(/databases/$(database)/documents/stories/$(story)),
                                      ['owner', 'writer', 'commenter', 'reader']);
          allow create: if isOneOfRoles(get(/databases/$(database)/documents/stories/$(story)),
                                        ['owner', 'writer', 'commenter'])
                        && request.resource.data.user == request.auth.uid;
        }
     }
   }
}

step5.rules

सीमाएँ

ऊपर दिखाया गया समाधान सुरक्षा नियमों का उपयोग करके उपयोगकर्ता डेटा को सुरक्षित करना दर्शाता है, लेकिन आपको निम्नलिखित सीमाओं के बारे में पता होना चाहिए:

  • ग्रैन्युलैरिटी : उपरोक्त उदाहरण में, कई भूमिकाओं (लेखक और मालिक) के पास एक ही दस्तावेज़ तक लिखने की पहुंच है लेकिन विभिन्न सीमाओं के साथ। इसे अधिक जटिल दस्तावेज़ों के साथ प्रबंधित करना कठिन हो सकता है और एकल दस्तावेज़ों को एक ही भूमिका के स्वामित्व वाले कई दस्तावेज़ों में विभाजित करना बेहतर हो सकता है।
  • बड़े समूह : यदि आपको बहुत बड़े या जटिल समूहों के साथ साझा करने की आवश्यकता है, तो एक ऐसी प्रणाली पर विचार करें जहां भूमिकाओं को लक्ष्य दस्तावेज़ पर एक फ़ील्ड के बजाय उनके स्वयं के संग्रह में संग्रहीत किया जाता है।