پشتیبانی از API پورتال اسیر
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
با شروع Android 11 Beta 2، این سیستم از زیرمجموعه ای از عملکردهای توصیف شده توسط RFC7710bis و API پورتال مرتبط با آن پشتیبانی می کند.
API یک راه قابل اعتماد برای نقاط دسترسی فراهم می کند تا خود را به عنوان پورتال های اسیر شناسایی کنند. همچنین موارد استفاده جدید را برای نقاط دسترسی فعال می کند تا اطلاعاتی مانند اطلاعات جلسه و مکان را برای کاربران خود منتشر کنند.
تشخیص پورتال اسیر بهبود یافته است
از زمان اندروید 5.0 (سطح API 21)، دستگاه‌های اندرویدی پورتال‌های اسیر را شناسایی کرده و به کاربر اطلاع داده‌اند که برای دسترسی به اینترنت باید وارد شبکه شوند. پورتال های اسیر با استفاده از پروب های HTTP متن شفاف به مقصدهای شناخته شده (مانند connectivitycheck.gstatic.com ) شناسایی شدند و اگر کاوشگر یک تغییر مسیر HTTP دریافت می کرد، دستگاه فرض می کرد که شبکه یک پورتال محصور است. این تکنیک می‌تواند غیرقابل اعتماد باشد زیرا هیچ URL استانداردی برای بررسی وجود ندارد، و چنین کاوش‌هایی ممکن است به اشتباه توسط شبکه‌های پورتال محصور مجاز یا مسدود شوند (به‌جای تغییر مسیر). API به پورتال ها اجازه می دهد تا سیگنال مثبتی مبنی بر نیاز به ورود به سیستم همراه با URL برای ورود به سیستم ارائه دهند.
اندروید 11 از گزینه DHCP 114 همانطور که در RFC7710bis توضیح داده شده است، پشتیبانی می کند. ممکن است در به‌روزرسانی آینده، پشتیبانی از گزینه تبلیغات روتر را اضافه کنیم. اگر دستگاه یک URL API پورتال محصور را از طریق آن گزینه در حین دست دادن DHCP دریافت کند، دستگاه‌ها بلافاصله پس از اتصال، محتویات API را دریافت می‌کنند و از کاربران می‌خواهند که در صورت محصور بودن شبکه، طبق API پورتال محصور وارد سیستم شوند.
اگر API در دسترس نباشد، یا اگر درگاهی تبلیغ نشود، سیستم مانند قبل به شناسایی پورتال ها و تأیید اتصال اینترنت با استفاده از پروب های HTTP/HTTPS ادامه می دهد.
اطلاعات محل برگزاری
اندروید 11 از آدرس venue-info-url تعریف شده در API پورتال اسیر پشتیبانی می کند. این URL به کاربران اجازه می دهد تا اطلاعات مربوط به زمینه را در مورد مکان نقطه دسترسی در مرورگر خود به دست آورند. به‌طور پیش‌فرض، اگر کاربران بخواهند این URL را از طریق یک اعلان پس از ورود به سیستم یا تنظیمات شبکه خود انجام دهند، می‌توانند این URL را باز کنند.
شکل 1. اگر شبکه یک URL محل برگزاری ارائه دهد، سیستم اعلامیه ای را به کاربر می دهد که به کاربر اجازه می دهد از آن صفحه بازدید کند.
شکل 2. دکمه باز کردن سایت از صفحه جزئیات شبکه
موارد استفاده آینده
در حالی که در زمان راه‌اندازی، اندروید 11 تنها از مجموعه‌ای از عملکردهای اولیه از API پورتال محرمانه پشتیبانی می‌کند، ممکن است عملکردهای جدید پس از راه‌اندازی از طریق به‌روزرسانی‌های سیستم Google Play به دستگاه‌ها ارائه شود. ما اپراتورهای شبکه را تشویق می‌کنیم تا API پورتال محصور را پیاده‌سازی کنند و در عین حال پیشرفت‌های احتمالی آینده را در نظر داشته باشند:
- زمان جلسه (
seconds-remaining ) در حال حاضر در برنامه تنظیمات پیش‌فرض استفاده می‌شود تا به کاربران اطلاع دهد که چقدر زمان در پورتال باقی مانده است. امکان تمدید جلسه از طریق URL ورود ( can-extend-session ) همچنین می تواند از طریق API بیان شود تا به سیستم اجازه دهد کاربر را در مورد جلسات منقضی شده یا منقضی شده به زودی مطلع کند. - درپوش داده ها (
bytes-remaining ) را می توان از طریق API تبلیغ کرد تا به کاربران اجازه دهد داده های باقی مانده را پیگیری کنند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Starting in Android 11 Beta 2, the system supports a subset of\nfunctionality described by\n[RFC7710bis](https://tools.ietf.org/html/draft-ietf-capport-rfc7710bis)\nand the associated [captive portal\nAPI](https://tools.ietf.org/html/draft-ietf-capport-api).\n\nThe API provides a reliable way for access points to identify themselves as\ncaptive portals. It also enables new use-cases for access points to publish\ninformation to their users, such as session and venue information.\n\nImproved captive portal detection\n\nSince Android 5.0 (API level 21), Android devices have detected captive portals\nand notified the user that they need to sign in to the network to access the\ninternet. Captive portals were detected using cleartext HTTP probes to known\ndestinations (such as `connectivitycheck.gstatic.com`), and if the probe\nreceived an HTTP redirect, the device assumed that the network was a captive\nportal. This technique can be unreliable because there is no standard URL to\nprobe, and such probes could be mistakenly allowed or blocked (instead of\nredirected) by captive portal networks. The API allows portals to provide a\npositive signal that login is required, along with a URL to log in to.\n\nAndroid 11 supports DHCP option 114 as described in RFC7710bis.\nWe may add support for the router advertisement option in a future update. If\nthe device gets a captive portal API URL through that option during the DHCP\nhandshake, devices fetch the API contents immediately after connecting and\nprompt users to log in if the network is captive, as per the captive portal API.\n\nIf the API is not available, or if no portal is advertised, the system will\ncontinue to detect portals and verify internet connectivity using HTTP/HTTPS\nprobes, as before.\n\nVenue-published information\n\nAndroid 11 supports the `venue-info-url` defined in the captive\nportal API. This URL allows users to obtain context-specific information about\nthe access point venue in their browser. By default, users can open this URL if\nthey choose to do so from a notification after logging in, or from their network\nsettings.\n\n\u003cbr /\u003e\n\n\n**Figure 1.** If the network provides a venue URL, the system pops up a notice\nallowing the user to visit that page\n\n\u003cbr /\u003e\n\n\n**Figure 2.** Button to open the site from the Network details screen\n\nFuture use cases\n\nWhile at launch Android 11 supports only a basic set of\nfunctionality from the captive portal API, new functionality may be delivered to\ndevices via Google Play system updates after launch. We encourage network\noperators to implement the captive portal API while keeping future possible\nimprovements in mind:\n\n- Session time (`seconds-remaining`) is currently used in the default **Settings** app to inform users on how much time is left on the portal. The ability to extend the session via the login URL (`can-extend-session`) can also be expressed through the API to allow the system to notify the user about expired or soon-to-expire sessions.\n- Data caps (`bytes-remaining`) can be advertised through the API to allow users to keep track of remaining data."]]
