基于 OAuth 的应用快速关联 (App Flip) 关联功能可让用户快速将其在您的身份验证系统中的账号关联到其 Google 账号。 如果用户在发起账户关联过程时手机上已安装您的应用，系统会顺畅地将他们转到您的应用以获取用户授权。
这种方法可提供更快的账户关联过程，因为用户无需重新输入用户名和密码进行身份验证；相反，App Flip 会利用用户在您的应用中的账号凭据。用户将其 Google 账号与您的应用关联后，便可利用您开发的任何集成。
您可以为 iOS 和 Android 应用设置 App Flip。
要求
如需实现 App Flip，您必须满足以下要求：
- 您必须拥有 Android 或 iOS 应用。
- 您必须拥有、管理和维护支持 OAuth 2.0 授权代码流程的 OAuth 2.0 服务器。
基于 OAuth 的 App Flip 流程
以下序列图详细说明了用户、Google 应用、您的应用和您的授权服务器之间针对 App Flip 的交互。
角色和职责
下表定义了 App Flip 流程中执行者的角色和职责。
| 执行者 / 组件 | GAL 角色 | 职责 |
|---|---|---|
| Google 应用 / 服务器 | OAuth 客户端 | 发起账户关联过程，触发到您的移动应用深层链接，将授权代码交换为令牌，并安全地存储这些令牌以访问您服务的 API。 |
| 您的应用 | 授权代理 | 对用户进行身份验证（通常使用现有应用凭据）， 获取意见征求，并从您的服务器检索授权代码。 |
| 您的授权服务器 | 授权服务器 | 验证授权代码和刷新令牌，并向 Google 服务器颁发访问 令牌。 |
Panduan desain
Bagian ini menjelaskan persyaratan dan rekomendasi desain untuk layar izin penautan akun App Flip. Setelah Google memanggil aplikasi Anda, aplikasi Anda akan menampilkan layar izin kepada pengguna.
Persyaratan
- Anda harus menginformasikan bahwa akun pengguna ditautkan ke Google, bukan ke produk Google tertentu, seperti Google Home atau Asisten Google.
Rekomendasi
Sebaiknya Anda melakukan hal berikut:
Menampilkan Kebijakan Privasi Google. Sertakan link ke Kebijakan Privasi Google di layar izin.
Data yang akan dibagikan. Gunakan bahasa yang jelas dan ringkas untuk memberi tahu pengguna data apa yang diperlukan Google dan alasannya.
Pesan ajakan (CTA) yang jelas. Nyatakan pesan ajakan yang jelas di layar izin Anda, seperti “Setuju dan tautkan”. Hal ini karena pengguna perlu memahami data apa yang harus mereka bagikan kepada Google untuk menautkan akun mereka.
Kemampuan untuk menolak atau membatalkan. Berikan cara bagi pengguna untuk kembali, menolak, atau membatalkan, jika mereka memilih untuk tidak menautkan.
Kemampuan untuk membatalkan tautan. Menawarkan mekanisme bagi pengguna untuk membatalkan tautan, seperti URL ke setelan akun mereka di platform Anda. Atau, Anda dapat menyertakan link ke Akun Google tempat pengguna dapat mengelola akun tertaut mereka.
Kemampuan untuk mengubah akun pengguna. Sarankan metode bagi pengguna untuk beralih akun. Hal ini sangat bermanfaat jika pengguna cenderung memiliki beberapa akun.
- Jika pengguna harus menutup layar izin untuk beralih akun, kirimkan error yang dapat dipulihkan ke Google agar pengguna dapat login ke akun yang diinginkan dengan penautan OAuth dan alur implisit.
Sertakan logo Anda. Menampilkan logo perusahaan Anda di layar izin. Gunakan panduan gaya Anda untuk menempatkan logo. Jika Anda ingin menampilkan logo Google juga, lihat Logo dan merek dagang.
Menerapkan Peralihan Aplikasi di aplikasi Anda
Untuk menerapkan App Flip, Anda perlu mengubah kode otorisasi pengguna di aplikasi Anda agar menerima deep link dari Google.
Untuk mendukung Peralihan Aplikasi di aplikasi Android Anda, ikuti petunjuk di panduan penerapan Android.
Untuk mendukung App Flip di aplikasi iOS Anda, ikuti petunjuk di panduan penerapan iOS.
Menguji App Flip
Pengalihan Aplikasi dapat disimulasikan menggunakan aplikasi contoh dan pengujian sebelum aplikasi produksi yang terverifikasi dan server OAuth 2.0 yang berfungsi tersedia.
Selama Pengalihan Aplikasi, aplikasi Google akan membuka aplikasi Anda terlebih dahulu, yang kemudian meminta respons kode otorisasi dari server OAuth 2.0 Anda. Pada langkah terakhir, respons akan dikembalikan ke aplikasi Google.
Prasyarat
Untuk menyimulasikan aplikasi Google dan memicu intent yang meluncurkan aplikasi Anda, download dan instal Alat Pengujian Flip Aplikasi untuk Android dan iOS.
Download dan instal Contoh App Flip untuk Android dan iOS untuk menyimulasikan aplikasi Anda dan memilih jenis respons OAuth 2.0.
Urutan pengujian
- Buka Alat Pengujian Pengalihan Aplikasi.
- Tekan
Try Flip!untuk meluncurkan aplikasi Contoh App Flip Anda. - Pilih respons dari tombol pilihan di aplikasi Contoh.
- Tekan
Senduntuk menampilkan kembali respons OAuth 2.0 simulasi ke Alat Pengujian. - Periksa pesan log Alat Pengujian untuk mengetahui auth_code atau detail error.
Pengujian produksi
Pengalihan Aplikasi dapat diuji dalam produksi setelah menyelesaikan pendaftaran dan penerapan server OAuth 2.0 Anda.
Satu Akun Google dan alamat email khusus tugas direkomendasikan untuk pengujian otomatis.
Status penautan akun dapat dilihat menggunakan Akun tertaut saat login sebagai pemilik Akun Google. Akun juga dapat dibatalkan tautannya di antara pengujian berulang dari sini.
Secara opsional, Anda dapat memilih untuk menerapkan RISC untuk membatalkan tautan dan memberi tahu Google tentang perubahan secara terprogram.