Mempersiapkan penghentian penggunaan cookie pihak ketiga

Peringatan: Chrome telah mengumumkan bahwa cookie pihak ketiga (pihak ketiga) tidak lagi dihentikan penggunaannya. Panduan yang dijelaskan di sini tidak lagi diperlukan, dan add-on tidak akan terpengaruh pada awal tahun 2025. Namun, Chrome bermaksud untuk lebih meningkatkan pilihan pengguna seputar cookie pihak ketiga, sehingga mungkin masih ada masa depan ketika akses cookie pihak ketiga lebih terbatas daripada saat ini. Oleh karena itu, panduan ini mungkin masih berguna bagi developer yang tertarik untuk memahami cara cookie pihak ketiga digunakan dalam add-on dan mempersiapkan diri untuk menghadapi potensi perubahan ketersediaan cookie pihak ketiga seiring pengalaman pengguna Chrome yang berkembang.

Panduan ini membantu Anda memahami dampak dan perubahan yang diperlukan pada add-on Anda yang diperkenalkan oleh Chrome yang mengakhiri dukungan untuk cookie pihak ketiga.

Ringkasan

Pada 4 Januari 2024, Chrome memperkenalkan Fitur Anti-Pelacakan, yang membatasi akses situs ke cookie pihak ketiga (3P) secara default, kepada 1% pengguna. Pada awal tahun 2025, Chrome akan menghentikan penggunaan cookie pihak ketiga sepenuhnya.

Setidaknya dua perjalanan pengguna terdampak di add-on Classroom:

1. Alur single sign-on (SSO) Google
2. Meluncurkan pengguna ke tab baru

SSO Google

Selama alur SSO Google, pengguna akan diarahkan ke dialog untuk login ke Akun Google mereka dan mengizinkan pembagian data.

Gambar 1. Visualisasi tiga konteks cookie yang berbeda selama SSO dari dalam iframe: (1) aplikasi Classroom tingkat atas, (2) iframe tersemat pihak ketiga (DavidPuzzle di localhost dalam hal ini), dan (3) dialog OAuth tingkat atas.

Dalam penerapan add-on standar, cookie sesi ditetapkan saat proses login ini selesai. Iframe add-on, yang berada dalam konteks tersemat, dimuat ulang, sekarang dengan cookie sesi, yang memungkinkan pengguna mengakses sesi yang diautentikasi. Namun, jika cookie pihak ketiga dinonaktifkan, situs dalam konteks tersemat seperti iframe add-on tidak dapat mengakses cookie dari konteks level teratas masing-masing. Untuk add-on Classroom, pengguna tidak dapat mengakses sesi yang diautentikasi dan terjebak dalam loop login.

Untuk implementasi yang menetapkan cookie sesi dalam konteks iframe tersemat, masalah ini dapat dimitigasi oleh CHIPS API, yang memungkinkan situs tersemat untuk menetapkan dan mengakses cookie yang dipartisi (cookie yang diberi kunci di domain tersemat dan domain tersemat). Namun, penerapan yang menetapkan cookie sesi di konteks tingkat atas dialog login tidak dapat mengakses cookie yang tidak dipartisi di iframe, sehingga mencegah login.

Tab baru

Untuk alasan serupa, jika pengguna memiliki sesi terautentikasi berbasis cookie dalam iframe add-on, dan iframe meluncurkan pengguna ke tab tingkat teratas baru untuk suatu aktivitas, tab tingkat teratas tidak dapat mengakses cookie sesi yang dipartisi dari iframe. Hal ini mencegah status sesi iframe tetap ada di aktivitas tab baru dan dapat memaksa pengguna untuk login lagi di tab baru, misalnya. Secara desain, CHIPS API tidak dapat menyelesaikan masalah ini; cookie iframe yang dipartisi tidak dapat diakses dalam konteks tingkat atas.

Tindakan developer

Ada beberapa tindakan yang harus Anda pertimbangkan untuk memastikan add-on Anda terus berfungsi sebagaimana mestinya saat Chrome menghentikan penggunaan cookie pihak ketiga secara bertahap.

1. Audit penggunaan cookie pihak ketiga dalam perjalanan penting pengguna add-on Anda. Lebih khusus lagi, uji dengan cookie pihak ketiga yang dinonaktifkan untuk mengevaluasi dampaknya terhadap penerapan spesifik Anda.

2. Jelajahi Storage Access API. Untuk semua penerapan add-on, sebaiknya Anda mempelajari Storage Access API (SAA). SAA memungkinkan iframe mengakses cookie-nya di luar konteks iframe. SAA tersedia di Chrome saat ini, dan didukung oleh aplikasi Classroom.

   Catatan: Jika alur SSO tidak menetapkan cookie dalam konteks dialog dan add-on tidak meluncurkan pengguna ke tab tingkat atas, Anda mungkin tidak memerlukan SAA. Pelajari CHIPS API yang lebih sederhana untuk melihat apakah API tersebut memenuhi kebutuhan Anda atau tidak.

3. Ikut serta dalam FedCM. Selain itu, jika Anda menggunakan GIS, library Login dengan Google, panduan resmi dari tim Identitas adalah memilih untuk menggunakan FedCM. Hal ini tidak menggantikan kemampuan cookie pihak ketiga, tetapi pada akhirnya akan diwajibkan di GIS sebagai bagian dari penghentian penggunaan cookie pihak ketiga. FedCM tersedia di Chrome saat ini dan didukung di Classroom, tetapi perilaku dan fiturnya masih dalam pengembangan dan terbuka untuk masukan.

4. Bermigrasi ke GIS. Jika Anda menggunakan library GSIv2 yang tidak digunakan lagi, yang juga dikenal sebagai library Login dengan Google, sebaiknya Anda bermigrasi ke GIS, karena dukungan untuk GSIv2 ke depannya tidak jelas.

5. Ajukan permohonan penundaan uji coba penghentian. Chrome menawarkan uji coba penghentian untuk memungkinkan kasus penggunaan non-iklan menunda efek penghentian penggunaan cookie pihak ketiga. Jika disetujui, Anda akan diberi token yang dapat digunakan di add-on untuk tetap mengaktifkan cookie pihak ketiga untuk origin Anda hingga tahun 2024, sekaligus bermigrasi ke solusi jangka panjang seperti SAA. Setelah mengajukan permohonan, Anda akan diminta untuk memberikan ID bug atau link untuk laporan kerusakan. Tim kami telah melaporkan masalah ini untuk add-on Classroom dan Anda dapat memberikan bug ini.

Peringatan: Developer yang diterima dalam uji coba penghentian penggunaan akan otomatis mengaktifkan cookie pihak ketiga selama masa tenggang meskipun tanpa token di aplikasi mereka. Perhatikan peringatan ini jika Anda ingin menggunakan penghentian penggunaan 1% untuk menguji cara add-on berfungsi tanpa cookie pihak ketiga.

Catatan: Uji coba penghentian penggunaan ditujukan untuk aplikasi yang sudah ada. Jika Anda sedang membuat add-on saat ini, rencanakan untuk membangun dengan SAA atau implementasi lain yang memungkinkan add-on berfungsi tanpa cookie pihak ketiga. Anda mungkin tidak memenuhi syarat untuk uji coba penghentian jika belum memiliki aplikasi yang terpengaruh.

Catatan: Chrome telah mengumumkan perubahan linimasa dalam penghentian cookie pihak ketiga dari paruh kedua tahun 2024 hingga awal tahun 2025. Perubahan ini dapat memengaruhi durasi uji coba penghentian, dan halaman ini akan diperbarui untuk mencerminkan perubahan.