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

১. শুরু করার আগে

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

সাইনড এমবেডিং শুরু হয় একটি বিশেষ লুকার ইউআরএল (Looker URL) তৈরি করার মাধ্যমে, যা আপনি একটি আইফ্রেমে (iframe) ব্যবহার করবেন। এই ইউআরএল-এ থাকে আপনি যে তথ্য শেয়ার করতে চান, আপনার সিস্টেমে থাকা ব্যবহারকারীর আইডি এবং সেই ব্যবহারকারীকে আপনি যে অনুমতিগুলো দিতে চান। এরপর আপনি লুকার কর্তৃক প্রদত্ত একটি গোপন কী (secret key) দিয়ে ইউআরএল-টি সাইন করবেন।

পূর্বশর্ত

  • একটি চলমান লুকার ইনস্ট্যান্স আছে
  • আপনার Looker ইনস্ট্যান্সের প্রশাসক হোন

আপনি যা শিখবেন

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

২. যথাযথ লুকার হোস্টিং

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

প্রোডাকশন সেটআপে থার্ড-পার্টি কুকি মোকাবেলার জন্য আপনাকে নিম্নলিখিত কৌশলগুলোর মধ্যে একটি বেছে নিতে হবে:

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

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

একটি স্বাক্ষরিত এমবেড ইউআরএল তৈরি করতে আপনার লুকার (Looker) থেকে একটি গোপন কী (secret key) প্রয়োজন হবে। এটি করতে:

  1. Looker-এর অ্যাডমিন সেকশনে থাকা এমবেড পেজে যান।
  2. Embed SSO Authentication ড্রপ-ডাউন থেকে Enabled নির্বাচন করুন, এবং তারপর Update নির্বাচন করুন।
  3. আপনার এমবেড সিক্রেট তৈরি করতে এমবেড সিক্রেট সেকশনে থাকা রিসেট সিক্রেট বাটনটি সিলেক্ট করুন।

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

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

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

প্রদর্শিতব্য ডেটার 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

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

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

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

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

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

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

আপনার কোম্পানির ব্যবহারকারী আইডি এবং গ্রুপ

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

প্রাসঙ্গিক হলে, আপনি একটি 'এক্সটার্নাল গ্রুপ আইডি'-ও প্রদান করতে পারেন। এটি আপনার অ্যাপ্লিকেশনে ব্যবহারকারী যে গ্রুপের অন্তর্ভুক্ত, সেই গ্রুপকে শনাক্ত করার একটি অনন্য শনাক্তকারী।

৫. আপনার ইউআরএল তৈরির স্ক্রিপ্টটি বেছে নিন।

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

সৌভাগ্যবশত, Looker-এর looker_embed_sso_examples গিটহাব রিপোজিটরিতে বিভিন্ন প্রোগ্রামিং ভাষায় লেখা বেশ কিছু নমুনা স্ক্রিপ্ট পাওয়া যায়। আপনার জন্য প্রাসঙ্গিক স্ক্রিপ্টটি বেছে নিন এবং আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে কপি করে নিন।

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

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

স্ক্রিপ্টের নাম

আপনার ইনপুটের জন্য আনুমানিক সারি।

LookerEmbedClientExample.java

১৫ - ২৮

csharp_example.cs

১৮ - ৩৫

go_example.go

১৯৩ - ২০২

node_example.js

৮৭ - ১০৪

python_example.py

১০৩ - ১১১

ruby_example.rb

৮৮ - ১০১

sso_embed.php

১৪ - ২৭

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

৭. ইউআরএলটি পরীক্ষা করুন

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

৮. ইউআরএলটি একটি আইফ্রেমে যুক্ত করুন।

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

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

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

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