Web Authentication API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یکپارچه‌کننده‌ها باید یک میزبان وب را برای تغییر مسیر کاربران برای اهداف احراز هویت پیاده‌سازی کنند. این احراز هویت یک روش متفاوت است، اما همان هدفی است که احراز هویت ارائه شده توسط احراز هویت Android ارائه شده است. این میزبان وب باید یک وب سایت سازگار با موبایل داشته باشد.
میزبان وب باید درخواست های وب تلفن همراه را در مقابل درخواست های وب دسکتاپ بر اساس مقدار هدر کاربر-عامل تعیین کند. صفحه‌ای که در درخواست‌های وب تلفن همراه ارائه می‌شود باید در Android و iOS سازگار با وب‌سایت همراه باشد. علاوه بر مقدار هدر user-agent، کلاینت هیچ راهنمایی دیگری در مورد محیطی که کاربر در آن درخواست می کند (دسکتاپ یا وب) به شما ارائه نمی دهد.
سرور باید یک پروتکل HTTPS را با استفاده از GET پیاده سازی کند. مسیر و میزبان توسط یکپارچه کننده قابل تعریف هستند. ادغام کننده باید از طول URL 2048 کاراکتر پشتیبانی کند. این شامل طرح، میزبان، پورت، مسیر و پارامترها است.
همه پارامترها قبل از کدگذاری URL با UTF-8 کدگذاری خواهند شد.
درخواست
در صورت درخواست، گوگل موارد زیر را به عنوان پارامترهای URL ارائه می دهد:
| زمینه های |
|---|
gspMajorVersion | int شماره نسخه اصلی برای این درخواست. |
gspAuthenticationRequest | AuthenticationRequest درخواست احراز هویت |
gspAssociationId | string در صورت وجود، این شامل یک شناسه است که ادغام کننده برای جستجوی اعتبار کاربری که به چالش کشیده شده است استفاده می کند. اگر این وجود نداشته باشد، کاربر این گزینه را دارد که شناسه حساب را تغییر دهد. |
gspCallbackUrl | string URL برای هدایت کاربر به آن به منظور تکمیل جریان احراز هویت در Google. این مقدار url کدگذاری شده است. |
واکنش
پس از تکمیل احراز هویت، کاربر باید با استفاده از HTTPS GET به gspCallbackUrl هدایت شود. این URL باید پارامترهای پرس و جو زیر را داشته باشد:
| زمینه های |
|---|
gspResult | int 100 | احراز هویت با موفقیت انجام شد. | 201 | کاربر جریان را به صورت دستی لغو کرد و جریان باید قطع شود. | 202 | احراز هویت به دلیلی مهلک انجام نشد و جریان باید متوقف شود. |
|
gspAuthenticationResponse | AuthenticationResponse پاسخ احراز هویت |
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-07-25 بهوقت ساعت هماهنگ جهانی."],[[["Integrators must implement a mobile-friendly web host to redirect users for authentication, similar to Android authentication but utilizing a web-based approach."],["The web host should distinguish between mobile and desktop requests using the user-agent header and deliver a mobile-friendly experience for both Android and iOS."],["The server must use HTTPS GET with a definable path and host, supporting URLs up to 2,048 characters, including parameters encoded in UTF-8 before URL encoding."],["Google provides URL parameters for the request including version, authentication request, association ID (for credential lookup), and a callback URL for redirection after authentication."],["Upon authentication completion, the user is redirected to the provided callback URL with parameters indicating the result (success, cancellation, or failure) and an authentication response."]]],["Integrators must host a mobile-friendly website for user authentication, distinguishing between mobile and desktop requests via the user-agent header. The server must utilize HTTPS GET, with a definable path and host, supporting URLs up to 2,048 characters. Google provides parameters like `gspMajorVersion`, `gspAuthenticationRequest`, `gspAssociationId`, and `gspCallbackUrl` within the request. Upon authentication completion, the user is redirected to `gspCallbackUrl` via HTTPS GET, including `gspResult` and `gspAuthenticationResponse` parameters. All parameters are UTF-8 and URL-encoded.\n"]]
