লুকারের সাথে এম্বেডিং স্বাক্ষরিত

1. আপনি শুরু করার আগে

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

স্বাক্ষরিত এম্বেডিং একটি বিশেষ লুকার URL তৈরি করার সাথে শুরু হয় যা আপনি একটি আইফ্রেমে ব্যবহার করবেন। ইউআরএল-এ আপনি যে তথ্য শেয়ার করতে চান, আপনার সিস্টেমের ব্যবহারকারীর আইডি এবং সেই ব্যবহারকারীর কাছে আপনি যে অনুমতি চান তা রয়েছে। তারপরে আপনি লুকার দ্বারা প্রদত্ত একটি গোপন কী দিয়ে URL-এ স্বাক্ষর করবেন৷

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

পূর্বশর্ত

• একটি চলমান Looker উদাহরণ আছে
• আপনার লুকার উদাহরণে একজন প্রশাসক হোন

আপনি কি শিখবেন

• সাইনড এম্বেডিংয়ের অনুমতি দেওয়ার জন্য কীভাবে আপনার লুকার উদাহরণ সেটআপ করবেন
• কিভাবে একটি গোপন কী তৈরি করতে হয়
• আপনার স্বাক্ষরিত এম্বেড URL-এ অন্তর্ভুক্তির জন্য আপনাকে কোন তথ্য সংগ্রহ করতে হবে৷
• কিভাবে একটি স্বাক্ষরিত এম্বেড URL তৈরি করবেন
• আপনার অ্যাপ্লিকেশনে এমবেডেড আইটেমটি কীভাবে যুক্ত করবেন

2. সঠিক লুকার হোস্টিং

কিছু ব্রাউজার একটি নিরাপত্তা নীতিতে ডিফল্ট করে যা থার্ড-পার্টি কুকিজকে ব্লক করে, যা সাইনড এম্বেডিংকে কাজ করা থেকে বাধা দেবে। এই কোডল্যাবের জন্য, এই সমস্যাটি সমাধান করার সবচেয়ে সহজ উপায় হল সাময়িকভাবে আপনার ব্রাউজারে তৃতীয় পক্ষের কুকিজকে অনুমতি দেওয়া:

• ক্রোমে কুকিজ সক্ষম করুন
• ফায়ারফক্সে কুকিজ সক্রিয় করুন
• সাফারিতে কুকিজ সক্ষম করুন

একটি প্রোডাকশন সেটআপে আপনাকে অবশ্যই তৃতীয় পক্ষের কুকিজ মোকাবেলার জন্য নিম্নলিখিত কৌশলগুলির মধ্যে একটি বেছে নিতে হবে:

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

3. একটি গোপন কী তৈরি করুন

একটি স্বাক্ষরিত এম্বেড URL তৈরি করতে আপনার লুকার থেকে একটি গোপন কী প্রয়োজন হবে৷ এটি করতে:

1. লুকারের অ্যাডমিন বিভাগে এম্বেড পৃষ্ঠায় যান।
2. এম্বেড SSO প্রমাণীকরণ ড্রপ-ডাউন থেকে সক্ষম নির্বাচন করুন এবং তারপরে আপডেট নির্বাচন করুন।
3. আপনার এম্বেড সিক্রেট জেনারেট করতে এম্বেড সিক্রেট বিভাগে রিসেট সিক্রেট বোতামটি নির্বাচন করুন।

একটি নিরাপদ স্থানে এই গোপনীয়তাটি অনুলিপি করুন, কারণ আপনি এটি পুনরায় সেট না করে লুকার থেকে এটি পুনরুদ্ধার করতে সক্ষম হবেন না৷ কী রিসেট করলে পুরনো কী ব্যবহার করা যেকোনো এম্বেড ভেঙে যাবে।

গোপন কী সহ যে কেউ যেকোন ব্যবহারকারী হিসাবে, যেকোন অনুমতি নিয়ে যেকোন লুকার মডেলে অ্যাক্সেস সহ একটি URL তৈরি করতে পারে। আপনি লুকার অ্যাডমিন শংসাপত্রের মতো স্বাক্ষরিত এম্বেড গোপনীয়তা রক্ষা করুন ৷

4. স্বাক্ষরিত এম্বেড ইউআরএলে ইনপুট সংগ্রহ করুন

একটি স্বাক্ষরিত এম্বেড URL তৈরি করতে আপনাকে নিম্নলিখিত তথ্য সংগ্রহ করতে হবে।

প্রদর্শিত ডেটার URL

লুক, এক্সপ্লোর, কোয়েরি ভিজ্যুয়ালাইজেশন বা ড্যাশবোর্ডের URL পুনরুদ্ধার করুন যা আপনি এম্বেড করতে চান। তারপর ডোমেনটি সরান এবং পাথের আগে /embed করুন।

উদাহরণস্বরূপ, https://instance_name.cloud.looker.com/looks/4 হয়ে যাবে /embed/looks/4 ।

অথবা, https://instance_name.cloud.looker.com/explore/my_model/my_explore হয়ে যাবে /embed/explore/my_model/my_explore ।

আপনি এমবেডেড ব্যবহারকারীর কাছে যে অনুমতিগুলি চান

আপনি এমবেডেড ব্যবহারকারীর কাছে যে অনুমতিগুলি চান তা চয়ন করুন৷ স্বাক্ষরিত এম্বেডিংয়ের জন্য প্রাসঙ্গিক অনুমতিগুলি লুকারের স্বাক্ষরিত এম্বেডিং ডকুমেন্টেশন পৃষ্ঠায় পাওয়া যাবে।

এই কোডল্যাবের উদ্দেশ্যে নিম্নলিখিত অনুমতিগুলি একটি ন্যূনতম কার্যকর তালিকা হতে পারে:

• access_data
• see_lookml_dashboards
• see_looks
• see_user_dashboards
• explore

আপনি যদি একটি এম্বেড ব্যবহারকারীদের বিষয়বস্তু ব্রাউজ এবং সংরক্ষণ করার ক্ষমতা পরীক্ষা করতে চান, তাহলে আপনি বিবেচনা করতে পারেন:

• save_content
• embed_browse_spaces
• embed_save_shared_space

আপনি এমবেডেড ব্যবহারকারীর কাছে মডেল অ্যাক্সেস করতে চান

আপনি এমবেডেড ব্যবহারকারীর অ্যাক্সেস পেতে চান এমন লুকার মডেলগুলি চয়ন করুন৷ অন্তত, ব্যবহারকারীর সেই মডেলে অ্যাক্সেস থাকা উচিত যা লুক, এক্সপ্লোর, ক্যোয়ারী ভিজ্যুয়ালাইজেশন, বা ড্যাশবোর্ড যা আপনি প্রদর্শনের জন্য বেছে নিয়েছেন।

ব্যবহারকারীর বৈশিষ্ট্যগুলি আপনি এমবেডেড ব্যবহারকারীর কাছে রাখতে চান

লুকার ব্যবহারকারীর বৈশিষ্ট্যগুলি বেছে নিন যা আপনি এমবেডেড ব্যবহারকারীর কাছে রাখতে চান, যদি থাকে। এই কোডল্যাবের জন্য কোনো ব্যবহারকারীর গুণাবলী যোগ করার প্রয়োজন নাও হতে পারে।

গ্রুপ আপনি এমবেডেড ব্যবহারকারী আছে চান

ব্যবহারকারীর কোন গ্রুপ আইডি (গ্রুপের নাম নয়) তা নির্ধারণ করুন, যদি থাকে। এই কোডল্যাবের জন্য কোনো গ্রুপ যোগ করার প্রয়োজন নাও হতে পারে।

আপনার কোম্পানির ইউজার আইডি এবং গ্রুপ

লুকার স্বাক্ষরিত এম্বেড ইউআরএলগুলির জন্য আপনাকে আপনার অ্যাপ্লিকেশনের প্রতিটি ব্যবহারকারীর জন্য একটি অনন্য শনাক্তকারী প্রদান করতে হবে যা একটি এমবেডেড লুকার উপাদান দেখে। লুকার এটিকে "বাহ্যিক ব্যবহারকারী আইডি" বলে এবং এটি যেকোনো স্ট্রিং হতে পারে।

প্রাসঙ্গিক হলে, আপনি একটি "বহিরাগত গ্রুপ আইডি" প্রদান করতে পারেন। এটি একটি অনন্য শনাক্তকারী যে গোষ্ঠীর ব্যবহারকারী আপনার অ্যাপ্লিকেশনের অন্তর্গত।

5. আপনার URL প্রজন্মের স্ক্রিপ্ট চয়ন করুন

একটি সঠিক স্বাক্ষরিত এম্বেড ইউআরএল তৈরি করার জন্য আপনাকে কোড ব্যবহার করতে হবে, যাতে আপনি আপনার গোপন কী দিয়ে ইউআরএলটি সঠিকভাবে এনকোড করতে পারেন এবং অন্যান্য নিরাপত্তা-সম্পর্কিত আইটেম তৈরি করতে পারেন।

সৌভাগ্যবশত, বিভিন্ন প্রোগ্রামিং ভাষায় বেশ কিছু নমুনা স্ক্রিপ্ট লুকারের looker_embed_sso_examples Github সংগ্রহস্থলে পাওয়া যায়। আপনার জন্য প্রাসঙ্গিক স্ক্রিপ্ট চয়ন করুন এবং এটি আপনার উন্নয়ন পরিবেশে অনুলিপি করুন।

6. ডেটা পূরণ করুন এবং স্ক্রিপ্ট চালান

আপনি যে ইউআরএল জেনারেশন স্ক্রিপ্টটি বেছে নিয়েছেন তাতে ভেরিয়েবল বা একটি বস্তু থাকবে যেখানে আপনি আপনার পূর্বে সংগৃহীত সমস্ত তথ্য রাখতে পারবেন, সেই তথ্যটি কীভাবে উপস্থাপন করা উচিত তার উদাহরণ সহ:

স্ক্রিপ্ট নাম	অ্যাপক্স আপনার ইনপুট জন্য সারি
LookerEmbedClientExample.java	15 - 28
csharp_example.cs	18 - 35
go_example.go	193 - 202
node_example.js	87 - 104
python_example.py	103 - 111
ruby_example.rb	88 - 101
sso_embed.php	14 - 27

আপনি যে ডেটা সংগ্রহ করেছেন তার সাথে উদাহরণগুলি প্রতিস্থাপন করার পরে, আপনার স্বাক্ষরিত এম্বেড URL তৈরি করতে স্ক্রিপ্টটি চালান৷ পরবর্তী ধাপের জন্য URL টি নোট করুন।

7. URL পরীক্ষা করুন

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

8. একটি আইফ্রেমে URL এম্বেড করুন

অবশেষে, একটি iframe এর src বৈশিষ্ট্যে আপনার তৈরি করা URL যোগ করে আপনার অ্যাপ্লিকেশনে আপনার লুক, এক্সপ্লোর, ক্যোয়ারী ভিজ্যুয়ালাইজেশন বা ড্যাশবোর্ড এম্বেড করুন। আপনার অ্যাপ্লিকেশন বা পরীক্ষার পরিবেশে সেই আইফ্রেমটি রাখুন।

আপনি আপনার কোডল্যাব ইউআরএল কোথায় এম্বেড করবেন সে বিষয়ে সতর্ক থাকুন। যদি আইফ্রেমটি আপনার ছাড়া অন্য কেউ অ্যাক্সেসযোগ্য হয়, তাহলে সেই ব্যক্তি আপনার কনফিগার করা অনুমতি এবং ডেটা অ্যাক্সেস লাভ করবে।

যদি ইচ্ছা হয়, আপনি লুকারের এমবেডেড জাভাস্ক্রিপ্ট ইভেন্টগুলি ব্যবহার করে জাভাস্ক্রিপ্ট ব্যবহার করে আইফ্রেমের সাথে ইন্টারঅ্যাক্ট করতে পারেন।

9. অতিরিক্ত তথ্য

এম্বেড করা ব্যবহারকারীরা আপনার পছন্দসই ডেটা দৃশ্যমানতা এবং অনুমতিগুলির মধ্যে সীমাবদ্ধ রয়েছে তা নিশ্চিত করার জন্য লুকারের স্বাক্ষরিত এম্বেডিং বৈশিষ্ট্যটি সাবধানে কনফিগার করা উচিত। নিম্নলিখিত বিবেচনা করুন:

• লুকারের স্বাক্ষরিত এমবেডিং ডকুমেন্টেশন পৃষ্ঠাটি সমস্ত উপলব্ধ কনফিগারেশন বিকল্পগুলির সাথে একটি স্বাক্ষরিত এম্বেড ইউআরএল কীভাবে তৈরি করা উচিত সে সম্পর্কে গভীর বিবরণ প্রদান করে।
• এম্বেড করা বিশ্লেষণী ডকুমেন্টেশন পৃষ্ঠার জন্য লুকারের নিরাপত্তা সর্বোত্তম অনুশীলনগুলি স্বাক্ষরিত এম্বেডিং নিরাপদে কনফিগার করার জন্য নির্দেশিকা প্রদান করে।
• স্বাক্ষরিত এম্বেডিং প্রায়ই লুকার গ্রাহকরা তাদের নিজস্ব ক্লায়েন্টদের কাছে ডেটা উপস্থাপন করতে ব্যবহার করে, যখন বিভিন্ন কোম্পানি বা গোষ্ঠীর ক্লায়েন্টরা একে অপরের সম্পর্কে জানেন না। এই পরিস্থিতিতে আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি লুকারকে একটি বন্ধ সিস্টেম হিসাবে কনফিগার করুন, কখনও কখনও এটিকে "মাল্টিটেন্যান্ট ইনস্টলেশন" বলা হয়।
• স্বাক্ষরিত এম্বেডিং কার্যকারিতা Looker's API এর মাধ্যমে উপলব্ধ ।