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

UniFi captive portal সেটআপ গাইড

কীভাবে Ubiquiti UniFi-এ একটি Purple captive portal যুক্ত করবেন: সঠিক কনফিগারেশনের জন্য Purple-এর ধাপে ধাপে সেটআপ গাইডের লিঙ্ক সহ একটি এক্সটার্নাল পোর্টাল সার্ভার, কন্ট্রোলার অথরাইজেশন এবং একটি walled garden।

প্রকাশিত হালনাগাদ করা হয়েছে
📖 2 মিনিট পাঠ447 শব্দ5 মূল সংজ্ঞা

Video overview

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

পডকাস্ট ট্রান্সক্রিপ্ট দেখুন
Ubiquiti UniFi-এর জন্য Captive Portal - একটি Purple টেকনিক্যাল ব্রিফিং [ভূমিকা ও প্রসঙ্গ - আনুমানিক ১ মিনিট] Purple টেকনিক্যাল ব্রিফিং সিরিজে আপনাকে স্বাগত জানাই। আমি আপনার হোস্ট এবং আজ আমরা Ubiquiti UniFi ইনফ্রাস্ট্রাকচারে একটি এক্সটার্নাল captive portal স্থাপন করার সুনির্দিষ্ট বিষয়গুলো নিয়ে আলোচনা করব - যা বিশ্বব্যাপী আতিথেয়তা, খুচরা বিক্রেতা এবং এন্টারপ্রাইজ পরিবেশে সবচেয়ে ব্যাপকভাবে ব্যবহৃত নেটওয়ার্ক প্ল্যাটফর্মগুলোর মধ্যে একটি। আপনি যদি একজন IT ম্যানেজার, নেটওয়ার্ক আর্কিটেক্ট, বা সিস্টেম ইন্টিগ্রেটর হন যিনি UniFi Cloud Gateways, Dream Machines, বা UniFi Network Application নিয়ে কাজ করছেন, তবে এই পর্বটি আপনার জন্য। আমরা বিস্তারিতভাবে আলোচনা করব কীভাবে এক্সটার্নাল পোর্টাল মেকানিজমটি ব্যাক-এন্ডে কাজ করে, কীভাবে এটি সঠিকভাবে কনফিগার করতে হয়, সাধারণ সমস্যাগুলো কোথায় হতে পারে এবং কেন একটি সাধারণ স্প্ল্যাশ পেজের চেয়ে বেশি প্রয়োজন এমন স্থানগুলোর জন্য UniFi স্থাপনের ওপর Purple যুক্ত করা সঠিক আর্কিটেকচারাল সিদ্ধান্ত। চলুন শুরু করা যাক। [প্রযুক্তিগত বিস্তারিত আলোচনা - আনুমানিক ৫ মিনিট] প্রথমে আমাদের বুঝতে হবে যখন একজন গেস্ট captive portal সক্রিয় থাকা কোনো UniFi SSID-এ কানেক্ট করেন, তখন আসলে কী ঘটে। যখন একটি গেস্ট ডিভাইস আপনার গেস্ট SSID-এর সাথে যুক্ত হয়, তখন UniFi Access Point স্বাভাবিকভাবেই DHCP-এর মাধ্যমে এটিকে একটি IP অ্যাড্রেস বরাদ্দ করে। কিন্তু ডিভাইসটি অবিলম্বে একটি "পেন্ডিং" স্টেটে চলে যায় যা UniFi-এর পরিভাষায় বলা হয়ে থাকে। এই স্টেটে, AP-এর বিল্ট-ইন DNSmasq প্রসেস ডিভাইসটির করা প্রতিটি DNS কোয়েরি ইন্টারসেপ্ট করে, ডিভাইসটি কোন DNS সার্ভার ব্যবহার করছে বলে ভাবছে তা বিবেচনা না করেই। AP সমস্ত DNS ট্রাফিক নিজের দিকে রিডাইরেক্ট করে। একই সাথে, AP পোর্ট ৮০-তে একটি লাইটওয়েট HTTP রিডাইরেক্টর চালায়। গেস্টের ব্রাউজার যখনই কোনো HTTP রিকোয়েস্ট করে - এবং এটিই মূল বিষয়, HTTP, HTTPS নয় - তখনই রিডাইরেক্টরটি একটি ৩০২ রিডাইরেক্ট পাঠায়, যা ব্রাউজারকে captive portal স্প্ল্যাশ পেজে নিয়ে যায়। এই মেকানিজমটিই iOS এবং Android ডিভাইসে "Sign in to WiFi" নোটিফিকেশনটি ট্রিগার করে। এখন, এখানেই বিল্ট-ইন পোর্টাল বনাম এক্সটার্নাল পোর্টালের পার্থক্যটি অত্যন্ত গুরুত্বপূর্ণ হয়ে ওঠে। বিল্ট-ইন UniFi Hotspot Portal-এর ক্ষেত্রে, স্প্ল্যাশ পেজটি সরাসরি UniFi Network Application দ্বারা পরিবেশিত হয়। এটি কার্যকর, এটি সেট আপ করা দ্রুত, তবে এটি অত্যন্ত সীমিত। আপনি এতে বেসিক পাসওয়ার্ড অথেনটিকেশন, ভাউচার এবং Stripe পেমেন্ট পাবেন। কোনো ইমেল ক্যাপচার, কোনো সোশ্যাল লগইন, কোনো GDPR কনসেন্ট ম্যানেজমেন্ট, কোনো CRM ইন্টিগ্রেশন এবং সেশন কাউন্টের বাইরে কোনো অর্থপূর্ণ অ্যানালিটিক্স নেই। যখন আপনি একটি External Portal Server কনফিগার করেন - যা আজকে আমাদের মূল আলোচনার বিষয় - তখন আপনি UniFi কন্ট্রোলারকে নির্দেশ দিচ্ছেন গেস্টদের সম্পূর্ণ আলাদা একটি ওয়েব অ্যাপ্লিকেশনে রিডাইরেক্ট করার জন্য। আমাদের ক্ষেত্রে, সেটি হলো Purple। External Portal Server ফিল্ডে আপনি যে URL-টি এন্টার করেন তা সেই সমস্ত ৩০২ রিডাইরেক্টের গন্তব্য হয়ে ওঠে। সেই রিডাইরেক্ট URL সম্পর্কে গুরুত্বপূর্ণ প্রযুক্তিগত বিবরণ এখানে দেওয়া হলো। যখন UniFi কোনো অতিথিকে আপনার বাহ্যিক পোর্টালে রিডাইরেক্ট করে, তখন এটি URL-এর সাথে বেশ কয়েকটি কোয়েরি প্যারামিটার যুক্ত করে। এর মধ্যে রয়েছে: AP MAC অ্যাড্রেস, ক্লায়েন্ট ডিভাইসের MAC অ্যাড্রেস, একটি Unix টাইমস্ট্যাম্প, ক্লায়েন্ট যে আসল URL-এ পৌঁছানোর চেষ্টা করছিল সেটি এবং SSID নাম। আপনার বাহ্যিক পোর্টাল - এই ক্ষেত্রে Purple - সেই প্যারামিটারগুলো ক্যাপচার করে, কানেক্ট করা ডিভাইসটিকে শনাক্ত করতে সেগুলো ব্যবহার করে, উপযুক্ত স্প্ল্যাশ পেজ দেখায়, অথেন্টিকেশন পরিচালনা করে এবং তারপর সেই MAC অ্যাড্রেসটিকে অথরাইজ করার জন্য UniFi Network Application-এ একটি API কল ব্যাক করে। সেই API কলটি হলো অত্যন্ত গুরুত্বপূর্ণ হ্যান্ডশেক। UniFi Network Application 9.1 এবং পরবর্তী সংস্করণ অনুযায়ী, সঠিক কী-ভিত্তিক অথেন্টিকেশন সহ একটি অফিসিয়াল REST API রয়েছে। অথরাইজেশন এন্ডপয়েন্টটি হলো সাইট API-এর ভার্সন ওয়ানের একটি POST রিকোয়েস্ট, যা নির্দিষ্ট ক্লায়েন্ট ID-কে লক্ষ্য করে, একটি JSON বডি সহ যা মিনিটে সময়সীমা, মেগাবাইটে ডেটা ব্যবহারের সীমা এবং প্রতি সেকেন্ডে কিলোবিটে রেট লিমিট নির্ধারণ করতে পারে। কন্ট্রোলার যখন সেই অথরাইজেশন পেয়ে যায়, তখন এটি AP-তে নির্দেশ পাঠায় এবং অতিথি পেন্ডিং থেকে অথরাইজড অবস্থায় চলে যায়। ইন্টারনেট অ্যাক্সেস মঞ্জুর করা হয়। এখন আসুন Walled Garden সম্পর্কে কথা বলি, যাকে UniFi Pre-Authorization Access বলে। এটি হলো ডোমেন এবং IP অ্যাড্রেসের হোয়াইটলিস্ট যা অতিথিরা অথেন্টিকেট করার আগেই অ্যাক্সেস করতে পারেন। এটি অত্যন্ত প্রয়োজনীয় এবং এটি ভুল কনফিগারেশনের সবচেয়ে সাধারণ উৎসগুলোর একটি। ন্যূনতমপক্ষে, আপনার walled garden-এ আপনার Purple পোর্টালের ফুল্লি কোয়ালিফাইড ডোমেন নাম এবং Purple-এর ইনফ্রাস্ট্রাকচার যে IP অ্যাড্রেস বা CIDR রেঞ্জে নির্দেশ করে তা অন্তর্ভুক্ত থাকতে হবে। আপনি যদি সোশ্যাল লগইন - Facebook, Google, Microsoft - ব্যবহার করেন, তবে আপনাকে সেই প্রদানকারীদের OAuth এন্ডপয়েন্ট ডোমেনগুলোও যোগ করতে হবে। Google-এর লগইন এন্ডপয়েন্টগুলো একাধিক IP রেঞ্জ এবং accounts.google.com ও oauth2.googleapis.com সহ বেশ কয়েকটি ডোমেন জুড়ে বিস্তৃত। Facebook-এর লগইন ইনফ্রাস্ট্রাকচারের জন্যও একইভাবে বেশ কয়েকটি এন্ট্রি প্রয়োজন। Purple-এর ডকুমেন্টেশনে প্রয়োজনীয় সঠিক এন্ট্রিগুলোর একটি রক্ষণাবেক্ষণ করা তালিকা দেওয়া থাকে এবং সেই প্রদানকারীরা তাদের ইনফ্রাস্ট্রাকচার আপডেট করার সাথে সাথে এই তালিকাটি আপ-টু-ডেট রাখা হয়। UniFi-এর ক্ষেত্রে একটি নির্দিষ্ট জটিলতা রয়েছে যা অনেক ডেপ্লয়মেন্টে সমস্যা তৈরি করে। AP-তে থাকা HTTP রিডাইরেক্টর কেবল পোর্ট 80-তে প্লেইন HTTP ট্রাফিক ইন্টারসেপ্ট করে। আধুনিক ডিভাইসগুলো - iOS, Android, Windows, macOS - সবই HTTPS-ভিত্তিক captive portal ডিটেকশন পরিচালনা করে। Apple ডিভাইসগুলো HTTPS-এর মাধ্যমে captive.apple.com-এ হিট করে। Android ডিভাইসগুলো connectivitycheck.gstatic.com-এ হিট করে। যদি সেই HTTPS রিকোয়েস্টগুলো কোনো নির্দিষ্ট রেসপন্স না পায়, তবে ডিভাইসটি সিদ্ধান্ত নিতে পারে যে সেখানে কোনো captive portal নেই এবং কেবল সাইন-ইন প্রম্পট দেখাতে ব্যর্থ হতে পারে। এর সমাধান হলো এটি নিশ্চিত করা যাতে আপনার walled garden-এ প্রধান অপারেটিং সিস্টেমগুলোর captive portal ডিটেকশন ডোমেনগুলো অন্তর্ভুক্ত থাকে এবং আপনার Purple পোর্টালটি যাতে একটি বৈধ, বিশ্বস্ত SSL সার্টিফিকেট সহ HTTPS-এর মাধ্যমে অ্যাক্সেসযোগ্য হয়। সেলফ-সাইনড সার্টিফিকেটগুলো ব্রাউজারে সিকিউরিটি ওয়ার্নিং তৈরি করবে যা পোর্টাল লোড হতে বাধা দেয়। প্রোডাকশন ডেপ্লয়মেন্টের জন্য এটি নিয়ে কোনো আপস করা যাবে না।অন্যান্য UniFi-নির্দিষ্ট বিবেচ্য বিষয়টি হলো কন্ট্রোলারের অ্যাক্সেসযোগ্যতা। API অথোরাইজেশন কলগুলো সফল করার জন্য UniFi Network Application - তা ক্লাউড গেটওয়ে, ক্লাউড কি বা স্ব-হোস্ট করা সার্ভারে চলুক না কেন - অবশ্যই Purple-এর পরিকাঠামো থেকে অ্যাক্সেসযোগ্য হতে হবে। আপনার কন্ট্রোলার যদি NAT-এর পিছনে একটি প্রাইভেট নেটওয়ার্কে থাকে, তবে আপনাকে নিশ্চিত করতে হবে যে প্রাসঙ্গিক API পোর্টগুলো অ্যাক্সেসযোগ্য। স্ব-হোস্ট করা কন্ট্রোলারের জন্য, সাধারণত লেগ্যাসি API-এর জন্য পোর্ট ৮৪৪৩, অথবা সংস্করণ ৯.১-এ প্রবর্তিত নতুন API-এর জন্য স্ট্যান্ডার্ড HTTPS পোর্ট ৪৪৩ ব্যবহার করা হয়। Purple-এর সাপোর্ট ডকুমেন্টেশন নির্দিষ্ট IP রেঞ্জগুলো উল্লেখ করে যেগুলোতে আপনার কন্ট্রোলারে ইনবাউন্ড অ্যাক্সেসের প্রয়োজন হয়। RADIUS-ভিত্তিক অথেনটিকেশনের জন্য - যা ওপেন গেস্ট SSID মডেলের পরিবর্তে WPA2-Enterprise বা WPA3-Enterprise SSIDs-এর সাথে Purple মোতায়েন করার সময় প্রাসঙ্গিক - UniFi-এর বিল্ট-ইন RADIUS সার্ভার স্ট্যান্ডার্ড 802.1X EAP পদ্ধতিগুলো সমর্থন করে। আপনি Settings, Networks, RADIUS Servers-এর অধীনে RADIUS প্রোফাইল কনফিগার করেন এবং তারপরে আপনার SSID কনফিগারেশনে সেই প্রোফাইলটি উল্লেখ করেন। UniFi সংস্করণ ৮.৪ থেকে RADSEC নামে পরিচিত RADIUS over TLS-ও সমর্থন করে, যা AP এবং অথেনটিকেশন সার্ভারের মধ্যে RADIUS ট্রাফিক এনক্রিপ্ট করে। মাল্টি-সাইট মোতায়েনের জন্য যেখানে RADIUS ট্রাফিক পাবলিক ইন্টারনেট ব্যবহার করে, সেখানে RADSEC দৃঢ়ভাবে সুপারিশ করা হয়। [ইমপ্লিমেন্টেশন সুপারিশ এবং ত্রুটিসমূহ - প্রায় ২ মিনিট] আমি আপনাকে ব্যবহারিক ইমপ্লিমেন্টেশন চেকলিস্টটি দিই যা আমি UniFi-তে Purple মোতায়েনকারী যেকোনো ক্লায়েন্টের সাথে ব্যবহার করব। প্রথমত, নেটওয়ার্ক সেগমেন্টেশন। আপনার গেস্ট SSID অবশ্যই একটি ডেডিকেটেড VLAN-এ থাকতে হবে, যা আপনার কর্পোরেট এবং IoT নেটওয়ার্ক থেকে বিচ্ছিন্ন। UniFi এটিকে সহজ করে তোলে - Settings, Networks-এ একটি ডেডিকেটেড নেটওয়ার্ক তৈরি করুন, এটিকে একটি VLAN ID বরাদ্দ করুন এবং সেই নেটওয়ার্কের সাথে আপনার গেস্ট SSID যুক্ত করুন। গেস্টদের একে অপরের ট্রাফিক প্রতিরোধ করতে গেস্ট নেটওয়ার্কে ক্লায়েন্ট আইসোলেশন সক্ষম করুন। দ্বিতীয়ত, কন্ট্রোলারের একটি বৈধ FQDN এবং একটি বিশ্বস্ত SSL সার্টিফিকেট থাকতে হবে। IP ঠিকানার ওপর নির্ভর করবেন না। একটি সঠিক ডোমেন নাম ব্যবহার করুন, এটিতে একটি Let's Encrypt বা বাণিজ্যিক সার্টিফিকেট পান এবং সেই সার্টিফিকেট ব্যবহার করতে UniFi কনফিগার করুন। এটি বেশিরভাগ HTTPS রিডাইরেক্ট সমস্যার সমাধান করে। তৃতীয়ত, আপনার ওয়াল্ড গার্ডেন সাবধানে তৈরি করুন এবং এটি পরীক্ষা করুন। সর্বনিম্ন এন্ট্রিগুলো হলো: আপনার Purple পোর্টাল ডোমেন এবং এর IP রেঞ্জ, iOS, Android, এবং Windows-এর জন্য Captive Portal সনাক্তকরণ ডোমেন এবং আপনার ব্যবহৃত যেকোনো OAuth প্রদানকারী ডোমেন। এমন একটি ডিভাইস দিয়ে পরীক্ষা করুন যা আগে কখনো নেটওয়ার্কের সাথে সংযুক্ত হয়নি - ক্যাশ করা DNS এবং নেটওয়ার্কের অবস্থা পরীক্ষার সময় ওয়াল্ড গার্ডেনের ত্রুটিগুলোকে আড়াল করতে পারে। চতুর্থত, API ইন্টিগ্রেশনের জন্য, ন্যূনতম প্রয়োজনীয় অনুমতি সহ UniFi Network Application-এ একটি ডেডিকেটেড লোকাল অ্যাডমিন অ্যাকাউন্ট ব্যবহার করুন। আপনার প্রাথমিক অ্যাডমিন ক্রেডেনশিয়াল ব্যবহার করবেন না। আপনি যদি Network Application ৯.১ বা তার পরের সংস্করণ ব্যবহার করেন, তবে Control Plane, Integrations-এর অধীনে নতুন API কী মেকানিজম ব্যবহার করুন - এটি আরও নিরাপদ এবং এর জন্য ক্রেডেনশিয়াল-ভিত্তিক অথেনটিকেশনের প্রয়োজন হয় না। পঞ্চমত, সেশনের সময়সীমা সতর্কতার সাথে বিবেচনা করুন। UniFi-এর ডিফল্ট গেস্ট সেশনের মেয়াদ শেষ হওয়ার সময়সীমা আট ঘণ্টার মতো স্বল্প হতে পারে। যে সমস্ত হসপিটালিটি ডেপ্লয়মেন্টে গেস্টরা একাধিক রাত অবস্থান করতে পারেন, সেগুলির জন্য Purple পোর্টালে উপযুক্ত সেশনের সময়সীমা কনফিগার করুন এবং নিশ্চিত করুন যে সেই সময়সীমাগুলি API অথরাইজেশন কলে সঠিকভাবে পাঠানো হচ্ছে। সবচেয়ে সাধারণ যে সমস্যাটি আমি দেখি তা হলো এমন একটি সেলফ-হোস্টেড কন্ট্রোলারে ডেপ্লয় করা যা পাবলিকলি অ্যাক্সেসযোগ্য নয়। Purple যদি গেস্টদের অথরাইজ করার জন্য আপনার কন্ট্রোলারে পৌঁছাতে না পারে, তাহলে পোর্টালটি লোড হবে কিন্তু অথেনটিকেশন কোনো মেসেজ ছাড়াই ব্যর্থ হবে। লাইভ হওয়ার আগে সর্বদা Purple-এর ইনফ্রাস্ট্রাকচার থেকে API কানেক্টিভিটি যাচাই করুন। [র‍্যাপিড-ফায়ার প্রশ্নোত্তর - প্রায় ১ মিনিট] এটি কি UniFi Dream Machine Pro-তে কাজ করে? হ্যাঁ। সমস্ত UniFi OS কনসোল - UDM, UDM Pro, UDM SE, UCG Ultra, UCG-Max - External Portal Server কনফিগারেশন সমর্থন করে। Network Application-টি অন-ডিভাইসে চলে। আমি কি একটি একক Purple অ্যাকাউন্ট থেকে একাধিক UniFi সাইটে Purple ব্যবহার করতে পারি? হ্যাঁ। Purple-এর মাল্টি-সাইট আর্কিটেকচার ঠিক এই কাজের জন্যই ডিজাইন করা হয়েছে। প্রতিটি ভেন্যু Purple-এ একটি পৃথক সাইট হিসেবে কনফিগার করা হয়, যা সংশ্লিষ্ট UniFi সাইটের সাথে ম্যাপ করা থাকে। আমাকে কি UniFi গেটওয়েতে ফায়ারওয়াল পোর্ট খুলতে হবে? আপনাকে নিশ্চিত করতে হবে যে গেস্ট VLAN ট্রাফিক ৪৪৩ পোর্টে Purple পোর্টাল ডোমেনে পৌঁছাতে পারে। কন্ট্রোলার API পোর্টটিও Purple-এর সার্ভার থেকে অ্যাক্সেসযোগ্য হতে হবে। Purple-এর ডকুমেন্টেশনে নির্দিষ্ট IP রেঞ্জ দেওয়া আছে। WPA3-এর ক্ষেত্রে কী হবে? UniFi WPA3 Personal এবং WPA3 Enterprise সমর্থন করে। captive portal মেকানিজমটি গেস্ট নেটওয়ার্কে WPA3 Personal-এর সাথে কাজ করে। WPA3 Enterprise মূলত 802.1X এবং RADIUS ব্যবহার করে, যা একটি ভিন্ন অথেনটিকেশন ফ্লো। [সংক্ষিপ্তসার ও পরবর্তী পদক্ষেপ - প্রায় ১ মিনিট] সংক্ষেপে বলতে গেলে: UniFi-তে একটি এক্সটার্নাল captive portal হিসেবে Purple ডেপ্লয় করা একটি সু-সমর্থিত ও আর্কিটেকচারালভাবে নির্ভরযোগ্য ইন্টিগ্রেশন। মূল পদক্ষেপগুলি হলো: আপনার Purple পোর্টাল URL-এর দিকে নির্দেশ করে External Portal Server অপশন সহ আপনার গেস্ট SSID কনফিগার করুন, একটি ব্যাপক ওয়াল্ড গার্ডেন তৈরি করুন যা Purple-এর ইনফ্রাস্ট্রাকচার এবং আপনার ব্যবহৃত যেকোনো OAuth প্রোভাইডারকে কভার করে, আপনার UniFi কন্ট্রোলারের একটি বৈধ SSL সার্টিফিকেট রয়েছে এবং তা Purple-এর API সার্ভার থেকে অ্যাক্সেসযোগ্য তা নিশ্চিত করুন এবং আপনার ভেন্যুর ধরন অনুযায়ী উপযুক্ত সেশনের সময়সীমা কনফিগার করুন। ব্যবসায়িক দিক থেকে এর সুবিধাটি অত্যন্ত স্পষ্ট। বিল্ট-ইন UniFi পোর্টাল আপনাকে কেবল একটি স্প্ল্যাশ পেজ দেয়। অন্যদিকে Purple আপনাকে দেয় একটি কমপ্লায়েন্স-রেডি, অ্যানালিটিক্স-চালিত গেস্ট এক্সপেরিয়েন্স প্ল্যাটফর্ম যা আপনার CRM-এর সাথে ইন্টিগ্রেট করে, GDPR সম্মতির অধীনে ফার্স্ট-পার্টি ডেটা সংগ্রহ করে এবং ফুটফল ও ডুয়েল-টাইম অ্যানালিটিক্স প্রদান করে যা ভেন্যু অপারেটর এবং মার্কেটিং টিমের আসলেই প্রয়োজন। আপনি যদি একজন MSP বা সিস্টেম ইন্টিগ্রেটর হন যিনি স্কেলে UniFi ডেপ্লয় করছেন, তবে Purple-এর মাল্টি-সাইট ম্যানেজমেন্ট এবং হোয়াইট-লেবেল ক্ষমতা এটিকে আপনার ক্লায়েন্টদের জন্য সঠিক ওভারলে করে তোলে। বিস্তারিত কনফিগারেশন ডকুমেন্টেশন, ওয়াল্ড গার্ডেন IP তালিকা এবং API ইন্টিগ্রেশন গাইডের জন্য, purple.ai ভিজিট করুন। শোনার জন্য ধন্যবাদ।

আমাদের মূল সিরিজের অংশ: Captive Portal Guide →

UniFi Network Hotspot ArchitectUbiquiti UniFi OS & Network Application 8.x

Ubiquiti UniFi captive portal and guest WiFi configurator

Generate UniFi Network Hotspot Manager settings, configure pre-authorization walled gardens, calculate guest VLAN subnet sizing, and validate cloud RADIUS accounting for seamless Purple deployment.

Target controller
UniFi Dream Machine Pro / SE
UniFi OS 3.x / Network 8.x
Native Hotspot Manager (External Portal Server)
Walled garden domains
9 FQDN rules
OS captive probe safe
Recommended subnet
/23 (509 IPs)
73% peak pool load
AAA interim accounting
300s
RFC 2866 accounting sync

Internal routing engine handles guest captive redirection with native gateway isolation.

Local IP or internal hostname used for controller API communication.

Redirection security parameters
UniFi Network Hotspot Manager Configuration Payload
{
  "hotspot_portal": {
    "authentication": "external_portal_server",
    "server_ip_or_hostname": "auth.purplewifi.net",
    "port": 443,
    "use_secure_portal": true,
    "redirect_mode": "original_url"
  },
  "controller_authorisation_profile": {
    "target_model": "UDM-Pro / UDM-SE / UDM-Enterprise",
    "controller_management_host": "192.168.1.1",
    "controller_api_port": 8843,
    "enable_https": true
  },
  "pre_authorization_allowed_hostnames": [
    "auth.purplewifi.net",
    "securelogin.purplewifi.net",
    "api.purplewifi.net",
    "cdn.purplewifi.net",
    "fonts.googleapis.com",
    "fonts.gstatic.com",
    "accounts.google.com",
    "graph.facebook.com",
    "linkedin.com"
  ],
  "radius_profile": {
    "profile_name": "Purple-Guest-RADIUS",
    "auth_server": "10.0.10.15",
    "auth_port": 1812,
    "acct_server": "10.0.10.15",
    "acct_port": 1813,
    "interim_update_interval_sec": 300,
    "dynamic_vlan_rfc3580": true,
    "default_guest_vlan": 20
  },
  "wireless_guest_profile": {
    "ssid": "Guest-WiFi",
    "client_isolation": true,
    "dhcp_recommended_lease_seconds": 7200,
    "recommended_cidr_scope": "/23",
    "per_client_bandwidth_limit_down_kbps": 10240,
    "per_client_bandwidth_limit_up_kbps": 3072
  }
}
Looking to deploy guest WiFi across enterprise UniFi hardware?
Review our architecture framework or talk directly to our wireless solutions engineering team.
Explore Captive Portal Guide
Useful? Link to this tool

একটি captive portal হলো সেই সাইন-ইন পেজ যা অতিথিরা অনলাইনে যাওয়ার আগে দেখতে পান। Ubiquiti UniFi-তে, অ্যাক্সেস পয়েন্ট এবং UniFi Network কন্ট্রোলার WiFi পরিচালনা করে; আপনার কোনো UniFi কিট প্রতিস্থাপন না করেই Purple সেই পোর্টাল এবং এর পেছনের ফার্স্ট-পার্টি ডেটা পরিচালনা করে।

কীভাবে Ubiquiti UniFi এবং Purple গেস্ট WiFi একসাথে কাজ করে

Purple হলো একটি ক্লাউড ওভারলে। আপনার UniFi Network কন্ট্রোলার আগের মতোই WiFi পরিচালনা করতে থাকে; UniFi-তে ইতিমধ্যে থাকা ফিচারগুলোর মাধ্যমে Purple গেস্ট এক্সপেরিয়েন্স পরিচালনা করে।

  • এক্সটার্নাল পোর্টাল সার্ভার। UniFi-এর Hotspot Manager-এ আপনি ল্যান্ডিং পেজটিকে UniFi-এর বিল্ট-ইন পেজের পরিবর্তে Purple-এর দিকে নির্দেশ করেন। একটি নতুন ডিভাইস আপনার Purple স্প্ল্যাশ পেজে রিডাইরেক্ট হয়, ভিজিটর সাইন-ইন করেন এবং নিয়ন্ত্রণ পুনরায় UniFi-এর কাছে ফিরে আসে।
  • কন্ট্রোলার অথরাইজেশন। Purple সরাসরি আপনার UniFi Network কন্ট্রোলারের সাথে এটির পাবলিক অ্যাড্রেস এবং এই কাজের জন্য আপনার তৈরি করা একটি ডেডিকেটেড কন্ট্রোলার লগইন ব্যবহার করে যোগাযোগ করার মাধ্যমে প্রতিটি গেস্টকে অথরাইজ করে। কন্ট্রোলারটি যদি পাবলিকলি অ্যাক্সেসযোগ্য না হয়, তবে একটি পোর্ট ফরওয়ার্ড সেই সংযোগটিকে সম্ভব করে তোলে।
  • Walled garden। UniFi-এর প্রি-অথরাইজেশন নিয়মগুলো ভিজিটর সাইন-ইন করার আগেই স্প্ল্যাশ পেজ এবং যেকোনো পেমেন্ট বা সোশ্যাল-লগইন ধাপগুলো লোড হতে সাহায্য করে।

পুনরাগত ভিজিটরদের জন্য, UniFi-এর SecurePass (Passpoint) অপশনটি RADIUS দ্বারা সমর্থিত একটি সুরক্ষিত, এনক্রিপ্ট করা সংযোগ যুক্ত করে, যাতে পরিচিত ব্যবহারকারীরা আবার সাইন-ইন না করেই পুনরায় সংযুক্ত হতে পারেন।

এটিই হলো সম্পূর্ণ মডেল: UniFi প্যাকেটগুলো স্থানান্তর করে এবং রেডিওগুলো পরিচালনা করে, Purple সাইন-ইন এবং ডেটার মালিকানা ধরে রাখে। যেহেতু এটি স্ট্যান্ডার্ড এক্সটার্নাল ওয়েব অথেন্টিকেশন এবং RADIUS-এর ওপর চলে, তাই এটি Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme Networks এবং Fortinet-এর ক্ষেত্রেও একইভাবে কাজ করে। Purple ডিজাইনগতভাবেই হার্ডওয়্যার-নিরপেক্ষ।

আপনার যা প্রয়োজন

  • অ্যাডমিন অ্যাক্সেস সহ একটি UniFi Network কন্ট্রোলার (একটি Dream Machine, CloudKey অথবা আপনার নিজস্ব সার্ভারে)।
  • আপনার স্প্ল্যাশ পেজ এবং সাইন-ইন জার্নি সেটআপ করা একটি Purple ভেন্যু।
  • একটি ডেডিকেটেড UniFi কন্ট্রোলার লগইন এবং আপনার কন্ট্রোলারের পাবলিক অ্যাড্রেস, যাতে Purple গেস্টদের অথরাইজ করতে পারে।

Purple-এর সাথে এটি সেটআপ করুন

সঠিক সেটিংস, এক্সটার্নাল পোর্টাল সার্ভার অ্যাড্রেস, Hotspot Manager ল্যান্ডিং পেজের অপশনগুলো, প্রি-অথরাইজেশন ডোমেইনগুলো, Purple-কে আপনার কন্ট্রোলারের সাথে লিঙ্ক করার ভেন্যু সেটিংস এবং ঐচ্ছিক SecurePass কনফিগারেশন, এন্ট্রি করার সঠিক মান সহ Purple-এর সাপোর্ট গাইডে ধাপে ধাপে নথিবদ্ধ করা হয়েছে।

Ubiquiti UniFi Network setup guide

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

আপনি যা পাবেন

গেস্টরা Purple-এর মাধ্যমে সাইন-ইন করার পর, প্রতিটি ভিজিট যাচাইকৃত, সচেতন পছন্দের অপ্ট-ইন ফার্স্ট-পার্টি ডেটায় পরিণত হয়: কে ভিজিট করেছেন, কত ঘনঘন এবং অনুমতিক্রমে কীভাবে তাদের কাছে পৌঁছানো যায়। এটিই এমন WiFi যা কেবল মানুষকে সংযুক্ত করে এবং এমন WiFi যা আপনার নিজস্ব একটি মার্কেটিং অডিয়েন্স তৈরি করে - এর মধ্যে পার্থক্য গড়ে দেয়। Purple হলো GDPR-aligned এবং ISO 27001 সার্টিফাইড, যা ৮০,০০০-এরও বেশি লাইভ ভেন্যুতে ৯৯.৯৯৯% আপটাইম প্রদান করে।

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

Captive portal

একটি সাইন-ইন পেজ যা কোনো ভিজিটর অনলাইনে যাওয়ার আগে দেখতে পান। Purple এটি হোস্ট এবং পরিচালনা করে; UniFi ডিভাইসগুলোকে এতে রিডাইরেক্ট করে।

আপনার UniFi WiFi-এর উপরে Purple যে গেস্ট এক্সপেরিয়েন্স লেয়ার যুক্ত করে।

External portal server

একটি UniFi সেটিং যা একটি আন-অথেন্টিকেটেড ডিভাইসকে UniFi-এর বিল্ট-ইন পেজের পরিবর্তে একটি এক্সটার্নাল হোস্ট করা সাইন-ইন পেজে পাঠায়।

কীভাবে UniFi-এর Hotspot Manager গেস্টকে Purple স্প্ল্যাশ পেজে নিয়ে যায়।

Controller authorisation

প্রতিটি গেস্ট সেশন অথরাইজ করতে Purple একটি ডেডিকেটেড লগইন ব্যবহার করে আপনার UniFi Network কন্ট্রোলারের সাথে এর পাবলিক অ্যাড্রেসের মাধ্যমে যোগাযোগ করে।

কীভাবে Purple একজন সাইন-ইন করা গেস্টকে UniFi-তে অনলাইনে যাওয়ার অনুমতি দেয়।

Walled garden

অ্যাড্রেসগুলোর একটি সংক্ষিপ্ত অ্যালাউ-লিস্ট যা একটি ডিভাইস সাইন-ইন করার আগেই অ্যাক্সেস করতে পারে।

স্প্ল্যাশ পেজ, পেমেন্ট এবং সোশ্যাল লগইন প্রি-অথেন্টিকেশন লোড করতে সাহায্য করে।

SecurePass (Passpoint)

RADIUS দ্বারা সমর্থিত একটি এনক্রিপ্ট করা WiFi কানেকশন যা পরিচিত ব্যবহারকারীদের পুনরায় সাইন ইন না করেই আবার সংযুক্ত হতে দেয়।

বারবার আসা ভিজিটরদের জন্য একটি ঐচ্ছিক সুরক্ষিত স্তর।

প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

Ubiquiti UniFi কীভাবে একটি এক্সটার্নাল captive portal এর সাথে ইন্টিগ্রেট করে?

UniFi Network Hotspot Manager অ্যাডমিনিস্ট্রেটরদের একটি External Portal Server-এ গেস্ট অথেন্টিকেশন ডেলিগেট করার অনুমতি দেয়। যখন একজন আনঅথেন্টিকেটেড ভিজিটর গেস্ট SSID-এর সাথে কানেক্ট হন, তখন UniFi গেটওয়ে প্রাথমিক HTTP ট্রাফিক ইন্টারসেপ্ট করে এবং ক্লায়েন্ট ব্রাউজারকে auth.purplewifi.net-এ Purple-এর দিকে রিডাইরেক্ট করে। ভিজিটর অথেন্টিকেশন সম্পন্ন করলে, Purple ইন্টারনেট অ্যাক্সেসের জন্য ক্লায়েন্ট MAC অ্যাড্রেসকে অথরাইজ করতে UniFi কন্ট্রোলার API কল করে।

UniFi কন্ট্রোলার এবং captive portal এর মধ্যে কোন পোর্টগুলো খোলা থাকতে হবে?

ক্লাউড বা এক্সটার্নাল captive portal ইন্টিগ্রেশনের জন্য, অথরাইজেশন API কলের জন্য TCP পোর্ট 8843 (অথবা লেগাসি ইনস্টলেশনের ক্ষেত্রে TCP পোর্ট 8443) এ UniFi Network কন্ট্রোলার পৌঁছানোযোগ্য হতে হবে। সুরক্ষিত গেস্ট ব্রাউজার রিডাইরেকশনের জন্য, গেস্ট প্রি-অথরাইজেশন ফায়ারওয়াল প্রোফাইলের মধ্যে TCP পোর্ট 443-এ আউটবাউন্ড HTTPS এবং UDP পোর্ট 53-এ DNS অনুমোদিত রয়েছে কিনা তা নিশ্চিত করুন।

কেন অপারেটিং সিস্টেমের captive প্রোব হোস্টগুলোকে কখনই অনুমতি তালিকায় (allowlist) রাখা উচিত নয়?

iOS, Android, macOS এবং Windows সহ অপারেটিং সিস্টেমগুলো captive নেটওয়ার্ক সনাক্ত করতে captive.apple.com এবং connectivitycheck.gstatic.com এর মতো নির্দিষ্ট এন্ডপয়েন্টগুলো প্রোব করে। যদি এই প্রোব হোস্টনেমগুলো UniFi Pre-Authorization Access-এ রাখা হয়, তবে ডিভাইসগুলো কোনো ইন্টারসেপ্ট ছাড়াই HTTP 200 রেসপন্স পায়, ইন্টারনেট কানেক্টিভিটি সচল আছে বলে ধরে নেয় এবং স্বয়ংক্রিয় লগইন ব্রাউজার মোডালটিকে সাপ্রেস বা দমন করে।

UniFi-তে Purple এর জন্য কোন প্রি-অথরাইজেশন অ্যাক্সেস রুলগুলো প্রয়োজন?

UniFi Hotspot Manager-এ গেস্ট সাইন-ইন করার আগে Pre-Authorization Access-এ Purple অথেন্টিকেশন এবং অ্যাসেট ডোমেনগুলো অনুমতি তালিকায় রাখা প্রয়োজন। এর মধ্যে auth.purplewifi.net, securelogin.purplewifi.net, api.purplewifi.net এবং cdn.purplewifi.net অন্তর্ভুক্ত রয়েছে। যদি সোশ্যাল লগইন বা পেইড টিয়ার সক্রিয় থাকে, তবে সংশ্লিষ্ট OAuth এবং পেমেন্ট গেটওয়ে এন্ডপয়েন্টগুলোও অবশ্যই অনুমতি তালিকায় রাখতে হবে।

RADIUS অ্যাকাউন্টিং কীভাবে UniFi-তে গেস্ট WiFi ম্যানেজমেন্টকে উন্নত করে?

UDP পোর্ট 1812 (অথেন্টিকেশন) এবং 1813 (অ্যাকাউন্টিং) এ Purple-কে নির্দেশ করে একটি RADIUS প্রোফাইল কনফিগার করলে তা রিয়েল-টাইম সেশন ট্র্যাকিং সক্ষম করে। অন্তর্বর্তীকালীন অ্যাকাউন্টিং আপডেট ইন্টারভাল 300 সেকেন্ডে সেট করলে তা UniFi অ্যাক্সেস পয়েন্টগুলোকে কন্ট্রোলার রিসোর্সের ওপর অতিরিক্ত চাপ না দিয়েই পর্যায়ক্রমিকভাবে গেস্ট এয়ারটাইম, ট্রান্সমিট করা বাইট এবং থাকার সময়কাল Purple অ্যানালিটিক্স প্ল্যাটফর্মে রিপোর্ট করতে দেয়।

গেস্ট নেটওয়ার্কের জন্য কোন সাবনেট সাইজ এবং DHCP লিজের সময়কাল সুপারিশ করা হয়?

গেস্ট নেটওয়ার্কগুলোতে উচ্চ টার্নওভার এবং লিজের পরিবর্তন ঘটে। উচ্চ ট্রাফিকের ভেন্যুগুলোতে অন্তত একটি /22 সাবনেট (1,021টি ব্যবহারযোগ্য IP অ্যাড্রেস) কনফিগার করা উচিত এবং DHCP লিজের সময় কমিয়ে 2 ঘণ্টা (7,200 সেকেন্ড) করা উচিত। এটি ভিজিটরদের সর্বোচ্চ টার্নওভারের সময় অ্যাড্রেস পুল শেষ হয়ে যাওয়া প্রতিরোধ করে, অন্যদিকে Client Device Isolation ডিভাইসগুলোর মধ্যে অননুমোদিত ল্যাটারাল যোগাযোগ রোধ করে।

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

Ubiquiti UniFi এবং গেস্ট WiFi: Purple-এর সাথে ক্যাপティブ পোর্টাল সেটআপ

যেভাবে Ubiquiti UniFi Network কাজ করে Purple গেস্ট WiFi-এর সাথে: একটি এক্সটার্নাল পোর্টাল সার্ভার, কন্ট্রোলার অথরাইজেশন এবং একটি Walled garden, সাথে সঠিক কনফিগারেশনের জন্য Purple-এর ধাপে ধাপে সেটআপ গাইডের একটি লিঙ্ক।

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

Grandstream GWN এবং গেস্ট WiFi: Purple-এর সাথে captive portal সেটআপ

Grandstream GWN অ্যাক্সেস পয়েন্ট কীভাবে Purple গেস্ট WiFi-এর সাথে কাজ করে: একটি এক্সটার্নাল স্প্ল্যাশ পেজ, RADIUS এবং একটি ওয়ার্ল্ড গার্ডেন, যেখানে সঠিক কনফিগারেশনের জন্য Purple-এর ধাপে ধাপে সেটআপ গাইডের লিঙ্ক রয়েছে।

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

Fortinet FortiAP এবং গেস্ট WiFi: Purple-এর সাথে captive portal সেটআপ

আপনার কিট পরিবর্তন না করেই FortiCloud-এ ম্যানেজ করা Fortinet FortiAP অ্যাক্সেস পয়েন্টগুলো কীভাবে একটি এক্সটার্নাল captive portal, RADIUS এবং একটি walled garden ব্যবহার করে Purple গেস্ট WiFi-এর সাথে কাজ করে।

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

আপনার নির্দিষ্ট সেটআপ নিয়ে কোনো প্রশ্ন আছে?

আমাদের টিম ৮০,০০০ ভেন্যুতে ভেন্যু অপারেটর, IT ম্যানেজার এবং নেটওয়ার্ক ইঞ্জিনিয়ারদের সাথে কাজ করে। একটি ২০ মিনিটের কল বুক করুন এবং আপনার মতো অন্যরা কীভাবে এর সমাধান করেছেন তা আমরা আপনাকে দেখাব।