Melakukan crawl pada toko Anda
Anda dapat menggunakan Web Bot Auth untuk mengotorisasi perayap (crawler), skrip, atau alat Anda sendiri dengan aman untuk mengakses toko online Shopify publik Anda. Web Bot Auth mengandalkan tanda tangan pesan HTTP, yang dibuat di admin Shopify Anda. Anda harus menyertakan tanda tangan di header HTTP setiap permintaan agar permintaan tersebut dapat diverifikasi berasal dari sumber yang diotorisasi.
Anda dapat menggunakan tanda tangan dengan alat pihak pertama atau pihak ketiga otomatis yang mengakses toko online Anda untuk audit aksesibilitas dan SEO, pengujian otomatis, analisis data, dan kasus penggunaan serupa. Toko Anda dapat diindeks oleh mesin pencari dan model bahasa besar (LLM) tanpa tanda tangan.
Di halaman ini
Fitur tanda tangan
Tanda tangan memiliki fitur berikut:
- Autentikasi aman: Anda dapat membuat tanda tangan yang aman secara kriptografis untuk perayap Anda.
- Kontrol kedaluwarsa: Anda dapat mengatur masa kedaluwarsa tanda tangan setelah periode tertentu. Periode maksimumnya adalah 3 bulan.
- Manajemen terpusat: Anda dapat mengelola dan melihat semua tanda tangan Anda di satu tempat.
- Penamaan khusus: Anda dapat memberikan nama khusus pada setiap tanda tangan untuk mengidentifikasinya.
- Pelingkupan domain: Setiap tanda tangan digunakan untuk domain tertentu yang harus terhubung ke toko Shopify Anda.
Pertimbangan untuk membuat tanda tangan
Sebelum Anda membuat dan menggunakan tanda tangan, tinjau pertimbangan berikut:
- Perayapan toko Anda dengan tanda tangan hanya ditujukan untuk menganalisis etalase toko online Anda. Tanda tangan tidak memberikan akses ke Shopify Checkout Anda karena adanya lapisan keamanan checkout tambahan.
- Gunakan nama yang jelas dan deskriptif untuk tanda tangan Anda.
- Tanda tangan akan kedaluwarsa secara otomatis dan tidak dapat diperpanjang. Buat tanda tangan baru dan perbarui alat Anda setelah tanda tangan kedaluwarsa.
- Setiap tanda tangan digunakan untuk satu domain, jadi Anda harus menentukan domain terhubung mana yang akan digunakan untuk tanda tangan tersebut. Anda hanya dapat memilih domain yang telah terhubung ke Shopify.
Buat tanda tangan
Anda dapat membuat dan mengelola tanda tangan langsung di admin Shopify Anda.
Dari admin Shopify Anda, buka Toko Online > Preferensi.
Di bagian Akses crawler, klik Buat signature.
Di kolom Nama, masukkan nama deskriptif untuk signature Anda.
Di kolom Domain, pilih domain yang ingin Anda gunakan untuk signature ini.
Di bagian Masa berlaku, pilih periode kedaluwarsa untuk signature Anda.
Klik Buat.
Opsional: Untuk menyalin nilai Signature-Input dan Signature yang baru Anda buat, klik Salin di samping setiap nilai.
Setelah tanda tangan kedaluwarsa, tanda tangan tersebut tidak lagi valid. Anda tidak dapat memperbarui tanda tangan yang sudah kedaluwarsa, tetapi Anda dapat membuat yang baru.
Menambahkan tanda tangan ke permintaan
Anda dapat menyalin tanda tangan, lalu menambahkannya ke header HTTP dari permintaan Anda. Setiap tanda tangan terdiri dari 3 header HTTP yang harus Anda sertakan.
| Nama header | Nilai header |
|---|---|
| Signature-Input | Tambahkan nilai input signature Anda. |
| Signature | Tambahkan nilai signature Anda. |
| Signature-Agent | Nilai Signature-Agent adalah string yang berisi URI agen yang valid. Gunakan "https://shopify.com" (dengan tanda kutip) untuk nilai ini. |
Untuk petunjuk tentang cara menambahkan header kustom, lihat dokumentasi berikut:
Melihat tanda tangan
Anda dapat melihat informasi berikut tentang signature yang ada di admin Shopify Anda:
- Nama signature
- Domain terkait
- Beberapa karakter pertama dari nilai Signature-Input dan Signature
- Nilai Signature-Agent
- Tanggal dan status kedaluwarsa signature
Dari admin Shopify Anda, buka Toko Online > Preferensi.
Di bagian Akses perayap, tinjau informasi tentang tanda tangan Anda.
Memecahkan masalah tanda tangan
Pilih masalah signature dan ikuti langkah-langkah penyelesaian masalah.
Menyelesaikan masalah autentikasi
Jika crawler Anda menerima error pembatasan laju, berarti signature Anda tidak valid. Verifikasi informasi berikut:
- Pastikan Anda menggunakan format signature yang benar di header HTTP.
- Pastikan header Signature-Input, Signature, dan Signature-Agent dikirim bersama setiap permintaan.
- Verifikasi bahwa signature belum kedaluwarsa. Tinjau tanggal kedaluwarsa di admin Shopify Anda.
- Crawl domain yang terkait dengan signature.
Memulihkan tanda tangan yang hilang
Jika tanda tangan Anda hilang, Anda dapat memulihkannya dengan menyelesaikan langkah-langkah berikut:
- Dari admin Shopify Anda, buka Toko Online > Preferensi.
- Di bagian Akses crawler, temukan signature Anda dalam daftar.
- Klik Salin untuk menyalin nilai Signature-Input, Signature, dan Signature-Agent ke papan klip Anda.
Mengubah tanggal kedaluwarsa tanda tangan
Anda tidak dapat mengubah tanggal kedaluwarsa tanda tangan setelah Anda membuatnya. Untuk menetapkan tanggal kedaluwarsa yang berbeda, buat tanda tangan baru dengan tanggal kedaluwarsa yang diinginkan, lalu perbarui layanan Anda agar menggunakan tanda tangan yang baru.
Signature lama masih valid dan akan terus berfungsi hingga tanggal kedaluwarsa aslinya.