Urutan Panggilan API Supplicant
Topik ini menyediakan urutan panggilan tertentu untuk API supplicant.
Gambaran Umum Urutan Panggilan API Supplicant
Ketika pemohon menerima paket EAP dari penyedia, seperti titik akses, alur panggilan API suppliant berikut biasanya terjadi.
- Aplikasi memanggil EapHostPeerBeginSession dengan data konfigurasi EAPHost dan data pengguna. Panggilan yang berhasil mengembalikan handel sesi EAP_SESSION_HANDLE.
- Setiap paket yang diterima oleh pemohon diproses dengan panggilan ke EapHostPeerProcessReceivedPacket. Pemohon kemudian memanggil fungsi yang sesuai dengan kode tindakan yang dikembalikan oleh fungsi.
- Jika kode tindakan EapHostPeerResponseSend, maka pemohon memanggil EapHostPeerGetSendPacket untuk mendapatkan respons yang akan dikirim ke pengautentikasi.
- Jika selama sesi, kode tindakan yang dikembalikan ke pemohon EapHostPeerResponseRespond, itu menunjukkan bahwa atribut EAP tersedia. Pemohon kemudian memanggil EapHostPeerGetResponseAttributes untuk mendapatkannya. Atribut ini berisi data tambahan yang digunakan selama proses autentikasi. Setelah pemohon selesai memproses atribut yang disebutnya EapHostPeerSetResponseAttributes yang memperbarui data. Fungsi ini mengembalikan kode tindakan yang menentukan tindakan berikutnya dari pemohon.
- Jika kode tindakan EapHostPeerResponseInvokeUI pemohon menaikkan dialog antarmuka pengguna untuk mendapatkan data interaktif dari pengguna, seperti informasi masuk atau identitas. Lihat Interaksi Pengguna dengan Alur Panggilan API Supplicant di bawah ini.
- Jika kode tindakan EapHostPeerResponseResult, itu menunjukkan bahwa hasil sesi autentikasi tersedia untuk pemohon. Pemohon kemudian memanggil EapHostPeerGetResult untuk mendapatkan hasilnya. Terlepas dari apakah hasil menunjukkan keberhasilan atau kegagalan, pemohon memanggil EapHostPeerEndSession. Dalam kasus kegagalan, autentikasi ulang dapat dicoba dengan membuka sesi lain dengan EAPHost dan memberikan identitas baru, atau mencoba autentikasi dengan identitas asli lagi.
Interaksi Pengguna dengan Alur Panggilan API Supplicant
Dalam kasus tertentu, pemohon perlu mendapatkan informasi dari pengguna untuk melanjutkan proses autentikasi.
Daftar berikut menunjukkan urutan panggilan pada proses supplicant dan EAPHost UI yang diperlukan untuk mengaktifkan input interaktif.
Pemohon memperoleh konteks antarmuka pengguna saat ini dengan memanggil EapHostPeerGetUIContext.
Pemohon kemudian mengirim data konteks UI ke proses UI supplikasi.
Nota
Proses UI, yang biasanya mengumpulkan UI atau menangani antarmuka pengguna interaktif, terpisah dari proses supplikasi. Memisahkan dua proses bukanlah persyaratan EAPHost, tetapi melakukannya memiliki keuntungan memungkinkan proses UI berinteraksi dengan desktop.
Jika pemohon ingin merender UI dengan sendirinya maka ia memanggil fungsi EapHostPeerQueryInteractiveUIInputFields untuk mendapatkan bidang input untuk komponen UI interaktif yang akan dinaikkan. Jika tidak, ini mengikuti model tradisional memanggil antarmuka pengguna interaktif metode dengan memanggil EapHostPeerInvokeInteractiveUI
Nota
Jika EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED dikembalikan, pemohon harus mengikuti model tradisional memanggil antarmuka pengguna interaktif metode dengan memanggil EapHostPeerInvokeInteractiveUI. Jika ada kesalahan, EapHostPeerQueryInteractiveUIInputFields akan mengembalikan kode pengembalian selain NULL.
Apakah panggilan supplikasi EapHostPeerQueryInteractiveUIInputFields atau EaphostPeerInvokeInteractiveUI proses UI melewati data konteks yang ada dan memuat Eappcfg.dll. UI yang sesuai dinaikkan untuk mengumpulkan data baru. Data konteks UI baru, yang sekarang mungkin berisi input pengguna, disalin, dan data konteks lama dirilis dengan panggilan ke EapPeerFreeMemory.
Proses UI mengembalikan data konteks baru ke pemohon, yang memanggil EapHostPeerSetUIContext untuk mengaturnya.
Topik terkait