Google API tertentu (yang menerima cakupan Sensitif atau Dibatasi) memiliki persyaratan untuk aplikasi yang meminta izin untuk mengakses data konsumen. Persyaratan tambahan untuk cakupan yang dibatasi ini mengharuskan aplikasi menunjukkan bahwa aplikasi tersebut adalah jenis aplikasi yang diizinkan dan mengirimkan peninjauan tambahan, yang mencakup kemungkinan penilaian keamanan.
Penerapan cakupan yang dibatasi dalam API sebagian besar bergantung pada tingkat akses yang diperlukan untuk menyediakan fitur yang relevan di aplikasi Anda: hanya baca, hanya tulis, baca dan tulis, dll.
Saat Anda menggunakan OAuth 2.0 untuk mendapatkan izin dari Akun Google guna mengakses data ini, Anda menggunakan string yang disebut cakupan untuk menentukan jenis data yang ingin Anda akses dan seberapa banyak akses yang Anda perlukan. Jika aplikasi Anda meminta cakupan sensitif atau dibatasi, Anda harus menyelesaikan proses verifikasi, kecuali jika penggunaan aplikasi Anda memenuhi syarat untuk pengecualian.
Cakupan yang dibatasi jumlahnya lebih sedikit dibandingkan dengan cakupan sensitif. FAQ Verifikasi API OAuth berisi daftar cakupan Sensitif dan Dibatasi saat ini. Cakupan ini memberikan akses luas ke data pengguna Google dan mengharuskan Anda melalui proses verifikasi cakupan sebelum meminta cakupan dari Akun Google mana pun. Untuk mengetahui informasi tentang persyaratan ini, lihat Kebijakan Data Pengguna Layanan Google API dan Persyaratan tambahan untuk cakupan API tertentu atau halaman Developer Google khusus produk. Jika Anda menyimpan atau mengirimkan data cakupan yang dibatasi di server, Anda harus menyelesaikan penilaian keamanan.
Memahami cakupan yang dibatasi
Jika aplikasi Anda meminta cakupan yang dibatasi dan tidak memenuhi syarat untuk pengecualian, Anda harus memenuhi Persyaratan tambahan untuk cakupan API tertentu dalam Kebijakan Data Pengguna Layanan Google API, atau persyaratan khusus produk di halaman Google Developer produk, yang memerlukan proses peninjauan yang lebih ekstensif.
Memahami penggunaan cakupan Anda
- Tinjau cakupan yang digunakan atau ingin digunakan aplikasi Anda. Untuk menemukan penggunaan cakupan yang ada, periksa kode sumber aplikasi Anda untuk mengetahui cakupan yang dikirim dengan permintaan otorisasi.
- Pastikan setiap cakupan yang diminta diperlukan untuk tindakan yang dimaksudkan pada fitur aplikasi Anda dan menggunakan hak istimewa terendah yang diperlukan untuk menyediakan fitur tersebut. Google API biasanya memiliki dokumentasi referensi di halaman Google Developer produk untuk endpoint-nya yang mencakup cakupan yang diperlukan untuk memanggil endpoint atau properti tertentu di dalamnya. Untuk mengetahui informasi selengkapnya tentang cakupan akses yang diperlukan untuk endpoint API yang dipanggil aplikasi Anda, baca dokumentasi referensi endpoint tersebut. Misalnya, untuk aplikasi yang hanya menggunakan Gmail API untuk sesekali mengirim email atas nama pengguna, jangan meminta cakupan yang memberikan akses penuh ke data email pengguna.
- Data yang Anda terima dari Google API hanya boleh digunakan sesuai dengan kebijakan API dan dengan cara yang Anda sampaikan kepada pengguna dalam tindakan aplikasi dan dalam kebijakan privasi Anda.
- Lihat dokumentasi API untuk mempelajari lebih lanjut setiap cakupan, termasuk potensi status sensitif atau dibatasi.
- Deklarasikan semua cakupan yang digunakan oleh aplikasi Anda di halaman Akses Data Konsol Cloud. Cakupan yang Anda tentukan dikelompokkan ke dalam kategori sensitif atau kategori yang dibatasi untuk menyoroti verifikasi tambahan yang diperlukan.
- Temukan cakupan terbaik yang cocok dengan data yang digunakan oleh integrasi Anda, pahami penggunaannya, konfirmasi ulang bahwa semuanya masih berfungsi di lingkungan pengujian, lalu bersiaplah untuk mengirimkannya untuk verifikasi.
Pastikan untuk memperhitungkan waktu yang diperlukan untuk menyelesaikan verifikasi ke dalam rencana peluncuran aplikasi Anda atau fitur baru apa pun yang memerlukan cakupan baru. Salah satu persyaratan tambahan ini berlaku jika aplikasi mengakses atau memiliki kemampuan untuk mengakses data pengguna Google dari atau melalui server. Dalam kasus ini, sistem harus menjalani penilaian keamanan tahunan dari penilai pihak ketiga independen yang disetujui oleh Google. Oleh karena itu, proses verifikasi cakupan yang dibatasi dapat memerlukan waktu beberapa minggu untuk diselesaikan. Perhatikan bahwa semua aplikasi harus menyelesaikan langkah verifikasi merek terlebih dahulu, yang biasanya memerlukan waktu 2-3 hari kerja, jika informasi branding telah berubah sejak verifikasi layar izin OAuth terakhir yang disetujui.
Jenis aplikasi yang diizinkan
Jenis aplikasi tertentu dapat mengakses cakupan yang dibatasi untuk setiap produk. Anda dapat menemukan jenis aplikasi di Halaman Google Developers khusus produk (misalnya, Kebijakan Gmail API).
Anda bertanggung jawab untuk memahami dan menentukan jenis permohonan Anda. Namun, jika Anda benar-benar tidak yakin dengan jenis aplikasi Anda, Anda dapat memilih tidak ada opsi untuk pertanyaan Fitur apa yang akan Anda gunakan? saat mengirimkan aplikasi untuk verifikasi. Tim verifikasi Google API kemudian akan menentukan jenis aplikasi.
Penilaian keamanan
Setiap aplikasi yang meminta akses ke data yang dibatasi milik pengguna Google dan memiliki kemampuan untuk mengakses data dari atau melalui server pihak ketiga harus menjalani penilaian keamanan dari penilai keamanan yang dipilih Google. Penilaian ini membantu menjaga keamanan data pengguna Google dengan memverifikasi bahwa semua aplikasi yang mengakses data pengguna Google menunjukkan kemampuan untuk menangani data dengan aman dan menghapus data pengguna atas permintaan pengguna.
Untuk menstandarkan penilaian keamanan, kami menggunakan App Defense Alliance dan framework penilaian keamanan aplikasi cloud (CASA).
Seperti yang disebutkan sebelumnya, agar tetap dapat mengakses cakupan yang dibatasi dan terverifikasi, aplikasi harus diverifikasi ulang untuk kepatuhan dan menyelesaikan penilaian keamanan setidaknya setiap 12 bulan setelah tanggal persetujuan Surat Penilaian (LOA) penilai Anda. Jika aplikasi Anda menambahkan cakupan baru yang dibatasi, aplikasi Anda mungkin perlu dinilai ulang untuk mencakup cakupan tambahan jika tidak disertakan dalam penilaian keamanan sebelumnya.
Tim peninjau Google akan mengirimkan email kepada Anda saat tiba waktunya untuk menyertifikasi ulang aplikasi Anda. Untuk memastikan anggota tim Anda yang tepat diberi tahu tentang penegakan tahunan ini, kaitkan Akun Google tambahan dengan project Konsol Cloud Anda sebagai Pemilik atau Editor. Hal ini juga membantu memperbarui email dukungan pengguna dan kontak developer yang ditentukan di halaman Branding OAuth Konsol Google Cloud.
Langkah-langkah untuk mempersiapkan verifikasi
Semua aplikasi yang menggunakan Google API untuk meminta akses ke data harus melakukan langkah-langkah berikut untuk menyelesaikan verifikasi merek:
- Konfirmasi bahwa aplikasi Anda tidak termasuk dalam kasus penggunaan apa pun di bagian Pengecualian untuk persyaratan verifikasi.
- Pastikan aplikasi Anda mematuhi persyaratan branding API atau produk terkait. Misalnya, lihat pedoman branding untuk cakupan Login dengan Google.
- Verifikasi kepemilikan domain yang diizinkan untuk project Anda dalam Google Search Console. Gunakan Akun Google yang terkait dengan project Konsol API Anda sebagai Pemilik atau Editor.
- Pastikan semua informasi branding di layar izin OAuth, seperti nama aplikasi, email dukungan, URI halaman beranda, URI kebijakan privasi, dll., secara akurat mewakili identitas aplikasi.
Persyaratan halaman beranda aplikasi
Pastikan halaman beranda Anda memenuhi persyaratan berikut:
- Halaman beranda Anda harus dapat diakses secara publik, dan tidak hanya dapat diakses oleh pengguna yang login ke situs Anda.
- Relevansi halaman beranda Anda dengan aplikasi yang sedang ditinjau harus jelas.
- Link ke listingan aplikasi Anda di Google Play Store atau halaman Facebook-nya tidak dianggap sebagai halaman beranda aplikasi yang valid.
Persyaratan link kebijakan privasi aplikasi
Pastikan kebijakan privasi aplikasi Anda memenuhi persyaratan berikut:
- Kebijakan privasi harus dapat dilihat oleh pengguna, dihosting dalam domain yang sama dengan halaman beranda aplikasi Anda, dan ditautkan di layar izin OAuth Konsol API Google. Perhatikan bahwa halaman beranda harus menyertakan deskripsi fungsi aplikasi, serta link ke kebijakan privasi dan persyaratan layanan opsional.
- Kebijakan privasi harus mengungkapkan cara aplikasi Anda mengakses, menggunakan, menyimpan, atau membagikan data pengguna Google. Kebijakan privasi harus mematuhi Kebijakan Data Pengguna Layanan Google API dan persyaratan Penggunaan Terbatas untuk cakupan yang dibatasi. Anda harus membatasi penggunaan data pengguna Google pada praktik yang diungkapkan dalam kebijakan privasi yang Anda publikasikan.
- Tinjau contoh kasus kebijakan privasi yang tidak memenuhi persyaratan Penggunaan Terbatas.
Cara mengirimkan aplikasi Anda untuk verifikasi merek
Project Konsol Google Cloud mengatur semua resource Konsol Cloud Anda. Sebuah project terdiri dari sekumpulan Akun Google terkait yang memiliki izin untuk melakukan operasi project, sekumpulan API yang diaktifkan, serta setelan penagihan, autentikasi, dan pemantauan untuk API tersebut. Misalnya, project dapat berisi satu atau beberapa klien OAuth, mengonfigurasi API untuk digunakan oleh klien tersebut, dan mengonfigurasi layar izin OAuth yang ditampilkan kepada pengguna sebelum mereka mengizinkan akses ke aplikasi Anda.
Jika ada klien OAuth Anda yang belum siap untuk produksi, sebaiknya Anda menghapusnya dari project yang meminta verifikasi. Anda dapat melakukannya di halaman Klien.
Untuk mengirimkan verifikasi, ikuti langkah-langkah berikut:
- Pastikan aplikasi Anda mematuhi Persyaratan Layanan Google API, dan Kebijakan Data Pengguna Layanan Google API.
- Selalu perbarui peran pemilik dan editor akun terkait project Anda, serta email dukungan pengguna dan informasi kontak developer di layar izin OAuth, di Konsol Cloud Anda. Tindakan ini memastikan bahwa anggota tim Anda yang tepat akan diberi tahu tentang persyaratan baru.
- Buka halaman Branding OAuth Konsol Cloud.
- Klik tombol Project selector.
Pada dialog Select from yang muncul, pilih project Anda. Jika Anda tidak dapat menemukan project, tetapi mengetahui project ID, Anda dapat membuat URL di browser dalam format berikut:
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
Ganti [PROJECT_ID] dengan project ID yang ingin Anda gunakan.
Di halaman Branding, berikan informasi branding aplikasi Anda, termasuk nama aplikasi, logo, informasi kontak developer, dan link yang relevan. Setiap perubahan yang Anda buat akan disimpan sebagai Branding Draf.
Klik tombol Verify Branding untuk memulai proses evaluasi. Peninjauan otomatis biasanya selesai dalam beberapa menit.
Setelah evaluasi selesai, tinjau statusnya. Jika berhasil, status akan berubah menjadi Siap dipublikasikan. Jika verifikasi otomatis gagal, Anda dapat melihat masalah yang terdeteksi dan memperbaikinya atau meminta peninjauan manual.
Klik tombol Publikasikan branding untuk menayangkan branding baru.
Jika aplikasi Anda juga memerlukan verifikasi untuk cakupan sensitif atau yang dibatasi, buka Pusat Verifikasi OAuth untuk melacak Status akses data Anda dan memberikan informasi tambahan yang diminta, seperti video demonstrasi. Perhatikan bahwa Anda harus memiliki status branding yang dipublikasikan sebelum dapat meminta verifikasi untuk akses data.
Gunakan tombol Tambahkan atau hapus cakupan untuk mendeklarasikan semua cakupan yang diminta oleh aplikasi Anda. Kumpulan cakupan awal yang diperlukan untuk Login dengan Google telah diisi otomatis di bagian Cakupan tidak sensitif. Cakupan yang ditambahkan diklasifikasikan sebagai tidak sensitif, sensitif, atau dibatasi.
Berikan hingga tiga link ke dokumentasi yang relevan untuk fitur terkait di aplikasi Anda.
Berikan informasi tambahan yang diminta tentang aplikasi Anda di langkah berikutnya.
- Pastikan aplikasi Anda mematuhi Persyaratan tambahan untuk cakupan API tertentu, yang mencakup menjalani penilaian keamanan tahunan jika aplikasi Anda mengakses data pengguna Google dengan cakupan yang dibatasi dari atau melalui server pihak ketiga.
- Pastikan aplikasi Anda adalah salah satu jenis yang diizinkan yang ditentukan di bagian Penggunaan Terbatas di halaman Persyaratan tambahan untuk cakupan API tertentu.
- Jika aplikasi Anda adalah platform otomatisasi tugas, video demonstrasi Anda harus menampilkan cara beberapa alur kerja API dibuat dan diotomatiskan, serta arah aliran data pengguna.
- Siapkan video yang sepenuhnya menunjukkan cara pengguna memulai dan memberikan
akses ke cakupan yang diminta dan menunjukkan, secara mendetail, penggunaan
cakupan sensitif dan dibatasi yang diberikan di aplikasi. Upload video ke
YouTube Studio dan tetapkan Visibilitas sebagai Tidak Publik. Anda harus
memberikan link ke video demonstrasi di kolom link YouTube.
- Tampilkan proses pemberian izin OAuth yang akan dialami pengguna, dalam bahasa Inggris. Hal ini mencakup alur izin dan, jika Anda menggunakan Login dengan Google, alur login.
- Tunjukkan bahwa layar izin OAuth menampilkan Nama Aplikasi dengan benar.
- Tunjukkan bahwa kolom URL browser di layar izin OAuth menyertakan client ID OAuth aplikasi Anda dengan benar.
- Untuk menunjukkan cara data akan digunakan, tunjukkan fungsi yang diaktifkan oleh setiap cakupan sensitif dan dibatasi yang Anda minta.
- Jika Anda menggunakan beberapa klien, dan oleh karena itu memiliki beberapa client ID OAuth, tunjukkan cara data diakses di setiap klien OAuth.
- Pilih jenis aplikasi yang diizinkan dari daftar "Fitur apa yang akan Anda gunakan?".
- Jelaskan cara Anda akan menggunakan cakupan yang dibatasi di aplikasi Anda dan alasan cakupan yang lebih terbatas tidak memadai.
Setelah Anda memublikasikan branding atau mengirimkan permintaan akses data, tim Kepercayaan & Keamanan Google dapat menindaklanjuti melalui email dengan informasi tambahan yang mereka perlukan atau langkah-langkah yang harus Anda selesaikan. Periksa alamat email Anda di bagian Informasi kontak developer dan email dukungan layar izin OAuth Anda untuk mengetahui permintaan informasi tambahan. Anda juga dapat melihat halaman Branding atau Pusat Verifikasi project untuk mengonfirmasi status peninjauan project saat ini, termasuk apakah proses peninjauan dijeda saat kami menunggu respons Anda.
Pengecualian untuk persyaratan verifikasi
Jika aplikasi Anda akan digunakan dalam salah satu skenario yang dijelaskan di bagian berikut, Anda tidak perlu mengirimkannya untuk ditinjau.
Penggunaan pribadi
Salah satu kasus penggunaan adalah jika Anda adalah satu-satunya pengguna aplikasi atau jika aplikasi Anda hanya digunakan oleh beberapa pengguna, yang semuanya Anda kenal secara pribadi. Anda dan sejumlah kecil pengguna mungkin tidak keberatan untuk melanjutkan melalui layar aplikasi yang belum diverifikasi dan memberikan akses ke aplikasi Anda kepada akun pribadi Anda.
Project yang digunakan di tingkat Pengembangan, Pengujian, atau Staging
Agar dapat mematuhi Kebijakan Google OAuth 2.0, sebaiknya Anda memiliki project yang berbeda untuk lingkungan pengujian dan produksi. Sebaiknya Anda hanya mengirimkan aplikasi untuk verifikasi jika ingin menyediakan aplikasi bagi pengguna mana pun yang memiliki Akun Google. Oleh karena itu, jika aplikasi Anda berada dalam fase pengembangan, pengujian, atau staging, verifikasi tidak diperlukan.
Jika aplikasi Anda sedang dalam tahap pengembangan atau pengujian, Anda dapat membiarkan Status Publikasi dalam setelan default Pengujian. Setelan ini berarti aplikasi Anda masih dalam pengembangan dan hanya tersedia untuk pengguna yang Anda tambahkan ke daftar pengguna pengujian. Anda harus mengelola daftar Akun Google yang terlibat dalam pengembangan atau pengujian aplikasi Anda.
Hanya data milik layanan
Jika aplikasi Anda menggunakan akun layanan untuk mengakses datanya sendiri, dan tidak mengakses data pengguna apa pun (yang ditautkan ke Akun Google), Anda tidak perlu mengirimkan untuk verifikasi.
Untuk memahami apa itu akun layanan, lihat Akun layanan dalam dokumentasi Google Cloud. Untuk mengetahui petunjuk tentang cara menggunakan akun layanan, lihat Menggunakan OAuth 2.0 untuk aplikasi server ke server.
Khusus penggunaan internal
Artinya, aplikasi ini hanya digunakan oleh orang-orang di organisasi Google Workspace atau Cloud Identity Anda. Project harus dimiliki oleh organisasi, dan layar izin OAuth-nya harus dikonfigurasi untuk jenis pengguna Internal. Dalam hal ini, aplikasi Anda mungkin memerlukan persetujuan dari administrator organisasi. Untuk mengetahui informasi selengkapnya, lihat Pertimbangan tambahan untuk Google Workspace.
- Pelajari lebih lanjut aplikasi publik dan internal.
- Pelajari cara menandai aplikasi Anda sebagai internal di FAQ Bagaimana cara menandai aplikasi saya sebagai khusus internal?
Penginstalan di seluruh domain
Jika Anda berencana agar aplikasi hanya menargetkan pengguna organisasi Google Workspace atau Cloud Identity dan selalu menggunakan penginstalan seluruh domain, aplikasi Anda tidak akan memerlukan verifikasi merek. Namun, jika aplikasi Anda menggunakan cakupan yang dibatasi atau sensitif, verifikasi aplikasi diperlukan. Hal ini karena penginstalan tingkat domain memungkinkan administrator domain memberikan akses ke data pengguna Anda kepada aplikasi pihak ketiga dan internal. Administrator organisasi adalah satu-satunya akun yang dapat menambahkan aplikasi ke daftar yang diizinkan untuk digunakan dalam domain mereka.
Pelajari cara menjadikan aplikasi Anda sebagai Penginstalan Seluruh Domain di FAQ Aplikasi saya memiliki pengguna dengan akun perusahaan dari Domain Google Workspace lain.