پیوند حساب Google با App Flip مبتنی بر OAuth

App Flip Linking مبتنی بر OAuth (App Flip) به کاربران شما این امکان را می دهد تا به راحتی و سریع حساب های خود را در سیستم احراز هویت شما به حساب های Google خود پیوند دهند. اگر برنامه شما هنگام شروع فرآیند پیوند حساب روی تلفن کاربر شما نصب شده باشد، برای دریافت مجوز کاربر به طور یکپارچه به برنامه شما منتقل می شود.

این رویکرد فرآیند پیوند سریع‌تر و آسان‌تر را فراهم می‌کند زیرا کاربر مجبور نیست نام کاربری و رمز عبور خود را مجدداً برای احراز هویت وارد کند. در عوض، App Flip از اعتبارنامه‌های حساب کاربر در برنامه شما استفاده می‌کند. هنگامی که یک کاربر حساب Google خود را با برنامه شما مرتبط کرد، می تواند از هر یکپارچه سازی که شما ایجاد کرده اید استفاده کند.

می توانید App Flip را برای هر دو برنامه iOS و Android تنظیم کنید.

این شکل مراحلی را نشان می دهد که کاربر می تواند حساب Google خود را به سیستم احراز هویت شما پیوند دهد. اولین اسکرین شات نشان می دهد که چگونه یک کاربر می تواند برنامه شما را انتخاب کند اگر حساب Google او به برنامه شما مرتبط باشد. اسکرین شات دوم تاییدیه پیوند حساب گوگل آنها را با برنامه شما نشان می دهد. اسکرین شات سوم یک حساب کاربری با موفقیت در برنامه Google را نشان می دهد.
شکل 1. پیوند دادن حساب در تلفن کاربر با App Flip.

الزامات

برای پیاده سازی App Flip، باید شرایط زیر را رعایت کنید:

  • شما باید یک برنامه اندروید یا iOS داشته باشید.
  • شما باید صاحب، مدیریت و نگهداری یک سرور OAuth 2.0 باشید که از جریان کد مجوز OAuth 2.0 پشتیبانی می کند.

دستورالعمل های طراحی

این بخش الزامات طراحی و توصیه‌هایی را برای صفحه رضایت پیوند دادن حساب App Flip توضیح می‌دهد. پس از تماس Google با برنامه شما، برنامه شما صفحه رضایت را به کاربر نمایش می دهد.

الزامات

  1. شما باید اعلام کنید که حساب کاربر به Google مرتبط است، نه به یک محصول خاص Google، مانند Google Home یا Google Assistant.

توصیه ها

توصیه می کنیم موارد زیر را انجام دهید:

  1. سیاست حفظ حریم خصوصی Google را نمایش دهید. پیوندی به خط مشی رازداری Google در صفحه رضایت اضافه کنید.

  2. داده هایی که باید به اشتراک گذاشته شود. از زبان واضح و مختصر استفاده کنید تا به کاربر بگویید گوگل به چه اطلاعاتی از او نیاز دارد و چرا.

  3. فراخوانی برای اقدام را پاک کنید. یک فراخوان برای اقدام واضح در صفحه رضایت خود، مانند «موافق و پیوند» بیان کنید. این به این دلیل است که کاربران باید بدانند چه داده‌هایی را باید با Google به اشتراک بگذارند تا حساب‌های خود را پیوند دهند.

  4. قابلیت لغو. راهی برای کاربران فراهم کنید که در صورت عدم پیوند، به عقب برگردند یا لغو کنند.

  5. قابلیت قطع لینک مکانیزمی را برای لغو پیوند به کاربران ارائه دهید، مانند URL به تنظیمات حساب آنها در پلتفرم شما. از طرف دیگر، می‌توانید پیوندی به حساب Google اضافه کنید تا کاربران بتوانند حساب پیوند شده خود را مدیریت کنند.

  6. امکان تغییر حساب کاربری روشی را برای کاربران پیشنهاد کنید تا حساب(های) خود را تغییر دهند. این به ویژه در صورتی مفید است که کاربران تمایل به داشتن چندین حساب داشته باشند.

    • اگر کاربر باید صفحه رضایت را برای تغییر حساب ببندد، یک خطای قابل بازیابی به Google ارسال کنید تا کاربر بتواند با پیوند OAuth و جریان ضمنی به حساب مورد نظر وارد شود.
  7. لوگوی خود را درج کنید. لوگوی شرکت خود را روی صفحه رضایت نمایش دهید. از دستورالعمل های سبک خود برای قرار دادن لوگوی خود استفاده کنید. اگر می‌خواهید نشان‌واره Google را نیز نمایش دهید، نشان‌ها و علائم تجاری را ببینید.

این شکل نمونه ای از صفحه رضایت همراه با فراخوانی برای الزامات فردی و توصیه هایی را نشان می دهد که باید هنگام طراحی صفحه رضایت کاربر دنبال شوند.
شکل 2. دستورالعمل های طراحی صفحه رضایت پیوند حساب.

App Flip را در برنامه های بومی خود پیاده کنید

برای اجرای App Flip، باید کد مجوز کاربر را در برنامه خود تغییر دهید تا پیوند عمیق از Google را بپذیرید.

برای پشتیبانی از App Flip در برنامه Android خود، دستورالعمل‌های راهنمای پیاده‌سازی Android را دنبال کنید.

برای پشتیبانی از App Flip در برنامه iOS خود، دستورالعمل‌های راهنمای پیاده‌سازی iOS را دنبال کنید.

تست تلنگر برنامه

App Flip ممکن است با استفاده از برنامه‌های نمونه و آزمایشی قبل از در دسترس بودن برنامه‌های تولید تأیید شده و یک سرور OAuth 2.0 فعال شبیه‌سازی شود.

در طول App Flip، یک برنامه Google ابتدا برنامه شما را باز می کند و سپس یک پاسخ کد مجوز را از سرور OAuth 2.0 شما درخواست می کند، در مرحله آخر پاسخ به برنامه Google برگردانده می شود.

پیش نیازها

برای شبیه‌سازی یک برنامه Google و راه‌اندازی هدفی که برنامه شما را راه‌اندازی می‌کند، ابزار App Flip Test Tool را برای Android و iOS دانلود و نصب کنید.

دانلود و نصب App Flip Sample برای Android و iOS برای شبیه سازی برنامه خود و انتخاب نوع پاسخ OAuth 2.0.

دنباله تست

  1. ابزار App Flip Test Tool را باز کنید.
  2. Try Flip! تا برنامه App Flip Sample خود را راه اندازی کنید.
  3. پاسخی را از دکمه‌های رادیویی در برنامه Sample انتخاب کنید.
  4. Send را فشار دهید تا پاسخ شبیه سازی شده OAuth 2.0 به ابزار تست برگردد.
  5. پیام‌های گزارش ابزار تست را برای auth_code یا جزئیات خطا بررسی کنید.

تست تولید

App Flip ممکن است پس از تکمیل ثبت نام و اجرای سرور OAuth 2.0 در مرحله تولید آزمایش شود.

یک حساب Google و یک آدرس ایمیل خاص برای آزمایش خودکار توصیه می شود.

هنگامی که به عنوان دارنده حساب Google وارد سیستم شوید، می‌توان وضعیت پیوند حساب‌ها را با استفاده از حساب‌های پیوندی مشاهده کرد. از اینجا نیز ممکن است ارتباط حساب‌ها بین آزمایش‌های مکرر قطع شود.

در صورت تمایل، می‌توانید RISC را پیاده‌سازی کنید تا به‌صورت برنامه‌ای پیوند را لغو کنید و Google را از تغییر مطلع کنید.