Perihalan antara muka protokol pengesahan perkakasan Wi-Fi
Perihalan antara muka protokol pengesahan perkakasan Wi-Fi
Ikhtisar
Protokol pengesahan perkakasan digunakan terutamanya untuk mengubah kaedah pengesahan peranti jenis Portal, supaya peranti itu dapat mengenal pasti telefon pelanggan, membuat identiti pelanggan. dan PC pantas dan mudah Sambung ke Wi-Fi. Logik perniagaan klik butang "WeChat Connect" pada halaman Wi-Fi" untuk memasuki halaman sambungan, memaparkan logo dan nama akaun rasmi. Klik butang "Sambung Sekarang" untuk mula menyambung ke WiFi. Selepas sambungan berjaya, ia akan melompat ke halaman sambungan yang berjaya dan ikuti akaun rasmi pedagang.
Module Timing Diagram
Jika anda tidak dapat melihat teks dalam gambar dengan jelas, anda boleh terlebih dahulu menyimpan gambar secara setempat melalui "Simpan Gambar Sebagai" dan kemudian membesarkannya untuk melihatnya.
PC disambungkan ke Wi-Fi
Proses sambungan pengguna
Selepas pelanggan memilih SSID pada PC, buka halaman 2D dan portal paparan dipaparkan pada kod halaman. Gunakan WeChat pada telefon mudah alih anda untuk mengimbas kod QR, klik butang "Sahkan" pada halaman telefon mudah alih, sambungkan PC anda ke Wi-Fi dan halaman portal penyemak imbas secara automatik akan melompat ke halaman web yang dikonfigurasikan oleh pedagang.
Gambarajah pemasaan modul
Jika anda tidak dapat melihat teks dalam gambar dengan jelas, anda boleh menyimpan gambar secara setempat dahulu melalui "Simpan Imej Sebagai" dan kemudian membesarkannya untuk melihatnya.
Proses pelaksanaan terminal mudah alih
Sila ikut langkah di bawah untuk melengkapkan transformasi peranti dan membenarkan peranti mudah alih menggunakan WeChat untuk menyambung ke Wi-Fi.Langkah pertama: Dapatkan maklumat Wi-Fi kedai
Langkah pertama untuk mengubah peralatan jenis portal ialah mendapatkan maklumat Wi-Fi kedai, termasuk: appId, shop_id, ssid, secretkey. Terdapat dua cara untuk mendapatkan maklumat Wi-Fi kedai:1 diperolehi melalui operasi halaman
🎜.Dalam WeChat platform awamWeChat Wi-Fi plug-in, buka [Pengurusan Peranti]->[Tambah Peranti], tambahkan "Tambah kaedah WeChat untuk menyambung ke Internet + perkhidmatan medan dekat selepas menyambung ke Internet"- >"Peranti jenis portal"; selepas berjaya menambah, anda boleh mendapatkan maklumat parameter Wi-Fi kedai.
Peranti yang ditambahkan juga boleh mendapatkan maklumat parameter Wi-Fi kedai dalam [Butiran Peranti]->[Lihat Maklumat Pengubahsuaian Peranti].
2. Panggil antara muka untuk mendapatkan
Panggil "Tambah peranti portal" antara muka untuk mendapatkan.
Langkah 2: Ubah halaman portal mudah alih
Jika peranti yang disambungkan ialah peranti mudah alih, sebutkan WeChat JSAPI berikut dalam halaman portal untuk membolehkan halaman portal Wi-Fi asal memanggil WeChat Abilities :
<script type="text/javascript" src="https://wifi.weixin.qq.com/resources/js/wechatticket/wechatutil.js" ></script>
Panggil JSAPI untuk mencetuskan pelanggan WeChat:
Wechat_GotoRedirect( appId, extend, timestamp, sign, shop_id, authUrl, mac, ssid );
Contoh khusus:
Wechat_GotoRedirect( 'wx23fb4aaf04b8491e', 'demoNew', '1441768153341', 'a355c78bad9be9235d2105d28f8e010c', '6747662', 'http://wifi.weixin.qq.com/assistant/wifigw/auth.xhtml?httpCode=200', 'aa:aa:aa:aa:aa:aa', '2099');
Penerangan parameter
Adakah parameter | diperlukan | Penerangan | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
appId | ialah | akaun platform awam WeChat | ||||||||||||||||||||||||||||||
lanjutkan boleh disertakan Letakkan koleksi parameter yang berkaitan yang diperlukan oleh pembangun🎜 , yang akhirnya akan dihantar secara telus ke URL pengesahan pengendali. Parameter lanjutan hanya menyokong bahasa Inggeris dan nombor, dan panjangnya tidak boleh melebihi 300 aksara. | ||||||||||||||||||||||||||||||||
cap masa | ialah | cap masa menggunakan milisaat | ||||||||||||||||||||||||||||||
tanda | ialah | tandatangan parameter permintaan, kaedah pengiraan khusus diterangkan di bawah ialah | ||||||||||||||||||||||||||||||
authUrl | ialah | |||||||||||||||||||||||||||||||
. Peranti Android diperlukan | ||||||||||||||||||||||||||||||||
ssid | ialah nama rangkaian wayarles bagi | |||||||||||||||||||||||||||||||
Parameter | Penerangan | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
lanjutkan | ialah parameter lanjutan yang diluluskan apabila memanggil WeChat JSAPI di atas, yang dikembalikan ke halaman utama pedagang seperti sedia ada Id | |||||||||||||||||||||||
tid | ialah nombor telefon mudah alih pengguna yang disulitkan (hanya digunakan untuk pemfailan oleh jabatan penyeliaan rangkaian) | |||||||||||||||||||||||
Pelayan pengesahan latar belakang yang sepadan dengan authUrl mesti dapat mengenal pasti maklumat parameter ini dan mengembalikan hasil pengesahan AC kepada klien WeChat Pelanggan WeChat akan meminta pengguna sama ada sambungan berjaya atau tidak berdasarkan kod pengembalian http. Jika kod pengembalian http ialah 200, ia dianggap sebagai pengesahan perkhidmatan berjaya. Pelanggan WeChat melompat ke halaman sambungan yang berjaya pelayan pengesahan perlu memindahkan permintaan pengesahan, sila kembalikan 302 dan alamat hop seterusnya, klien WeChat akan memulakan permintaan lain ke alamat hop seterusnya, dan lompatan 302 hanya disokong sekali untuk bukan 200 dan 302, atau 302 kembali kod yang melebihi bilangan kali, ia dianggap sebagai kegagalan pengesahan, dan sambungan ini Rangkaian gagal dan klien WeChat melompat ke halaman kegagalan sambungan. Nota: Masa menunggu untuk permintaan pelanggan WeChat ialah 10s Sila pastikan pelayan pengesahan latar belakang mengembalikan hasil pengesahan AC, iaitu kod pengembalian http, dalam masa 10s selepas pelanggan WeChat menghantar permintaan kepada authUrl. Kegagalan untuk mengembalikan hasil pengesahan selama lebih daripada 10 saat akan dianggap sebagai kegagalan pengesahan. Langkah 5: Imbas kod QR untuk menyambung ke InternetSelepas melengkapkan langkah satu hingga empat, lakukan konfigurasi berikut untuk membolehkan peranti portal mengimbas kod QR untuk menyambung ke Wi-Fi. Operasi khusus adalah seperti berikut: 1. Ubah suai kandungan lompat pelayan portal Apabila pengguna telefon mudah alih yang tidak disahkan cuba menyambung ke Internet, AC akan mengubah hala permintaan http pengguna ke halaman Portal pada Pelayan Portal Di sini AC perlu mengenal pasti lebih lanjut Jika permintaan http datang daripada klien WeChat, ia akan mengubah hala Hanya bawa dua parameter authUrl yang dipersetujui dan lanjutkan pada URL. http://www.foo.com/portal/portal.html?authUrl=http%3A%2F%2Fwww.foo.com%2Fportal%2Fauth.html&extend=xxx
2. Bagaimana untuk mengenal pasti sama ada permintaan http datang daripada klien WeChat Hanya menghuraikan "User-Agent" dalam struktur pengepala paket http untuk menentukan sama ada ia mengandungi kata kunci "micromessenger" (sila berhati-hati untuk tidak memintas permintaan http WeChat yang lain, jadi sila padankan kata kunci dengan baik), kod sampel adalah seperti berikut: ... String userAgent = request.getHeader("User-Agent"); if(userAgent.matches(".*micromessenger.*")){ response.sendRedirect("http://www.foo.com/portal/portal.html?authUrl=http%3A%2F%2Fwww.foo.com%2Fportal%2Fauth.html&extend=xxx "); } ... Pelanggan WeChat akan menghuraikan authUrl dan melanjutkan parameter dalam alamat lompat Pelayan Portal dan terus menyelesaikan proses sambungan. 3. Halang IOS daripada muncul secara automatik di halaman portal Untuk mengelakkan IOS daripada muncul secara automatik di halaman portal apabila menukar SSID, sila tukar alamat menghidu IOS "http://captive.apple .com/hotspot-detect. html” ke dalam senarai putih. 4. Muat turun kod QR bahan Selepas melengkapkan transformasi pelayan portal, hubungi antara muka "Dapatkan kod QR bahan" untuk memuat turun kod QR kedai dan menyiarkannya di kedai untuk menyambung ke Wi-Fi. Contoh halaman portal mudah alih DemoSila rujuk contoh Demo untuk mengubah halaman Portal mudah alih (kod JS terus dalam halaman) Sila gunakan pelayar mudah alih untuk membuka pautan berikut (boleh dimasukkan secara manual, anda juga boleh mengimbas kod untuk mendapatkan alamat pautan): https://wifi.weixin.qq.com/operator/demoNew.xhtml Jika anda menggunakan WeChat untuk mengimbas kod, sila klik butang di sudut kanan atas dan pilih halaman "Buka dalam penyemak imbas", jangan alaminya secara langsung dalam pelayar WeChat. Soalan Lazim11 Penyemak imbas web sesetengah telefon Android tidak boleh memanggil pelanggan WeChat secara automatik Versi Android WeChat 6.2.5 dan ke atas sudah menyokong sambungan membuka secara manual. fungsi proses. Untuk memastikan proses ini berjalan lancar, pembangun perlu memberi perhatian kepada perkara berikut: 1.保证微信客户端版本为6.2.5以上的Android版微信; 2.参考示例demo中jsapi的写法,在无法自动跳转微信客户端时弹出提示,让用户手动切换到微信; 3.在portal页面中调用微信jsapi时,需保证AP设备的ssid和手机mac这2个参数真实有效; 4.测试过程请从切换到目标ssid动作开始(例如:原来为3G或4G网络然后手动选择目标ssid,原来为非目标ssid的wifi信号然后手动选择目标ssid,等等)。 2 Bagaimana untuk memastikan telefon kekal di bawah sasaran SSID selepas melompat dari halaman portal ke WeChat pada IOS? Untuk memastikan Wi-Fi tersedia, sistem IOS tidak akan beralih kepadanya serta-merta selepas pengguna memilih SSID Sebaliknya, ia akan menghidu sama ada perkhidmatan lalai pada rangkaian awam boleh dicapai melalui SSID. Jika ia boleh dihidu Hanya maka sambungan ke ssid sebenarnya muncul. Dalam persekitaran AP di mana portal muncul, titik ini digunakan untuk memaparkan halaman portal Jika pengesahan selesai pada halaman portal, gesaan di sudut kanan atas portal akan berubah daripada "Batal" kepada "Lengkap. ". Jika anda meninggalkan antara muka ini dalam keadaan "Lengkap", SSID yang baru anda pilih akan diputuskan sambungan dan kembali ke sambungan terakhir yang tersedia. Walau bagaimanapun, jika anda meninggalkan antara muka ini dalam keadaan "Lengkap", ia tidak akan diputuskan. Memandangkan antara muka portal akan melompat ke WeChat apabila lulus pengesahan WeChat, ia adalah prasyarat untuk memastikan status "Lengkap" di penjuru kanan sebelah atas portal. Pemaju perlu memberi perhatian kepada perkara berikut: 1.确保弹出portal后,临时放行手机的所有流量; 2.临时放行手机的所有流量后,局部或整体刷新portal页面触发IOS再次进行嗅探; 3.IOS嗅探可以正常触达公网上的预设服务后“取消”变为“完成”; 4.以上动作完成后,再调用跳转微信的JSAPI,继而跳转微信完成认证连接流程。 Proses pelaksanaan sisi PCSila ikuti langkah di bawah untuk menggunakan WeChat untuk menyambung ke Wi-Fi di sisi PC. Langkah pertama: Dapatkan maklumat Wi-Fi kedaiLangkah pertama untuk menyambungkan PC ke Wi-Fi ialah mendapatkan maklumat Wi-Fi kedai, termasuk: appId, shop_id. Terdapat dua cara untuk mendapatkan maklumat Wi-Fi kedai: 1 Dapatkan melalui operasi halaman Buka pemalam Wi-Fi WeChat pada platform awam WeChat, dan pergi ke [Pengurusan Peranti]->. ;[Tambah Peranti] , tambah "Tambah kaedah WeChat untuk menyambung ke Internet + perkhidmatan medan dekat selepas menyambung ke Internet" -> "Peranti jenis portal" selepas penambahan berjaya, anda boleh mendapatkan parameter Wi-Fi kedai maklumat. Peranti tambahan juga boleh mendapatkan maklumat parameter Wi-Fi kedai dalam [Butiran Peranti]->[Lihat Maklumat Pengubahsuaian Peranti]. 2. Dapatkan shop_id melalui antara muka Panggil "Dapatkan senarai kedai WiFi", iaitu ID kedai yang akan ditambahkan peranti. Langkah 2: Ubah suai halaman portal PCJika peranti yang disambungkan ialah PC, sebutkan WeChat JSAPI berikut dalam halaman portal supaya halaman portal Wi-Fi asal mempunyai keupayaan untuk memanggil WeChat Keupayaan: <script type="text/javascript" src="https://wifi.weixin.qq.com/resources/js/wechatticket/pcauth.js" ></script> Panggil JSAPI untuk menjana kod QR Kod sampel khusus adalah seperti berikut: <script type="text/javascript"> JSAPI.auth({ target : document.getElementById('qrcode_zone'), appId : 'wx23fb4aaf04b8491e', shopId : 6747662, extend : 'wechatpc', authUrl : 'http://wximg.qq.com/tmt/wifi-landing-pc/dist/html/index-success.html' }); </script> Penerangan parameter .
|