Setiap Tindakan smart home harus menyertakan mekanisme untuk mengautentikasi pengguna.
Autentikasi memungkinkan Anda menautkan Akun Google pengguna dengan akun pengguna di sistem autentikasi. Hal ini memungkinkan Anda mengidentifikasi pengguna saat fulfillment Anda menerima intent smart home. Smart home Google hanya mendukung OAuth dengan alur kode otorisasi.
Setelah memiliki implementasi OAuth 2.0, Anda dapat secara opsional mengonfigurasi App Flip berbasis OAuth, yang memungkinkan pengguna menautkan akun mereka dengan lebih cepat di sistem autentikasi ke Akun Google mereka.
OAuth
Untuk smart home, Anda harus menggunakan OAuth dengan alur kode otorisasi, yang mengharuskan Anda memiliki dua endpoint: endpoint otorisasi dan pertukaran token.
Setelah Anda mengautentikasi pengguna, token akses OAuth 2.0 pihak ketiga pengguna tersebut akan dikirim di header otorisasi saat intent smart home dikirim ke fulfillment Anda. Semua pengguna harus melakukan penautan
akun, karena informasi perangkat dikirim ke
Google Assistant dengan intent
action.devices.SYNC, yang memerlukan penautan akun.
Tindakan smart home Anda diharapkan dapat mendukung beberapa pengguna Google yang terhubung ke akun pengguna yang sama (misalnya, saat pengguna memberikan akses ke pengguna lain di rumah mereka). Jika tidak dapat mendukung beberapa koneksi pengguna, layanan harus memberikan error pada saat penautan akun.
Untuk mendapatkan petunjuk cara menyiapkan server OAuth 2.0 untuk Action Anda, lihat Mengimplementasikan server OAuth 2.0.
Balik Aplikasi Berbasis OAuth
Penautan Aplikasi Flip berbasis OAuth (App Flip) memungkinkan pengguna untuk menautkan akun mereka di sistem autentikasi Anda dengan mudah dan cepat ke akun Google mereka. Jika aplikasi Anda diinstal di ponsel pengguna saat mereka memulai proses penautan akun, aplikasi akan dibalik dengan lancar ke aplikasi untuk mendapatkan otorisasi pengguna.
Pendekatan ini memberikan proses penautan yang lebih cepat dan mudah karena pengguna tidak perlu memasukkan kembali nama pengguna dan sandi untuk mengautentikasi; sebagai gantinya, App Flip memanfaatkan kredensial dari akun pengguna di aplikasi Anda. Setelah pengguna menautkan akun Google-nya dengan aplikasi Anda, mereka dapat memanfaatkan integrasi apa pun yang telah Anda kembangkan.
Anda dapat menyiapkan App Flip untuk aplikasi iOS dan Android.
Persyaratan
Untuk menerapkan App Flip, Anda harus memenuhi persyaratan berikut:
- Anda harus memiliki aplikasi Android atau iOS.
- Anda harus memiliki, mengelola, dan mengelola server OAuth 2.0 yang mendukung alur kode otorisasi OAuth 2.0.
Untuk informasi selengkapnya tentang alur kode otorisasi penautan OAuth, lihat Mengimplementasikan server OAuth 2.0 Anda.
Untuk petunjuk cara mengonfigurasi App Flip bagi Tindakan Anda, lihat App Flip berbasis OAuth.