Supplicant API-Aufrufsequenz

Dieses Thema enthält die spezifische Aufrufsequenz für die supplicant-API.

Übersicht über supplicant-API-Aufrufsequenzen

Wenn das Supplicant ein EAP-Paket von einem Anbieter empfängt, z. B. einen Zugriffspunkt, tritt in der Regel der folgende supplicant API-Aufruffluss auf.

• Die Anwendung ruft EapHostPeerBeginSession mit EAPHost-Konfigurationsdaten und Benutzerdaten auf. Ein erfolgreicher Aufruf gibt ein EAP_SESSION_HANDLE Sitzungshandle zurück.
• Jedes Paket, das vom Supplicant empfangen wird, wird von einem Aufruf von EapHostPeerProcessReceivedPacketverarbeitet. Das Supplicant ruft dann die Funktion auf, die dem von der Funktion zurückgegebenen Aktionscode entspricht.
• Wenn der Aktionscode EapHostPeerResponseSendist, ruft die supplicant EapHostPeerGetSendPacket auf, um die Antwort abzurufen, die an den Authentifikator gesendet werden soll.
• Wenn während der Sitzung der Aktionscode, der an das Supplicant zurückgegeben wird, EapHostPeerResponseRespondist, gibt er an, dass EAP-Attribute verfügbar sind. Das Supplicant ruft dann EapHostPeerGetResponseAttributes auf, um sie abzurufen. Diese Attribute enthalten zusätzliche Daten, die während des Authentifizierungsprozesses verwendet werden. Nachdem supplicant die Verarbeitung der Attribute abgeschlossen hat, EapHostPeerSetResponseAttributes, die die Daten aktualisiert. Diese Funktion gibt einen Aktionscode zurück, der die nächste Aktion des Supplicants bestimmt.
• Wenn der Aktionscode EapHostPeerResponseInvokeUI löst das Supplicant ein Benutzeroberflächendialogfeld aus, um interaktive Daten vom Benutzer abzurufen, z. B. Anmeldeinformationen oder Identitätsinformationen. Weitere Informationen finden Sie unter "Benutzerinteraktion mit dem Supplicant API Call Flow" weiter unten.
• Wenn der Aktionscode EapHostPeerResponseResultist, gibt er an, dass die Ergebnisse der Authentifizierungssitzung für das Supplicant verfügbar sind. Das Supplicant ruft dann EapHostPeerGetResult- auf, um die Ergebnisse abzurufen. Unabhängig davon, ob die Ergebnisse erfolg- oder fehleranzeigen, ruft die supplicant-Aufrufe EapHostPeerEndSession. Im Falle eines Fehlers kann eine erneute Authentifizierung versucht werden, indem eine andere Sitzung mit EAPHost geöffnet und eine neue Identität bereitgestellt wird, oder die Authentifizierung mit der ursprünglichen Identität erneut versucht wird.

Benutzerinteraktion mit dem Aufruffluss der Supplicant-API

In bestimmten Fällen muss das Supplicant Informationen vom Benutzer abrufen, um den Authentifizierungsprozess fortzusetzen.

In der folgenden Liste wird die Abfolge der Aufrufe für den Prozess der supplicant- und EAPHost-Benutzeroberfläche veranschaulicht, die erforderlich sind, um interaktive Eingaben zu ermöglichen.

1. Das Supplicant ruft den aktuellen Benutzeroberflächenkontext ab, indem EapHostPeerGetUIContextaufgerufen wird.

2. Das Supplicant sendet dann die UI-Kontextdaten an den supplicant UI-Prozess.

   Anmerkung

   Der UI-Prozess, der in der Regel ui sammelt oder interaktive UI verarbeitet, unterscheidet sich von dem supplicant-Prozess. Das Trennen der beiden Prozesse ist keine Anforderung von EAPHost, hat jedoch den Vorteil, dass der UI-Prozess mit dem Desktop interagieren kann.

    

3. Wenn die Benutzeroberfläche selbst gerendert werden soll, ruft sie die EapHostPeerQueryInteractiveUIInputFields Funktion auf, um die Eingabefelder für interaktive UI-Komponenten abzurufen, die ausgelöst werden sollen. Andernfalls folgt es dem herkömmlichen Modell der interaktiven Benutzeroberfläche der Methode durch Aufrufen von EapHostPeerInvokeInteractiveUI-

   Anmerkung

   Wenn EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED zurückgegeben wird, muss das Supplicant dem herkömmlichen Modell der interaktiven Benutzeroberfläche der Methode folgen, indem EapHostPeerInvokeInteractiveUIaufgerufen wird. Wenn ein Fehler auftritt, gibt EapHostPeerQueryInteractiveUIInputFields einen anderen Rückgabecode als NULL-zurück.

    

4. Gibt an, ob die Supplicant EapHostPeerQueryInteractiveUIInputFields oder EaphostPeerInvokeInteractiveUI der UI-Prozess die vorhandenen Kontextdaten übergibt und Eappcfg.dlllädt. Die entsprechende Benutzeroberfläche wird ausgelöst, um die neuen Daten zu sammeln. Die neuen Benutzeroberflächenkontextdaten, die jetzt Benutzereingaben enthalten können, werden kopiert, und die alten Kontextdaten werden mit einem Aufruf von EapPeerFreeMemoryfreigegeben.

5. Der UI-Prozess gibt die neuen Kontextdaten an das Supplicant zurück, das EapHostPeerSetUIContext- aufruft, um sie festzulegen.

Verwandte Themen

API-Aufrufsequenz der Peermethode

API-Aufrufsequenz der Authenticator-Methode

EAPHost-Aufrufsequenz

EAPHost Supplicants