একটি এক্সটেনশনের জন্য উপযুক্ত অ্যাক্সেস সেট আপ করুন

একটি এক্সটেনশনকে তার নির্দিষ্ট ক্রিয়া সম্পাদন করার জন্য, ফায়ারবেস একটি ইনস্টল করা এক্সটেনশনের প্রতিটি উদাহরণকে একটি পরিষেবা অ্যাকাউন্টের মাধ্যমে প্রকল্প এবং এর ডেটাতে সীমিত অ্যাক্সেস দেয়।

একটি পরিষেবা অ্যাকাউন্ট কী?

একটি পরিষেবা অ্যাকাউন্ট হল একটি বিশেষ ধরণের Google ব্যবহারকারী অ্যাকাউন্ট। এটি এমন একটি অ-মানব ব্যবহারকারীকে প্রতিনিধিত্ব করে যা Google পরিষেবাগুলিতে অনুমোদিত API কল করতে পারে।

একটি এক্সটেনশন ইনস্টল করার সময়, ফায়ারবেস প্রকল্পে এক্সটেনশনের জন্য একটি পরিষেবা অ্যাকাউন্ট তৈরি করে। প্রতিটি ইনস্টল করা এক্সটেনশনের নিজস্ব পরিষেবা অ্যাকাউন্ট থাকে। যদি কোনও এক্সটেনশন ইনস্ট্যান্স আনইনস্টল করা হয়, তাহলে ফায়ারবেস এক্সটেনশনের পরিষেবা অ্যাকাউন্ট মুছে ফেলে।

এক্সটেনশনের জন্য তৈরি পরিষেবা অ্যাকাউন্টগুলি এই ফর্ম্যাটে রয়েছে:

ext- extension-instance-id @ project-id .iam.gserviceaccount.com

ফায়ারবেস এক্সটেনশনের পরিষেবা অ্যাকাউন্টে নির্দিষ্ট ভূমিকা (অনুমতিগুলির বান্ডিল) বরাদ্দ করে একটি প্রকল্প এবং তার ডেটাতে এক্সটেনশনের অ্যাক্সেস সীমিত করে। যখন আপনি একটি এক্সটেনশন তৈরি করেন, তখন আপনি নির্ধারণ করেন যে আপনার এক্সটেনশনটি পরিচালনা করার জন্য কোন ভূমিকাগুলি প্রয়োজন, তারপরে আপনি এই ভূমিকাগুলি এবং আপনার এক্সটেনশনের এই ভূমিকাগুলির প্রয়োজনের কারণগুলি আপনার extension.yaml ফাইলে তালিকাভুক্ত করেন (এই পৃষ্ঠার নীচে উদাহরণ দেখুন)।

আপনার এক্সটেনশনের জন্য কোন ভূমিকাগুলি প্রয়োজন তা নির্ধারণ করুন

যখন আপনি আপনার এক্সটেনশন তৈরি করেন, তখন আপনি নির্ধারণ করেন যে আপনার এক্সটেনশনটি পরিচালনা করার জন্য কতটা অ্যাক্সেস প্রয়োজন।

ইনস্টলেশনের সময়, Firebase CLI ব্যবহারকারীকে প্রতিটি ভূমিকা দ্বারা প্রদত্ত অ্যাক্সেস স্তর গ্রহণ করতে অনুরোধ করে। যদি আপনার এক্সটেনশনটি আসলে প্রয়োজনের চেয়ে বেশি ভূমিকার অনুরোধ করে, তাহলে ব্যবহারকারীরা এটি ইনস্টল করার সম্ভাবনা কম হতে পারে।

1. আপনার এক্সটেনশনটি কোনও পণ্যের সাথে ইন্টারঅ্যাক্ট করে কিনা তা নির্ধারণ করুন:

   • যদি আপনার এক্সটেনশনটি কোনও পণ্যের সাথে ইন্টারঅ্যাক্ট করে , তাহলে আপনাকে আপনার এক্সটেনশনটিকে সেই পণ্যটিতে অ্যাক্সেস দিতে হবে।

     উদাহরণস্বরূপ, যদি আপনার এক্সটেনশনটি একটি Realtime Database ইনস্ট্যান্সে ডেটা লেখে , তাহলে আপনার এক্সটেনশনের একটি Realtime Database ভূমিকা (বিশেষ করে, firebasedatabase.admin ) প্রয়োজন।

   • যদি আপনার এক্সটেনশনটি কোনও পণ্য থেকে কোনও ট্রিগারিং ইভেন্ট শোনে , তাহলে আপনার এক্সটেনশনটির সেই পণ্যের সাথে সম্পর্কিত কোনও ভূমিকার প্রয়োজন নেই ।

     উদাহরণস্বরূপ, যদি আপনার এক্সটেনশনটি Realtime Database ইনস্ট্যান্সে লেখার সময় ট্রিগার হয় (কিন্তু ডাটাবেসে কিছুই লেখে না), তাহলে আপনার এক্সটেনশনের Realtime Database ভূমিকার প্রয়োজন নেই ।

2. আপনার এক্সটেনশন কোন পণ্যগুলির সাথে ইন্টারঅ্যাক্ট করে তা নির্ধারণ করার পরে, আপনাকে সিদ্ধান্ত নিতে হবে যে সেই নির্দিষ্ট ইন্টারঅ্যাকশনের জন্য কোন ভূমিকা প্রয়োজন। কিছু পণ্য সম্পাদিত ক্রিয়া বা ক্রিয়াকলাপের সেটের উপর নির্ভর করে বিভিন্ন ভূমিকা প্রদান করে।

   উদাহরণস্বরূপ, ধরুন আপনার এক্সটেনশনটি একটি Cloud Storage বাকেটের সাথে ইন্টারঅ্যাক্ট করে। storage.objectCreator ভূমিকাটি এক্সটেনশনটিকে Cloud Storage বাকেটের মধ্যে একটি অবজেক্ট তৈরি করার অনুমতি দেবে, কিন্তু সেই ভূমিকাটি এক্সটেনশনটিকে অবজেক্টগুলি দেখতে, মুছে ফেলতে বা ওভাররাইট করার অনুমতি দেবে না। এক্সটেনশনটিকে অতিরিক্ত ক্রিয়া সম্পাদন করতে সক্ষম করতে, আপনাকে পরিবর্তে storage.objectAdmin ভূমিকাটি বরাদ্দ করতে হবে।

আপনার এক্সটেনশনের পরিষেবা অ্যাকাউন্টে আপনি যে সমস্ত সমর্থিত ভূমিকা বরাদ্দ করতে পারেন তা দেখতে এই পৃষ্ঠার নীচের অংশটি দেখুন। প্রতিটি ভূমিকার বিবরণ এবং প্রদত্ত অনুমতি সম্পর্কে জানতে, Firebase ডকুমেন্টেশন বা Google Cloud ডকুমেন্টেশন দেখুন। আপনি Google Cloud কনসোলের IAM এবং অ্যাডমিন প্যানেলেও ভূমিকাগুলি দেখতে পারেন।

একটি এক্সটেনশনে কীভাবে ভূমিকা নির্ধারণ করবেন

আপনার extension.yaml ফাইলের roles বিভাগে আপনার এক্সটেনশনটি পরিচালনা করার জন্য প্রয়োজনীয় IAM ভূমিকাগুলি তালিকাভুক্ত করুন।

এখানে একটি এক্সটেনশনের উদাহরণ দেওয়া হল যা একটি নির্দিষ্ট Firebase Realtime Database পাথ শোনে। ট্রিগার করা হলে, এক্সটেনশনটি একটি ব্যবহারকারী অ্যাকাউন্টের ইমেল ( Firebase Authentication সাথে ইন্টারঅ্যাকশন) আপডেট করে এবং একটি বিজ্ঞপ্তি পাঠায় ( Firebase Cloud Messaging এর সাথে ইন্টারঅ্যাকশন)। নিম্নলিখিতগুলি লক্ষ্য করুন:

• যদিও এক্সটেনশনটি একটি Realtime Database ইভেন্ট থেকে ট্রিগার হয় , firebasedatabase.admin ভূমিকা তালিকাভুক্ত করা হয় না (শ্রবণকে একটি ইন্টারঅ্যাকশন হিসাবে বিবেচনা করা হয় না)।
• যেহেতু এক্সটেনশনটি Authentication এবং Cloud Messaging সাথে ইন্টারঅ্যাক্ট করে , তাই এক্সটেনশনটির সেই পণ্যগুলি অ্যাক্সেস করার জন্য ভূমিকা প্রয়োজন (যথাক্রমে firebaseauth.admin এবং firebasenotifications.admin )।

# extension.yaml
...

# Roles assigned to the extension's service account by Firebase during installation
roles:
  - role: firebaseauth.admin
    reason: Required to update the email address of the user account

  - role: firebasenotifications.admin
    reason: Required to send a notification that the email address has been updated

...

আপনার extension.yaml ফাইলে, একটি এক্সটেনশনের পরিষেবা অ্যাকাউন্টে একটি ভূমিকা নির্ধারণ করতে নিম্নলিখিত ক্ষেত্রগুলি ব্যবহার করুন:

ভূমিকার পরিধি হ্রাস করুন

এক্সটেনশনগুলিকে ন্যূনতম সুবিধার নীতি অনুসরণ করা উচিত এবং কেবলমাত্র তাদের প্রয়োজনীয় সংস্থানগুলিতে অ্যাক্সেসের অনুরোধ করা উচিত। আপনি role.resource ক্ষেত্রটি ব্যবহার করে একটি এক্সটেনশনের অ্যাক্সেসের সুযোগ সীমিত করতে পারেন। উদাহরণস্বরূপ, যদি আপনার এক্সটেনশনকে ক্লাউড স্টোরেজ বাকেটে অবজেক্ট লেখার প্রয়োজন হয়, তাহলে আপনি নিম্নলিখিত ভূমিকাটি ব্যবহার করতে পারেন:

roles:
  - role: storage.objectCreator
    reason: Needed in order to write
    resource: projects/${PROJECT_ID}/buckets/${STORAGE_BUCKET}

এর ফলে এক্সটেনশনটি কেবল তার প্রয়োজনীয় বাকেটটি অ্যাক্সেস করতে পারবে, একই প্রকল্পের অন্যদের নয়।

এই ক্ষেত্রটি প্রকল্প ( projects/{project_id} ) এবং স্টোরেজ বাকেট ( projects/{project_id}/buckets/{bucket_id} ) সমর্থন করে।

এক্সটেনশনের জন্য সমর্থিত ভূমিকা

নিম্নলিখিত টেবিলে Firebase পণ্যের সাথে ইন্টারঅ্যাক্ট করার জন্য সমর্থিত IAM ভূমিকাগুলি তালিকাভুক্ত করা হয়েছে। এই টেবিলের বেশিরভাগ ভূমিকা Firebase পণ্য-স্তরের ভূমিকা , তবে কিছু সরাসরি Google Cloud (বিশেষ করে, Cloud Firestore এবং Cloud Storage ) দ্বারা পরিচালিত হয়।

ফায়ারবেস পণ্য

গুগল ক্লাউড পণ্য

গুগল ক্লাউড ডকুমেন্টেশনে এই ভূমিকাগুলি সম্পর্কে জানুন।