মূল কন্টেন্টে যান

Guest WiFi Captive Portals-এর সাথে WeChat Authentication ইন্টিগ্রেট করা

এই গাইডটি এন্টারপ্রাইজ গেস্ট WiFi captive portals-এ কীভাবে WeChat OAuth 2.0 authentication ইন্টিগ্রেট করতে হয় তা ব্যাখ্যা করে। এতে ডুয়াল-প্ল্যাটফর্ম রেজিস্ট্রেশনের প্রয়োজনীয়তা, ফার্স্ট-পার্টি ডেটা ক্যাপচারের জন্য স্কোপ সিলেকশন, RADIUS Change of Authorization-এর মাধ্যমে নেটওয়ার্ক এনফোর্সমেন্ট এবং GDPR ও চীনের PIPL-এর সাথে কমপ্লায়েন্স কভার করা হয়েছে। হসপিটালিটি, রিটেইল এবং ইভেন্ট খাতের ভেন্যু অপারেটররা এখানে স্কেলে WeChat লগইনসহ guest wifi মোতায়েন করার জন্য বাস্তবসম্মত ইমপ্লিমেন্টেশন স্টেপ, বাস্তব-ক্ষেত্রের কেস স্টাডি এবং সিকিউরিটি হার্ডেনিং গাইডলাইন পাবেন।

📖 8 মিনিট পাঠ📝 1,966 শব্দ🔧 2 সমাধানকৃত উদাহরণ4 অনুশীলনী প্রশ্ন📚 9 মূল সংজ্ঞা

এই গাইডটি শুনুন

পডকাস্ট ট্রান্সক্রিপ্ট দেখুন
ক্যাপটিভ পোর্টালের (CAPTIVE PORTALS) জন্য কীভাবে উইচ্যাট ওঅথ (WECHAT OAUTH) অথেন্টিকেশন কনফিগার করবেন পার্পল (Purple) টেকনিক্যাল ব্রিফিং - আনুমানিক ১০ মিনিট --- ভূমিকা এবং প্রেক্ষাপট (আনুমানিক ১ মিনিট) স্বাগতম। আপনি যদি কোনো হোটেল, রিটেইল চেইন, স্টেডিয়াম বা কনফারেন্স সেন্টারে গেস্ট WiFi-এর দায়িত্বে থাকেন যা চীনা দর্শনার্থীদের পরিষেবা প্রদান করে, তবে এই ব্রিফিংটি আপনার জন্য। Tencent-এর ২০২৪ সালের ডেটা অনুযায়ী, WeChat-এর প্রতি মাসে ১.৩৮ বিলিয়ন সক্রিয় ব্যবহারকারী রয়েছে। এর সিংহভাগই চীনে, তবে আন্তর্জাতিক ক্ষেত্রেও এই প্ল্যাটফর্মের একটি উল্লেখযোগ্য উপস্থিতি রয়েছে - মার্কিন যুক্তরাষ্ট্রে চার মিলিয়ন ব্যবহারকারী, মালয়েশিয়ায় ১২ মিলিয়ন এবং দক্ষিণ-পূর্ব এশিয়া, ইউরোপ ও মধ্যপ্রাচ্য জুড়ে এই সংখ্যা ক্রমাগত বৃদ্ধি পাচ্ছে। যখন একজন চীনা অতিথি আপনার WiFi-এ সংযুক্ত হন এবং শুধুমাত্র ইমেল, ফেসবুক বা কোনো ভাউচার কোড সহ একটি লগইন পৃষ্ঠা দেখতে পান, তখন তারা তাৎক্ষণিক সমস্যার সম্মুখীন হন। সেই ডিভাইসে তাদের স্থানীয় কোনো ইমেল অ্যাড্রেস সেট আপ নাও থাকতে পারে। তবে তাদের WeChat অবশ্যই আছে। সুতরাং, প্রশ্নটি এটি নয় যে আপনার WeChat লগইন অফার করা উচিত কিনা - বরং প্রশ্নটি হলো কীভাবে আপনি এটি সঠিকভাবে, নিরাপদে এবং এমনভাবে কনফিগার করবেন যা ফার্স্ট-পার্টি ডেটা তৈরি করে যা আপনি আসলেই ব্যবহার করতে পারবেন। আজকে আমরা সেই বিষয়টিই কভার করতে যাচ্ছি। আমরা OAuth 2.0 ফ্লো, আপনার প্রয়োজনীয় দুটি প্ল্যাটফর্ম রেজিস্ট্রেশন, স্কোপের সিদ্ধান্ত যা নির্ধারণ করে আপনি কী ডেটা সংগ্রহ করবেন, নেটওয়ার্ক-সাইড এনফোর্সমেন্ট মেকানিজম এবং ২০২৬ সালের জন্য গুরুত্বপূর্ণ কমপ্লায়েন্সের বিষয়গুলো ধাপে ধাপে আলোচনা করব। --- কারিগরি বিস্তারিত বিশ্লেষণ (আনুমানিক ৫ মিনিট) আসুন আর্কিটেকচার দিয়ে শুরু করা যাক। একটি Captive Portal কোনো আন-অথেন্টিকেটেড ডিভাইস থেকে আসা HTTP ট্রাফিককে বাধা দেয় এবং এটিকে একটি লগইন পৃষ্ঠায় রিডাইরেক্ট করে। সেই লগইন পৃষ্ঠাটি একটি পোর্টাল সার্ভারে হোস্ট করা থাকে - যা অন-প্রেমিসেস অথবা ক্লাউডে হতে পারে। আপনি যখন WeChat OAuth যুক্ত করেন, তখন আপনি সেই ফ্লোতে একটি থার্ড-পার্টি আইডেন্টিটি প্রোভাইডার অন্তর্ভুক্ত করছেন। এখানে সিকোয়েন্সটি দেওয়া হলো। অতিথি আপনার SSID-এর সাথে সংযুক্ত হন। অ্যাক্সেস পয়েন্ট বা ওয়্যারলেস কন্ট্রোলার সনাক্ত করে যে ডিভাইসটির কোনো অথেন্টিকেটেড সেশন নেই এবং সমস্ত HTTP ট্রাফিককে আপনার Captive Portal URL-এ রিডাইরেক্ট করে। পোর্টাল পেজটি লোড হয় এবং লগইন অপশনগুলো প্রদর্শন করে - যার মধ্যে WeChat অন্তর্ভুক্ত থাকে। অতিথি WeChat লগইন ট্যাপ করেন। আপনার পোর্টাল সার্ভার ব্রাউজারটিকে WeChat-এর অথরাইজেশন এন্ডপয়েন্টে রিডাইরেক্ট করে, যেখানে আপনার App ID, রিডাইরেক্ট URI, কোডের রেসপন্স টাইপ এবং স্কোপ পাঠানো হয়। WeChat সম্পূর্ণভাবে নিজস্ব সার্ভারে অথেন্টিকেশন পরিচালনা করে। অতিথি যদি ইতিমধ্যে তাদের ব্রাউজারে WeChat-এ লগইন করে থাকেন, তবে তারা একটি কনসেন্ট স্ক্রিন দেখতে পান। তারা যদি WeChat ইন-অ্যাপ ব্রাউজার ব্যবহার করেন, তবে অভিজ্ঞতাটি snsapi বেস স্কোপের সাথে কোনো কনসেন্ট প্রম্পট ছাড়াই নির্বিঘ্ন হতে পারে। WeChat এরপর একটি টেকনিক্যাল অথরাইজেশন কোড সহ আপনার পোর্টালের রিডাইরেক্ট URI-তে ফেরত পাঠায়। আপনার পোর্টাল সার্ভার আপনার App ID, App Secret, কোড এবং অথরাইজেশন কোডের গ্রান্ট টাইপ পাস করে সেই কোডটিকে একটি অ্যাক্সেস টোকেনে রূপান্তর করে। WeChat একটি অ্যাক্সেস টোকেন, একটি রিফ্রেশ টোকেন, ব্যবহারকারীর Open ID এবং অনুমোদিত স্কোপ ফেরত দেয়। আপনি যদি snsapi userinfo স্কোপের জন্য অনুরোধ করে থাকেন, তবে ব্যবহারকারীর ডাকনাম, অ্যাভাটার, লিঙ্গ এবং শহর পুনরুদ্ধার করতে আপনি একটি দ্বিতীয় API কল করতে পারেন।এখন, প্ল্যাটফর্মের রেজিস্ট্রেশন দুটির বিষয়ে আসা যাক। এখানেই অধিকাংশ বাস্তবায়নে ভুল হয়ে থাকে। WeChat-এর দুটি আলাদা ডেভেলপার প্ল্যাটফর্ম রয়েছে। WeChat Open Platform ওয়েবসাইট অ্যাপ্লিকেশন এবং মোবাইল অ্যাপগুলো হ্যান্ডেল করে। WeChat Official Accounts Platform পাবলিক অ্যাকাউন্টগুলো হ্যান্ডেল করে - যা বেশিরভাগ ভেন্যুর আসলে প্রয়োজন হয়। WeChat ইন-অ্যাপ ব্রাউজারের ভেতরে অতিথিদের সেবা দেওয়ার জন্য একটি Captive Portal-এর ক্ষেত্রে আপনার Official Accounts Platform-এ একটি Service Account প্রয়োজন। একটি Subscription Account কাজ করবে না - এতে OAuth ওয়েব পেজ অথরাইজেশন পারমিশন নেই। একটি Service Account-এ এটি আছে এবং এটি snsapi base এবং snsapi userinfo উভয় স্কোপ সমর্থন করে। WeChat-এর বাইরে একটি স্ট্যান্ডার্ড মোবাইল ব্রাউজার - Android-এ Chrome, iOS-এ Safari - থেকে অ্যাক্সেস করা একটি Captive Portal-এর জন্য Open Platform-এ একটি Website Application রেজিস্টার করা প্রয়োজন। এটি snsapi login স্কোপ ব্যবহার করে এবং একটি QR কোড প্রদর্শন করে যা ব্যবহারকারী তাদের WeChat অ্যাপ দিয়ে স্ক্যান করেন। বাস্তবে, অধিকাংশ ভেন্যু ডেপ্লয়মেন্টে উভয়ই ব্যবহার করা হয়। হোটেলের WiFi-এ থাকা একজন অতিথি হয়তো Chrome-এ পোর্টালটি ওপেন করতে পারেন, একটি QR কোড দেখতে পারেন, সেটি WeChat দিয়ে স্ক্যান করতে পারেন এবং অথেন্টিকেট করতে পারেন। অথবা তারা হয়তো WeChat-এর ভেতরে থাকা একটি লিঙ্ক ফলো করতে পারেন, ইন-অ্যাপ ব্রাউজারে ল্যান্ড করতে পারেন এবং snsapi base-এর মাধ্যমে সাইলেন্টলি অথেন্টিকেট করতে পারেন। চলুন স্কোপ নির্বাচন নিয়ে আলোচনা করা যাক, কারণ এটি একটি গুরুত্বপূর্ণ সিদ্ধান্তের জায়গা। snsapi base শুধুমাত্র Open ID রিটার্ন করে - যা আপনার Official Account-এর মধ্যে ওই ব্যবহারকারীর জন্য একটি ইউনিক আইডেন্টিফায়ার। এর জন্য কোনো ব্যবহারকারীর কনসেন্ট প্রম্পটের প্রয়োজন হয় না। অথেন্টিকেশনটি ব্যবহারকারীর কাছে দৃশ্যমান হয় না। এটি সেইসব ফিরে আসা অতিথিদের জন্য আদর্শ যাদের প্রোফাইল আপনি ইতিমধ্যেই তৈরি করেছেন, অথবা এমন ভেন্যুর জন্য যেখানে আপনি জিরো ফ্রিকশন চান। snsapi userinfo ওপেন আইডির পাশাপাশি ব্যবহারকারীর WeChat ডাকনাম, প্রোফাইল পিকচার, জেন্ডার, ল্যাঙ্গুয়েজ সেটিং এবং শহর রিটার্ন করে। এর জন্য একটি স্পষ্ট কনসেন্ট স্ক্রিনের প্রয়োজন হয়। বেশিরভাগ ব্যবহারকারী এটি গ্রহণ করেন, তবে এতে কিছুটা ফ্রিকশন থাকে। সঠিক পছন্দটি নির্ভর করে আপনার ইউজ কেসের ওপর। প্রথমবার আসা কোনো অতিথির রেজিস্ট্রেশনের জন্য যেখানে আপনি একটি প্রোফাইল তৈরি করতে চান, সেখানে snsapi userinfo ব্যবহার করুন এবং আপনার পোর্টাল পেজে একটি GDPR-সম্মত কনসেন্ট লেয়ারের সাথে এটি যুক্ত করুন। ফিরে আসা একজন অতিথি যিনি ইতিমধ্যেই কনসেন্ট দিয়েছেন এবং যার প্রোফাইল আপনার কাছে ইতিমধ্যেই রয়েছে, তাদের সাইলেন্ট রি-অথেন্টিকেশনের জন্য snsapi base ব্যবহার করুন। এখন, নেটওয়ার্ক এনফোর্সমেন্ট সাইডের বিষয়ে। একটি OAuth টোকেন পাওয়া পরিচয় প্রমাণ করে, কিন্তু এটি স্বয়ংক্রিয়ভাবে নেটওয়ার্ক ওপেন করে না। সফল অথেন্টিকেশনকে নেটওয়ার্ক অ্যাক্সেসে রূপান্তর করার জন্য আপনার একটি মেকানিজম প্রয়োজন। দুটি স্ট্যান্ডার্ড পদ্ধতি হলো RADIUS Change of Authorisation (যা RFC 3576-এ সংজ্ঞায়িত) এবং MAC অ্যাড্রেস বাইপাস। RADIUS CoA-এর ক্ষেত্রে, সফল OAuth-এর পর আপনার পোর্টাল সার্ভার নেটওয়ার্ক কন্ট্রোলারে একটি CoA রিকোয়েস্ট পাঠায় এবং কন্ট্রোলারটি ডিভাইসটিকে আন-অথেন্টিকেটেড VLAN থেকে গেস্ট VLAN-এ স্থানান্তরিত করে। এটি Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist এবং বেশিরভাগ এন্টারপ্রাইজ-গ্রেড কন্ট্রোলারের সাথে কাজ করে। MAC বাইপাসের ক্ষেত্রে, পোর্টাল সার্ভার ডিভাইসের MAC অ্যাড্রেসটিকে একটি অথরাইজড ক্লায়েন্ট হিসেবে রেজিস্টার করে এবং কন্ট্রোলার এটিকে অনুমতি দেয়। MAC বাইপাস বাস্তবায়ন করা সহজ কিন্তু এটি কম নিরাপদ, কারণ MAC অ্যাড্রেস স্পুফ করা সম্ভব।Purple-এর Guest WiFi প্ল্যাটফর্ম উভয় প্রক্রিয়াই পরিচালনা করে। WeChat OAuth সম্পন্ন হওয়ার পর, Purple-এর ক্লাউড ওভারলে সংশ্লিষ্ট হার্ডওয়্যারে—সেটি Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme বা Fortinet যা-ই হোক না কেন—উপযুক্ত সংকেত পাঠায়। ভেন্যু অপারেটরকে ম্যানুয়ালি সেই ট্রান্সলেশন পরিচালনা করতে হয় না। --- বাস্তবায়ন সংক্রান্ত সুপারিশ এবং ত্রুটিসমূহ (প্রায় ২ মিনিট) WeChat OAuth Captive Portal বাস্তবায়নের ব্যর্থতার পাঁচটি প্রধান কারণ এখানে উল্লেখ করা হলো। প্রথমত: রিডাইরেক্ট URI অমিল। WeChat প্ল্যাটফর্মে নিবন্ধিত অনুমোদিত ডোমেনের বিপরীতে রিডাইরেক্ট URI যাচাই করে। আপনার পোর্টাল সার্ভার যদি ভিন্ন সাবডোমেন, ভিন্ন পাথ বা HTTPS-এর পরিবর্তে HTTP ব্যবহার করে, তাহলে OAuth ফ্লো error 40029 - invalid code সহ ব্যর্থ হয়। স্টেজিং এনভায়রনমেন্ট সহ আপনার ব্যবহৃত প্রতিটি ডোমেন ভ্যারিয়েন্ট নিবন্ধন করুন। দ্বিতীয়ত: ক্লায়েন্ট সাইডে App Secret রাখা। আপনার App Secret কখনই ক্লায়েন্ট-সাইড JavaScript-এ থাকা উচিত নয়। এটি আপনার সার্ভারে থাকা উচিত। এটি উন্মুক্ত হয়ে গেলে, যে কেউ আপনার অ্যাপ্লিকেশনের ছদ্মবেশ ধারণ করতে পারে এবং আপনার পক্ষে WeChat-এর API কল করতে পারে। তৃতীয়ত: CSRF সুরক্ষার অভাব। OAuth অনুরোধের state প্যারামিটারটি বিশেষভাবে ক্রস-সাইট রিকোয়েস্ট ফরgery প্রতিরোধ করার জন্য তৈরি করা হয়েছে। একটি ক্রিপ্টোগ্রাফিক্যালি র‍্যান্ডম স্টেট ভ্যালু তৈরি করুন, এটি ব্যবহারকারীর সেশনে সংরক্ষণ করুন এবং WeChat রিডাইরেক্ট করার সময় এটি যাচাই করুন। এটি এড়িয়ে গেলে একটি বাস্তব নিরাপত্তা ঝুঁকি তৈরি হয়। চতুর্থত: ইন-অ্যাপ ব্রাউজার সনাক্তকরণে ঘাটতি। WeChat-এর ইন-অ্যাপ ব্রাউজার MicroMessenger সংবলিত একটি নির্দিষ্ট ইউজার এজেন্ট স্ট্রিং সেট করে। আপনার পোর্টাল যদি এটি সনাক্ত করতে না পারে এবং সঠিক OAuth ফ্লো প্রদান না করে, তবে ব্যবহারকারীরা ত্রুটিপূর্ণ অভিজ্ঞতা বা এরর পাবেন। পঞ্চমত: GDPR এবং PIPL-এর সাথে সামঞ্জস্যতা। আপনি যদি ইউরোপীয় ভিজিটরদের পরিষেবা দেন, তবে GDPR প্রযোজ্য হবে। আপনি যদি চীনা ভিজিটরদের পরিষেবা দেন, তবে চীনের Personal Information Protection Law - PIPL - প্রযোজ্য হবে। উভয়ের জন্যই প্রক্রিয়াকরণের আইনি ভিত্তি, স্পষ্ট উদ্দেশ্যের সীমাবদ্ধতা এবং ডেটা মিনিমাইজেশন প্রয়োজন। ডেটা মিনিমাইজেশনের নীতিমালার অধীনে snsapi userinfo-এর চেয়ে snsapi base-কে যুক্তিযুক্ত করা সহজ। আপনি যা-ই সংগ্রহ করুন না কেন, আপনার আইনি ভিত্তি এবং ডেটা সংরক্ষণের সময়কাল নথিবদ্ধ করুন। --- র‌্যাপিড-ফায়ার প্রশ্নোত্তর (প্রায় ১ মিনিট) আমি কি এমন পোর্টালে WeChat লগইন ব্যবহার করতে পারি যা ইমেল এবং SMS লগইনও অফার করে? হ্যাঁ। Purple সহ বেশিরভাগ এন্টারপ্রাইজ পোর্টাল প্ল্যাটফর্ম একই পোর্টাল পেজে একাধিক অথেন্টিকেশন পদ্ধতি সমর্থন করে। WeChat OAuth কি iOS-এ কাজ করে? হ্যাঁ। iOS-এ Safari-তে WeChat লগইন QR কোড ফ্লো বা রিডাইরেক্ট ফ্লো-এর মাধ্যমে কাজ করে। WeChat অ্যাপ নিজেই অথেন্টিকেশন পরিচালনা করে। WeChat-এর API অনুপলব্ধ থাকলে কী হবে? একটি ফলব্যাক প্রয়োগ করুন। WeChat API কল টাইমআউট হলে বা এরর দেখালে, ব্যবহারকারীকে একটি বিকল্প লগইন পদ্ধতিতে রিডাইরেক্ট করুন। আমি কি ওপেন আইডি-কে একটি স্থায়ী গ্রাহক সনাক্তকারী হিসেবে ব্যবহার করতে পারি? আপনার অফিসিয়াল অ্যাকাউন্টের মধ্যে, হ্যাঁ। একাধিক প্রপার্টি জুড়ে ক্রস-অ্যাকাউন্ট আইডেন্টিটি রেজোলিউশনের জন্য, পরিবর্তে UnionID ব্যবহার করুন। --- সংক্ষিপ্তসার এবং পরবর্তী পদক্ষেপ (প্রায় ১ মিনিট) সংক্ষেপে বলতে গেলে। captive portals-এর জন্য WeChat OAuth অথেন্টিকেশন হলো দুটি প্ল্যাটফর্মে রেজিস্ট্রেশন প্রক্রিয়া, একটি স্কোপ নির্ধারণের সিদ্ধান্ত, একটি নেটওয়ার্ক এনফোর্সমেন্ট ইন্টিগ্রেশন এবং একটি কমপ্লায়েন্স রিভিউ। এই চারটি জিনিস সঠিকভাবে সম্পন্ন করতে পারলে আপনি এমন একটি লগইন পদ্ধতি পাবেন যা কোনো পাসওয়ার্ডের ঝামেলা ছাড়াই ১০০ কোটিরও বেশি সম্ভাব্য ভিজিটরকে সেবা প্রদান করতে পারবে। পরবর্তী বাস্তবসম্মত পদক্ষেপগুলো হলো: আপনার ভিজিটররা WeChat ইন-অ্যাপ ব্রাউজারের ভেতরে নাকি একটি স্ট্যান্ডার্ড মোবাইল ব্রাউজারে পোর্টালটির সম্মুখীন হচ্ছেন তা নির্ধারণ করা। স্কোপের বিষয়ে সিদ্ধান্ত নিন - নিয়মিত ভিজিটরদের জন্য snsapi base, আর প্রথমবারের মতো রেজিস্ট্রেশনের জন্য সম্মতিসহ snsapi userinfo। আপনার নেটওয়ার্ক হার্ডওয়্যার RADIUS CoA সমর্থন করে কিনা তা নিশ্চিত করুন। GDPR এবং PIPL-এর সাথে আপনার প্রাইভেসি নোটিশটি মিলিয়ে দেখে নিন। লাইভ করার আগে রিডাইরেক্ট URI, স্টেট প্যারামিটার ভ্যালিডেশন এবং ইন-অ্যাপ ব্রাউজার ডিটেকশন পরীক্ষা করুন। Purple কীভাবে একটি বৃহত্তর গেস্ট WiFi এবং অ্যানালিটিক্স প্ল্যাটফর্মের অংশ হিসেবে WeChat OAuth পরিচালনা করে - যা ২০২৪ সালে ৮০,০০০ ভেন্যু এবং ৪৪ কোটি লগইন জুড়ে বিস্তৃত ছিল - তা দেখতে চাইলে purple.ai-তে ভিজিট করুন অথবা আপনার অ্যাকাউন্ট টিমের সাথে কথা বলুন। শোনার জন্য ধন্যবাদ। --- END OF SCRIPT

header_image.png

摘要

当中国访客连接到您的企业网络并遇到一个仅提供电子邮件、Facebook或凭证代码的 Captive Portal 时,您会立即产生摩擦。根据腾讯2024年的数据,微信拥有13.8亿月活跃用户。集成微信登录 guest wifi 功能并不是一种款待便利,而是在没有摩擦的情况下捕获该人群第一方数据的技术要求。

本指南详细介绍了将微信 OAuth 2.0 身份验证集成到 captive portals 的技术架构。它解释了支持标准移动浏览器和微信应用内浏览器所需的双平台注册,评估了用于数据收集的 snsapi_basesnsapi_userinfo 作用域之间的权衡,并概述了如何使用 RADIUS 授权变更 (CoA) 或 MAC 身份验证旁路来强制网络访问。它还涵盖了在 Cisco Meraki、HPE Aruba、Ruckus、Juniper Mist、Ubiquiti UniFi、Cambium、Extreme 和 Fortinet 基础设施中大规模部署此功能所需的安全配置和合规性指令——GDPR 和中国《个人信息保护法》(PIPL)。


技术深度剖析:微信 OAuth 2.0 架构

Captive Portal 会拦截来自未验证设备的 HTTP 流量,并将其重定向到托管在门户服务器上的登录页面。添加微信身份验证会使用 OAuth 2.0 协议将第三方身份验证提供商插入到此流程中,该协议与 Google、Microsoft Entra ID 和 Okta 用于联合身份验证的标准相同。

oauth_flow_diagram.png

认证流程的操作如下:访客连接到 SSID。接入点或无线控制器检测到未认证的会话,并将 HTTP 流量重定向到 Captive Portal URL。访客在 Portal 页面上选择微信登录。Portal 服务器将浏览器重定向到 open.weixin.qq.com 的微信授权端点,并传递 AppID、重定向 URI、code 的响应类型以及请求的 Scope。微信在其自己的服务器上处理认证。如果访客在微信内置浏览器中使用 snsapi_base Scope,则认证是无感知的——不会出现授权同意提示。如果使用 snsapi_userinfo,微信会显示一个授权同意页面。随后,微信将带着临时授权码重定向回 Portal 的重定向 URI。Portal 服务器通过调用 api.weixin.qq.com/sns/oauth2/access_token 并传递 AppIDAppSecret、该授权码以及 authorization_code 的授权类型,来将此授权码交换为 Access Token。微信将返回 Access Token、Refresh Token、用户的 OpenID 以及已授予的 Scope。如果授予了 snsapi_userinfo,服务器会发起第二次 API 调用,以获取用户的昵称、头像、性别和城市。

双平台注册要求

大多数实施方案都在注册阶段失败。微信运营着两个独立的开发者平台,而企业级部署通常两者都需要。

平台 URL 所需账号类型 支持的 Scope 浏览器环境
公众平台 mp.weixin.qq.com 服务号 snsapi_base, snsapi_userinfo 微信内置浏览器
开放平台 open.weixin.qq.com 网站应用 snsapi_login 标准移动浏览器

对于在微信内置浏览器内访问 Portal 的访客,您需要在公众平台上拥有一个服务号。订阅号将无法工作——它缺少 OAuth 网页授权权限。对于从 Android 上的 Chrome 或 iOS 上的 Safari 访问 Portal 的访客,您需要在开放平台上拥有一个网站应用,该应用使用 snsapi_login Scope 并显示一个二维码供用户扫描。

在实际操作中,大多数场所部署都会同时使用两者。酒店的访客可能会在 Chrome 中打开 Portal,看到一个二维码,用微信扫描它并进行认证。或者他们可能会直接点击微信内的链接,进入内置浏览器,并通过 snsapi_base 进行无感知认证。

Scope 选择:数据获取 vs. 用户摩擦

scope_comparison.png

您请求的 Scope 决定了您收集的数据以及访客体验到的摩擦。这是一个涉及合规性影响的实际决策点。

snsapi_base 仅返回 OpenID——即该用户在您公众号内的唯一标识符。它不需要用户同意授权提示。身份验证对访客是无感知的。适用于您已拥有其个人资料的返店访客,或者在您优先考虑无摩擦接入的场景。在 GDPR 和 PIPL 数据最小化原则下,snsapi_base 更容易证明其合理性。

snsapi_userinfo 返回 OpenID 以及用户的昵称、头像、性别和城市。它需要一个明确的授权同意页面。适用于需要建立个人资料的首次访客注册,并配合您 Portal 页面上符合合规要求的授权同意层。

跨门店部署的 UnionID

OpenID 针对用户与特定公众号的组合是唯一的。一家拥有 20 家门店且每家门店都有自己公众号的酒店集团,对于同一位访客会看到 20 个不同的 OpenID。UnionID 解决了这个问题。它是一个单一标识符,代表同一开放平台账号下链接的所有公众号和应用中的用户。将您的公众号链接到您的开放平台账号,OAuth 响应中就会返回 UnionID。这是跨门店访客识别的基础。


实施指南

网络强制执行机制

获取 OAuth 令牌仅能证明身份,并不能打开网络。您必须向控制器发送信号以允许流量通过。

RADIUS 授权变更 (CoA)(在 RFC 3576 中定义)是推荐的企业级方法。OAuth 验证成功后,Portal 服务器向网络控制器发送 CoA 请求。控制器将设备从认证前 VLAN 移动到访客 VLAN。这适用于 Cisco Meraki、HPE Aruba、Ruckus、Juniper Mist、Ubiquiti UniFi、Cambium、Extreme 和 Fortinet。

MAC 认证绕过 (MAB) 将设备的 MAC 地址作为已授权客户端注册到 RADIUS 数据库中。控制器根据该 MAC 允许访问。MAB 较易实施,但并不可靠:现代 iOS 和 Android 设备默认会随机化 MAC 地址,从而在重新连接时中断会话关联。

Purple 的 Guest WiFi 平台可自动完成此转换。微信 OAuth 完成后,Purple 的云端覆盖网络向底层硬件发送相应的 CoA 或 MAB 信号,从而免去了手动配置 VLAN 的麻烦。

安全配置

以下三项配置是不容妥协的。

  1. 保护 AppSecret。 AppSecret 绝不能出现在客户端 JavaScript 中。它必须保留在您的服务器上。如果泄露,攻击者可以冒充您的应用程序并代表您调用微信 API。
  2. 实施 CSRF 防护。 生成一个加密随机的 state 值,将其存储在用户会话中,并在微信重定向返回时进行验证。这可以防止 RFC 6749 中定义的跨站请求伪造攻击。
  3. 注册所有重定向 URI 变体。 微信会根据您注册的域名验证重定向 URI。请注册您使用的每一个子域名和路径变体(包括暂存环境),以防止出现 40029 错误(无效的代码)。

应用内浏览器检测

微信的应用内浏览器会设置包含 MicroMessenger 的用户代理(user agent)字符串。您的 Captive Portal 必须检测此字符串并进行相应路由:应用内浏览器使用公众号流程,标准浏览器使用开放平台二维码流程。如果未能检测到该字符串,会导致体验中断或身份验证错误。

hotel_wechat_wifi.png


最佳实践与合规性

GDPR 合规性

如果您服务于欧洲访客或在欧洲运营,GDPR 适用于您通过微信 OAuth 收集的数据。您必须确定合规的处理依据——通常是征得同意或合法利益。在进行身份验证之前,您必须在 Captive Portal 上提供清晰的隐私声明。您必须响应主体访问请求和删除请求。有关详细的合规框架,请参阅 合规手册:GDPR 与访客 WiFi 数据隐私

PIPL 合规性

当您处理中国公民的个人数据时,中国《个人信息保护法》(PIPL)适用。与 GDPR 类似,PIPL 要求明确的目的限制、数据最小化以及书面的合法依据。在数据最小化原则下,snsapi_basesnsapi_userinfo 更容易证明其合理性。无论您收集什么数据,请在上线前记录您的法律依据和保存期限。

网络隔离

使用 VLAN 隔离将访客 WiFi 流量与您的企业网络隔离开来。通过微信验证的访客应接入专用的访客 VLAN,且仅能访问互联网——无法访问内部系统。这符合 PCI DSS 对持卡人数据环境隔离的要求以及一般的企业安全实践。有关隔离架构的更多信息,请参阅 带宽管理:2026年实用指南

备用身份验证

如果微信的 API 不可用,您的门户必须重定向到替代的登录方式。不要让访客面对空白屏幕。提供电子邮箱或短信的备用方案可确保连贯性。这对于 交通运输医疗保健 环境中的场所尤为重要,在这些环境中,网络连接是一项服务义务。


真实案例研究

酒店业:奢华酒店集团

伦敦的一家拥有 400 间客房的奢华酒店接待了大量来自中国大陆的宾客。他们原有的 Captive Portal 要求提供电子邮件地址和短信验证。中国手机号码经常无法收到来自欧洲运营商的短信,而且许多宾客的设备上没有配置本地电子邮箱。这导致 Portal 的流失率高达 60%。

该酒店在公众号平台注册了服务号,并在开放平台注册了网站应用。Portal 检测到 MicroMessenger 用户代理,并为应用内浏览器用户触发 snsapi_base——在不到三秒的时间内将他们连接,且无需授权提示页面。通过 Chrome 或 Safari 访问的宾客则会看到一个二维码。在后续入住时,系统会识别出相同的 OpenID,并对宾客进行静默免密认证。酒店的 CRM 系统会记录该宾客的再次到访,从而实现有针对性的入店前沟通。有关在酒店环境中部署 WiFi 的更多信息,请参阅 酒店行业

零售:购物中心分析

一家大型购物中心希望获取中国消费者的受众特征数据,以辅助招商组合和营销决策。他们需要了解客源城市、性别和到访频率。此时仅靠 snsapi_base 远远不够——他们需要 snsapi_userinfo。Portal 会请求完整的 userinfo 作用域。宾客会看到微信授权提示页面,并点击允许。该购物中心与 Purple 的 WiFi Analytics 集成的分析平台接收到了经过验证的受众特征数据流。在周六下午,40% 的 WiFi 用户来自特定区域。该数据直接决定了应该接洽哪些品牌来举办快闪活动。有关零售 WiFi 部署的更多信息,请参阅 零售行业


故障排查与风险规避

微信 OAuth Captive Portal 部署中最常见的五种故障模式如下:

重定向 URI 不匹配(错误码 40029)。 微信会根据已注册的域名验证重定向 URI。任何子域名、路径或协议的不匹配都会导致 code 交换失败。请注册所有变体,包括暂存(staging)环境。

AppSecret 泄露。 将 AppSecret 嵌入在客户端代码中是最严重的安全错误。请将所有 token 交换逻辑转移到服务器端。

缺少 CSRF 保护。 忽略 state 参数验证会使 Portal 易受跨站请求伪造攻击。请为每个会话生成一个加密的随机值,并在回调时进行验证。

应用内浏览器检测失败。 未能在用户代理中检测到 MicroMessenger 意味着应用内浏览器用户将被提供错误的 OAuth 流程,从而导致报错。

MAC地址随机化破坏MAB会话。 现代移动操作系统会随机化MAC地址。使用基于MAB强制执行的访客在重新连接时将丢失其会话。升级到RADIUS CoA以实现可靠的会话管理。有关安全WiFi配置的指导,请参阅 什么是安全WiFi:2026年企业基本指南


投资回报率(ROI)与业务影响

部署微信登录访客WiFi功能具有三个可衡量的影响。

提高身份验证率。 消除短信验证失败点和电子邮件输入要求,可以提高成功连接的中国访客比例。对于不支持微信的Captive Portal,60%的流失率是一个现实的基准线。

第一方数据质量。 经微信验证的个人资料包括一个经过验证的OpenID,并且通过 snsapi_userinfo,可以直接获取来自该社交平台的受众特征属性。这些数据可以注入分析平台,以推动定向营销,而无需依赖第三方Cookie。

减少支持开销。 无缝登录减少了前台和IT支持人员处理国际访客连接故障排除的呼叫量。

Purple在超过80,000个场所中运营,并在2024年处理了4.4亿次登录(Purple内部数据)。该平台已通过ISO 27001认证,符合GDPR和CCPA,并保持99.999%的在线率。对于 零售酒店餐饮 行业的场所,微信身份验证将网络从成本中心转变为可靠的第一方数据采集渠道。

মূল সংজ্ঞাসমূহ

Captive portal

একটি ওয়েব পেজ যা কোনো অথেন্টিকেট না হওয়া ডিভাইস থেকে আসা HTTP ট্র্যাফিককে আটকে দেয় এবং নেটওয়ার্ক অ্যাক্সেস দেওয়ার আগে ব্যবহারকারীকে এটির সাথে ইন্টারঅ্যাক্ট করতে বলে।

প্রাথমিক ইন্টারফেস যেখানে গেস্টদের জন্য WeChat লগইন অপশনটি প্রদর্শন করা হয়। পোর্টাল সার্ভার এই পেজটি হোস্ট করে এবং OAuth ফ্লো পরিচালনা করে।

OAuth 2.0

একটি ইন্ডাস্ট্রি-স্ট্যান্ডার্ড অথরাইজেশন প্রোটোকল (RFC 6749) যা কোনো থার্ড-পার্টি অ্যাপ্লিকেশনকে ব্যবহারকারীর পক্ষে একটি HTTP সার্ভিসে সীমিত অ্যাক্সেস পাওয়ার অনুমতি দেয়।

ব্যবহারকারীর ক্রেডেনশিয়াল প্রকাশ না করে পোর্টাল সার্ভারে অথেন্টিকেশন টোকেন পাস করার জন্য WeChat যে অন্তর্নিহিত প্রোটোকলটি ব্যবহার করে। Microsoft Entra ID, Okta এবং Google Workspace-এর দ্বারা ব্যবহৃত একই প্রোটোকল।

OpenID

একটি নির্দিষ্ট Official Account-এর জন্য কোনো নির্দিষ্ট WeChat ব্যবহারকারীকে দেওয়া একটি অনন্য আলফানিউমেরিক আইডেন্টিফায়ার।

WiFi অ্যানালিটিক্স ডেটাবেসে ফিরে আসা গেস্টদের সনাক্ত করার জন্য প্রাথমিক কী (primary key) হিসেবে ব্যবহৃত হয়। প্রতিটি Official Account অনুযায়ী এটি পরিবর্তিত হয় - একাধিক প্রোপার্টিতে সনাক্তকরণের জন্য UnionID ব্যবহার করুন।

UnionID

একটি একক WeChat আইডেন্টিফায়ার যা একই Open Platform অ্যাকাউন্টের সাথে লিঙ্ক করা সমস্ত Official Accounts এবং অ্যাপস জুড়ে একজন ব্যবহারকারীকে উপস্থাপন করে।

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

RADIUS CoA (Change of Authorization)

RADIUS প্রোটোকলের (RFC 3576) একটি এক্সটেনশন যা একটি RADIUS সার্ভারকে কোনো অ্যাক্টিভ সেশনের অথরাইজেশন অ্যাট্রিবিউট ডায়নামিকালি পরিবর্তন করার অনুমতি দেয়।

সফল WeChat লগইনের পর একটি গেস্ট ডিভাইসকে একটি বিচ্ছিন্ন প্রি-অথেন্টিকেশন VLAN থেকে অ্যাক্টিভ ইন্টারনেট VLAN-এ নিয়ে যাওয়ার জন্য ব্যবহৃত সুরক্ষিত পদ্ধতি। Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme এবং Fortinet দ্বারা সমর্থিত।

snsapi_base

একটি WeChat OAuth স্কোপ যা শুধুমাত্র ব্যবহারকারীর OpenID প্রদান করে এবং এর জন্য ব্যবহারকারীর কাছ থেকে কোনো সম্মতির অনুরোধের প্রয়োজন হয় না।

ফিরে আসা গেস্টদের রি-অথেন্টিকেশনের জন্য প্রস্তাবিত স্কোপ। GDPR এবং PIPL-এর ডেটা মিনিমাইজেশন নীতিমালার অধীনে এটি সমর্থন করা সহজ।

snsapi_userinfo

একটি WeChat OAuth স্কোপ যা ব্যবহারকারীর OpenID, ডাকনাম, অবতার, জেন্ডার এবং শহর প্রদান করে এবং এর জন্য একটি স্পষ্ট সম্মতি স্ক্রিনের প্রয়োজন হয়।

প্রথমবার গেস্ট রেজিস্ট্রেশনের জন্য ব্যবহৃত হয় যেখানে অ্যানালিটিক্সের জন্য ডেমোগ্রাফিক ডেটার প্রয়োজন হয়। GDPR এবং PIPL-এর অধীনে ডকুমেন্টেড বৈধ ভিত্তি থাকা আবশ্যক।

PIPL (Personal Information Protection Law)

চীনের ব্যাপক ডেটা প্রাইভেসি আইন, যা নভেম্বর ২০২১ থেকে কার্যকর হয়েছে এবং চীনে অবস্থিত প্রাকৃতিক ব্যক্তিদের ব্যক্তিগত তথ্য প্রক্রিয়াকরণ নিয়ন্ত্রণ করে।

যখন ভেন্যুগুলো WeChat OAuth-এর মাধ্যমে চীনা নাগরিকদের ডেটা প্রসেস করে তখন এটি প্রযোজ্য হয়। এর জন্য স্পষ্ট সম্মতি, উদ্দেশ্যের সীমাবদ্ধতা, ডেটা মিনিমাইজেশন এবং একটি মুছে ফেলার মেকানিজম প্রয়োজন।

AppSecret

অ্যাপ্লিকেশন রেজিস্ট্রেশনের সময় WeChat দ্বারা জারি করা একটি গোপনীয় ক্রিপ্টোগ্রাফিক কি (key), যা পোর্টাল সার্ভার থেকে আসা API কলগুলোকে অথেন্টিকেট করতে ব্যবহৃত হয়।

এটি শুধুমাত্র সার্ভার সাইডে সংরক্ষণ করা আবশ্যক। ক্লায়েন্ট-সাইড JavaScript-এ এটি প্রকাশ হয়ে গেলে আক্রমণকারীরা অ্যাপ্লিকেশনের ছদ্মবেশ ধারণ করতে পারে এবং ক্ষতিকারকভাবে WeChat API কল করতে পারে।

সমাধানকৃত উদাহরণসমূহ

লন্ডনের একটি ৪০০ রুমের লাক্সারি হোটেলে মূল ভূখণ্ডের চীন থেকে আসা অতিথিদের মধ্যে ৬০% পোর্টাল ড্রপ-অফ রেট রয়েছে। বর্তমান পোর্টালে ইমেল এবং SMS ভেরিফিকেশনের প্রয়োজন হয়। IT ডিরেক্টরকে GDPR কমপ্লায়েন্স এবং নেটওয়ার্ক সিকিউরিটি বজায় রেখে WeChat authentication ইমপ্লিমেন্ট করতে হবে।

ধাপ ১: WeChat Official Accounts Platform (mp.weixin.qq.com)-এ একটি সার্ভিস অ্যাকাউন্ট এবং WeChat Open Platform (open.weixin.qq.com)-এ একটি ওয়েবসাইট অ্যাপ্লিকেশন রেজিস্টার করুন। ধাপ ২: MicroMessenger ইউজার এজেন্ট স্ট্রিং সনাক্ত করতে পোর্টাল কনফিগার করুন। যদি সনাক্ত করা যায়, তবে সাইলেন্ট অথেন্টিকেশনের জন্য snsapi_base OAuth ফ্লো ট্রিগার করুন। যদি সনাক্ত না করা যায়, তবে QR কোড ফ্লো প্রদর্শন করুন। ধাপ ৩: WeChat লগইন বোতামটি সক্রিয় করার আগে পোর্টাল পেজে একটি GDPR-কমপ্লায়েন্ট প্রাইভেসি নোটিশ এবং কনসেন্ট চেকবক্স যোগ করুন। নোটিশে অবশ্যই উল্লেখ থাকতে হবে: সংগৃহীত ডেটা (শুধুমাত্র OpenID), উদ্দেশ্য (গেস্ট WiFi অ্যাক্সেস এবং ফিরতি ভিজিট সনাক্তকরণ) এবং রিটেনশন পিরিয়ড। ধাপ ৪: সফল OAuth টোকেন বিনিময়ের পর, পোর্টাল সার্ভার Cisco Meraki কন্ট্রোলারে একটি RADIUS CoA রিকোয়েস্ট পাঠায়, যা গেস্ট ডিভাইসটিকে প্রি-অথ অথেনটিকেশন VLAN থেকে সেগমেন্টেড গেস্ট VLAN-এ স্থানান্তরিত করে। ধাপ ৫: গেস্ট ডেটাবেসে ডিভাইসের MAC অ্যাড্রেসের বিপরীতে OpenID স্টোর করুন। পরবর্তী ভিজিটগুলোতে, ফিরে আসা OpenID সাইলেন্ট রি-অথেন্টিকেশন ট্রিগার করবে।

পরীক্ষকের মন্তব্য: এই পদ্ধতিটি টেকনিক্যাল এবং কমপ্লায়েন্স উভয় প্রয়োজনীয়তাই সঠিকভাবে পূরণ করে। snsapi_base ব্যবহার করা GDPR ডেটা মিনিমাইজেশন নীতির সাথে সামঞ্জস্যপূর্ণ, যা SMS ভেরিফিকেশন ব্যর্থতার সমস্যা দূর করার পাশাপাশি আইনি ঝুঁকি হ্রাস করে। RADIUS CoA নিরাপদ ও স্বয়ংক্রিয় নেটওয়ার্ক সেগমেন্টেশন নিশ্চিত করে। কনসেন্ট চেকবক্সটি একটি নথিবদ্ধ আইনি ভিত্তির জন্য GDPR-এর প্রয়োজনীয়তা পূরণ করে। মূল সিদ্ধান্তটি হলো snsapi_userinfo-এর পরিবর্তে snsapi_base ব্যবহার করা - এই ব্যবহারের ক্ষেত্রে হোটেলের ডেমোগ্রাফিক ডেটার প্রয়োজন নেই, তাই এটি সংগ্রহ করলে অপ্রয়োজনীয় কমপ্লায়েন্সের বাধ্যবাধকতা তৈরি হতো।

একটি রিটেইল মল গেস্ট WiFi-এর মাধ্যমে চীনা ক্রেতাদের কাছ থেকে জেন্ডার এবং সিটি ডেটা ক্যাপচার করে তাদের অ্যানালিটিক্স প্ল্যাটফর্মে যুক্ত করতে চায়। তারা বর্তমানে HPE Aruba হার্ডওয়্যারে চলমান তাদের বর্তমান পোর্টালের জন্য MAC Authentication Bypass ব্যবহার করছে।

ধাপ ১: WeChat Official Accounts Platform-এ একটি সার্ভিস অ্যাকাউন্ট রেজিস্টার করুন। ধাপ ২: জেন্ডার এবং সিটি পুনরুদ্ধার করতে snsapi_userinfo স্কোপ ব্যবহার করার জন্য পোর্টাল কনফিগার করুন। ধাপ ৩: প্রোফাইল ডেটা অ্যাক্সেসের বিনিময়ে ফ্রি WiFi পাওয়ার বিষয়টিকে ব্যাখ্যা করে একটি স্পষ্ট কনসেন্ট স্ক্রিন যোগ করুন। GDPR এবং PIPL উভয়ের অধীনেই এই কনসেন্ট অবশ্যই স্পষ্ট এবং গ্র্যানুলার হতে হবে। ধাপ ৪: অথেন্টিকেশনের পর, পোর্টাল সার্ভার RADIUS ডেটাবেসে ডিভাইসের MAC অ্যাড্রেস রেজিস্টার করে। HPE Aruba কন্ট্রোলার MAB-এর মাধ্যমে অ্যাক্সেসের অনুমতি দেয়। ধাপ ৫: একটি ডেটা প্রসেসিং রেজিস্টারে আইনি ভিত্তি (কনসেন্ট), উদ্দেশ্য (ভেন্যু অ্যানালিটিক্স এবং মার্কেটিং) এবং রিটেনশন পিরিয়ড (২৪ মাস) নথিবদ্ধ করুন। ডেটা ডিলিট করার একটি মেকানিজম প্রদান করুন।

পরীক্ষকের মন্তব্য: snsapi_userinfo স্কোপটি প্রয়োজনীয় ডেমোগ্রাফিক ডেটা সঠিকভাবে পুনরুদ্ধার করে। তবে, MAB-এর ওপর নির্ভর করা একটি বড় অপারেশনাল ঝুঁকি তৈরি করে: iOS 14+ এবং Android 10+ ডিফল্টভাবে MAC অ্যাড্রেস র্যান্ডমাইজ করে, যার অর্থ গেস্টরা পুনরায় কানেক্ট করার সময় তাদের অথেন্টিকেটেড সেশন হারাবে এবং তাদের আবার রি-অথেন্টিকেট করতে বাধ্য করা হবে। মলের উচিত এটি সমাধান করতে HPE Aruba-তে RADIUS CoA-তে মাইগ্রেট করার পরিকল্পনা করা। PIPL কমপ্লায়েন্স ডকুমেন্টেশন ঐচ্ছিক নয় - ভেন্যু যেখানেই অবস্থিত হোক না কেন, চীনা নাগরিকদের ডেটা প্রসেস করার জন্য এটি একটি আইনি প্রয়োজনীয়তা।

অনুশীলনী প্রশ্নসমূহ

Q1. আপনি একটি স্টেডিয়ামে একটি Captive Portal স্থাপন করছেন। আপনি চান যে ফিরে আসা সিজন টিকিটধারীরা যারা পূর্বে অথেনটিকেশন করেছেন তারা পরবর্তী ভিজিটগুলোতে কোনও লগইন স্ক্রীন না দেখেই স্বয়ংক্রিয়ভাবে সংযুক্ত হোক। রি-অথেনটিকেশন ফ্লো-এর জন্য আপনার কোন WeChat OAuth স্কোপটি প্রয়োগ করা উচিত এবং কেন?

ইঙ্গিত: বিবেচনা করুন কোন স্কোপটি প্রতিটি ভিজিটে ব্যবহারকারীকে সম্মতির অনুরোধ না জানিয়েই সাইলেন্ট অথেনটিকেশন করার অনুমতি দেয়।

মডেল উত্তর দেখুন

snsapi_base ব্যবহার করুন। এই স্কোপটি শুধুমাত্র ব্যবহারকারীর OpenID প্রদান করে এবং এর জন্য কোনো সম্মতির অনুরোধের প্রয়োজন হয় না, যা সাইলেন্ট রি-অথেনটিকেশন সক্ষম করে। প্রথম ভিজিটে, আপনি ফ্যানের প্রোফাইলে OpenID সংরক্ষণ করেন। পরবর্তী ভিজিটগুলোতে, পোর্টাল snsapi_base-এর মাধ্যমে ফিরে আসা OpenID শনাক্ত করে, মিল নিশ্চিত করে এবং অ্যাক্সেস দেওয়ার জন্য একটি RADIUS CoA ইস্যু করে - যার কোনোটিতেই ফ্যানকে কোনো লগইন স্ক্রীন দেখতে হয় না। এটি GDPR-এর ডেটা মিনিমাইজেশন নীতির সাথেও সামঞ্জস্যপূর্ণ, কারণ আপনি অথেনটিকেশন ফাংশনের জন্য প্রয়োজনীয় ডেটার বাইরে অতিরিক্ত কোনো ডেটা সংগ্রহ করছেন না।

Q2. পরীক্ষার সময়, আপনার পোর্টাল সফলভাবে WeChat-এ রিডাইরেক্ট করে, ব্যবহারকারী সম্মতি দেয় এবং WeChat আপনার পোর্টালে ফিরে রিডাইরেক্ট করে। তবে, পোর্টাল সার্ভার লগগুলো OAuth ত্রুটি 40029 (অবৈধ কোড) দেখায়। সবচেয়ে সম্ভাব্য কনফিগারেশন ত্রুটি কী এবং আপনি কীভাবে এটি সমাধান করবেন?

ইঙ্গিত: WeChat কঠোরভাবে যাচাই করে যে এটি অথরাইজেশন কোডটি একটি নিবন্ধিত তালিকার বিপরীতে কোন গন্তব্যে পাঠাচ্ছে কিনা।

মডেল উত্তর দেখুন

সবচেয়ে সম্ভাব্য কারণ হলো একটি রিডাইরেক্ট URI অমিল। WeChat প্ল্যাটফর্মে নিবন্ধিত অনুমোদিত ডোমেনের বিপরীতে OAuth অনুরোধে থাকা রিডাইরেক্ট URI যাচাই করে। যদি পোর্টাল সার্ভার অন্য সাবডোমেন, অন্য পাথ বা HTTPS-এর পরিবর্তে HTTP ব্যবহার করে, তবে কোড বিনিময়টি ত্রুটি 40029 সহ ব্যর্থ হয়। সমাধান: WeChat ডেভেলপার প্ল্যাটফর্মে লগইন করুন, আপনার Service Account বা Website Application সেটিংসে যান এবং আপনার ব্যবহৃত প্রতিটি রিডাইরেক্ট URI ভেরিয়েন্ট যোগ করুন - যার মধ্যে স্টেজিং সাবডোমেন, বিভিন্ন পাথ এবং HTTPS সংস্করণ অন্তর্ভুক্ত রয়েছে। নিশ্চিত করুন যে আপনার OAuth অনুরোধের redirect_uri প্যারামিটারটি URL এনকোডিংসহ নিবন্ধিত URI গুলোর মধ্যে যেকোনো একটির সাথে হুবহু মিলে যায়।

Q3. একজন আইটি ম্যানেজার সরাসরি ক্লায়েন্ট ব্রাউজার থেকে টোকেন বিনিময় প্রক্রিয়া দ্রুত করতে Captive Portal-এর ফ্রন্ট-এন্ড জাভাস্ক্রিপ্টে WeChat AppSecret এম্বেড করার প্রস্তাব করছেন। কেন আপনাকে অবশ্যই এই প্রস্তাবটি প্রত্যাখ্যান করতে হবে এবং সঠিক আর্কিটেকচারটি কী?

ইঙ্গিত: পাবলিকলি অ্যাক্সেসযোগ্য কোডে ক্রিপ্টোগ্রাফিক কি (key) এক্সপোজ করার সিকিউরিটি প্রভাবগুলো বিবেচনা করুন।

মডেল উত্তর দেখুন

এই প্রস্তাবটি প্রত্যাখ্যান করুন। AppSecret হলো একটি গোপন ক্রিপ্টোগ্রাফিক কি। এটিকে ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্টে এম্বেড করলে এটি যে কেউ পৃষ্ঠার সোর্স কোড দেখে বা নেটওয়ার্ক ট্র্যাফিক ইন্টারসেপ্ট করে দেখতে পারে। একজন আক্রমণকারী AppSecret বের করে নিতে পারে এবং অ্যাপ্লিকেশনের ছদ্মবেশ ধারণ করে ভেন্যুর পক্ষে WeChat API কল করতে পারে, ব্যবহারকারীর ডেটা অ্যাক্সেস করতে পারে এবং সম্ভাব্যভাবে সম্পূর্ণ অফিসিয়াল অ্যাকাউন্টটিকে ঝুঁকিতে ফেলতে পারে। সঠিক আর্কিটেকচার: ক্লায়েন্ট-সাইড পোর্টাল পৃষ্ঠাটি WeChat থেকে অথরাইজেশন কোড গ্রহণ করে এবং একটি সার্ভার-সাইড API কলের মাধ্যমে পোর্টাল সার্ভারে পাঠায়। পোর্টাল সার্ভার একটি নিরাপদ এনভায়রনমেন্ট ভেরিয়েবলে AppSecret রাখে এবং WeChat API-এর সাথে টোকেন বিনিময় সম্পন্ন করে। AppSecret কখনই সার্ভার ছেড়ে বাইরে যায় না।

Q4. ইউরোপজুড়ে ১৫টি প্রপার্টি থাকা একটি হোটেল গ্রুপ একটি ইউনিফাইড গেস্ট প্রোফাইল তৈরি করতে চায় যা বুঝতে পারবে কখন একই চীনা অতিথি বিভিন্ন প্রপার্টিতে অবস্থান করছেন। প্রতিটি প্রপার্টির নিজস্ব WeChat অফিসিয়াল অ্যাকাউন্ট রয়েছে। তাদের কোন WeChat আইডেন্টিফায়ার ব্যবহার করা উচিত এবং কী কনফিগারেশন প্রয়োজন?

ইঙ্গিত: OpenID হলো অ্যাকাউন্ট-নির্দিষ্ট। ক্রস-অ্যাকাউন্ট স্বীকৃতির জন্য ডিজাইন করা একটি ভিন্ন আইডেন্টিফায়ার রয়েছে।

মডেল উত্তর দেখুন

UnionID ব্যবহার করুন। OpenID প্রতিটি অফিসিয়াল অ্যাকাউন্টের জন্য পরিবর্তিত হয়, তাই একই অতিথির ১৫টি ভিন্ন অ্যাকাউন্টের জন্য ১৫টি ভিন্ন OpenID থাকবে। UnionID হলো একটি স্থিতিশীল আইডেন্টিফায়ার যা একই ওপেন প্ল্যাটফর্ম অ্যাকাউন্টের সাথে লিঙ্ক করা সমস্ত অফিসিয়াল অ্যাকাউন্ট এবং অ্যাপ জুড়ে একজন ব্যবহারকারীকে প্রতিনিধিত্ব করে। প্রয়োজনীয় কনফিগারেশন: সমস্ত ১৫টি অফিসিয়াল অ্যাকাউন্টকে একটি একক WeChat ওপেন প্ল্যাটফর্ম অ্যাকাউন্টের সাথে লিঙ্ক করুন। একবার লিঙ্ক হয়ে গেলে, ব্যবহারকারী লিঙ্ক করা অ্যাকাউন্টগুলোর মধ্যে অন্তত একটি অনুমোদন করলে OAuth রেসপন্সে UnionID প্রদান করা হয়। ক্রস-প্রপার্টি প্রোফাইল তৈরি করতে এবং ফিরে আসা অতিথিরা কোন প্রপার্টিতে ভিজিট করছেন তা বিবেচনা না করেই তাদের সনাক্ত করতে গেস্ট CRM-এ প্রাইমারি কি (key) হিসাবে UnionID ব্যবহার করুন।

এই সিরিজে পড়া চালিয়ে যান

B2B Captive Portals ডিজাইন করা: নিবন্ধিত নাম এবং কোম্পানির ডেটা সংগ্রহ করা

এই নির্দেশিকাটি IT ম্যানেজার এবং ভেন্যু অপারেটরদের B2B captive portals ডিজাইন করার জন্য একটি ভেন্ডর-নিরপেক্ষ প্রযুক্তিগত কাঠামো প্রদান করে। এটি নিবন্ধিত নাম এবং কোম্পানির ডেটা ক্যাপচার করার জন্য কীভাবে রেজিস্ট্রেশন ফিল্ড গঠন করা যায় তা বিস্তারিত ব্যাখ্যা করে, যা GDPR সম্মতি বজায় রেখে এবং অ্যাকাউন্ট-স্তরের ইন্টেলিজেন্স তৈরি করার পাশাপাশি উচ্চ সমাপ্তির হার নিশ্চিত করে।

গাইডটি পড়ুন →

ক্যাপটিভ পোর্টাল আর্কিটেকচার: নিরাপত্তা, রিডাইরেকশন এবং সর্বোত্তম অনুশীলন

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

গাইডটি পড়ুন →

B2B Captive Portals অপ্টিমাইজ করা: কোম্পানির নাম এবং পেশাদার ডেটা সংগ্রহ করা

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে IT ম্যানেজার, নেটওয়ার্ক আর্কিটেক্ট এবং ভেন্যু অপারেশন ডিরেক্টররা WiFi লগইনের সময় পেশাদার ডেটা - কোম্পানির নাম, চাকরির পদবি এবং ব্যবসায়িক ইমেল ঠিকানা - সংগ্রহ করতে B2B captive portals কনফিগার করতে পারেন। এটি VLAN আইসোলেশন এবং RADIUS অথেনটিকেশন থেকে শুরু করে Salesforce এবং HubSpot-এর সাথে CRM ইন্টিগ্রেশন পর্যন্ত সম্পূর্ণ প্রযুক্তিগত আর্কিটেকচার কভার করে, যার মধ্যে GDPR এবং CCPA কমপ্লায়েন্স বিল্ট-ইন রয়েছে। যে ভেন্যুগুলো এটি সঠিকভাবে স্থাপন করে তারা তাদের গেস্ট WiFi নেটওয়ার্ককে একটি ফার্স্ট-পার্টি ডেটা ইঞ্জিন এবং স্বয়ংক্রিয় লিড জেনারেশন সিস্টেমে রূপান্তরিত করে।

গাইডটি পড়ুন →