Sesuaikan tantangan

Halaman verifikasi yang gerbang tampilkan diatur per kunci situs, di halaman Gerbang proxy miliknya di dasbor, dan lewat management API, MCP, dan Terraform seperti setiap pengaturan lain. Tiap opsi di bawah defaultnya adalah perilaku yang sudah kamu punya, jadi kunci situs yang tak pernah kamu sentuh tetap bekerja persis seperti sebelumnya.

Pilih game atau kotak centang

Jenis tantangan menentukan apa yang pengunjung benar-benar lakukan:

Dua aturan membatasi pilihan itu:

• Kunci situs yang mewajibkan game selalu menampilkan game. Jika pengaturan Wajibkan game untuk verifikasi milik kunci situs itu sendiri menyala, atau timmu mewajibkan game pada tiap kunci, opsi kotak centang tak tersedia dan dasbor menyebut pengaturan mana yang mematoknya. Menyetelnya lewat API mengembalikan 409 gate-forces-game-mode.
• Memilih game butuh game terpasang. Kunci situs butuh setidaknya satu game terpasang dengan artefak yang bisa diputar ulang, miliknya sendiri atau warisan dari tim. Tanpa satu pun, yang mengembalikan 409 no-games adalah memilih jenis game. Menyalakan gerbang saja tidak: kunci situs yang tidak mewajibkan game akan mundur ke kotak centang, jadi gerbang tetap bekerja selagi kamu membereskan game-nya.

Kasus terakhir itu perlu kamu kenali, karena ia membuat situs bergerbang tidak bisa diakses: gerbang menjawab tiap pengunjung dengan halaman "Verifikasi tidak tersedia" sampai ada game yang tersedia lagi. Ia juga bisa datang tanpa ada yang mengubah pengaturan, sebab sebuah game baru dihitung begitu versi yang dipatoknya lolos pemeriksaan determinisme kami. Halaman Gerbang proxy memperingatkan setiap kali sebuah kunci situs berada di keadaan itu dan menautkan ke daftar game sekaligus ke pengaturan yang mewajibkan game, jadi kamu bisa memasang satu game atau mencabut kewajibannya dan membiarkan kotak centang yang mengambil alih.

Patok satu bahasa atau satu tema

Baik Bahasa maupun Tema defaultnya ikuti pengunjung, dan itu hampir selalu yang kamu mau:

• Bahasa mengikuti bahasa peramban pengunjung sendiri, dalam sebelas bahasa yang sama dengan yang widget dukung.
• Tema mengikuti preferensi terang atau gelap sistem pengunjung, dan berganti bersamanya.

Patok salah satunya sebagai gantinya saat situs bergerbang itu berbahasa tunggal, atau saat ia berpegang pada satu tema dan kamu ingin verifikasi menyesuaikannya ketimbang mengikuti perangkat pengunjung.

Bagaimanapun, halaman verifikasi membawa merek kunci situs ini: nama merek, logo, warna, dan tautan yang sama dengan yang widget-mu pakai, diturunkan dari kunci situs yang sama. Itu kamu atur sekali, di pengaturan tampilan widget-mu, dan gerbang mengambilnya. Preset merek kustom butuh paket Apex, sama seperti untuk widget; opsi bahasa dan tema itu sendiri bekerja di tiap paket yang menyediakan gerbang.

Kata-kata halaman verifikasi itu sendiri tak bisa disesuaikan.

Ganti nama cookie dan jalur callback

Ubah ini hanya saat nilai default berbenturan dengan app-mu.

Nama cookie (default cpt_gate) adalah cookie pihak-pertama yang proxy-mu set dari pass. Ganti namanya jika app-mu sudah memakai nama itu, atau jika kamu menjalankan beberapa app bergerbang pada satu domain dan ingin meloloskannya secara terpisah.

Field yang di-POST ke callback-mu selalu cpt_gate, apa pun nama yang kamu beri ke cookie. Jadi pembacaan body di callback-mu tak pernah berubah; yang berubah hanya nama yang ia tulis di Set-Cookie. Respons dari gerbang menyertakan field cookie_name yang memberi tahu callback-mu nama mana yang dipakai.

Jalur callback (default /__cpt/callback) adalah rute di origin-mu sendiri yang menerima pass dan men-set cookie. Pindahkan jika router app-mu sudah memiliki jalur itu. Ia harus berupa jalur polos di origin-mu: tanpa skema, tanpa host, tanpa query string, tanpa fragmen.

Persempit gerbang ke sebagian jalur

Lindungi hanya jalur ini dan Jangan pernah lindungi jalur ini menerima satu pola per baris dan membentuk konfigurasi reverse proxy yang dihasilkan. Biarkan keduanya kosong dan tiap jalur akan bergerbang.

Keduanya bersifat anjuran: keduanya mengubah cuplikan yang kamu salin, dan yang menegakkannya adalah proxy-mu. Selalu biarkan sub-permintaan otorisator dan jalur callback-mu tanpa gerbang, yang mana konfigurasi yang dihasilkan sudah melakukannya untukmu.

Portal login yang umum:

Lindungi hanya jalur ini:
/
/api/firstfactor

Jangan pernah lindungi jalur ini:
/api/verify
/healthz

Lihat juga

• Siapkan gerbang halaman proxy: penelusuran nginx.
• Resep reverse proxy: kontrak callback dan proxy lainnya.
• Ikhtisar: konsepnya dan cookie izin lewat.