Freigeben über


Api-Aufrufsequenz der Authenticator-Methode

Dieses Thema enthält die spezifische Aufrufsequenz für die Authentifikator-Methoden-API. Während einer typischen EAP-Authentifizierungssitzung führt EAPHost eine Reihe von Aufrufen für eine EAP-Methode durch, die die EAPHost-Authentifikator-Methoden-APIs implementiert.

In der folgenden Liste wird die Abfolge der Aufrufe von EAPHost für eine EAP-Authentifikatormethode veranschaulicht.

  • Der EAP-Authentifikator lädt zuerst die EAP-Methoden-DLL, die für die spezifische Authentifizierung auf einem Netzwerkrichtlinienserver (NETWORK Policy Server, NPS) oder einem anderen Authentifizierungsserver verwendet wird.
  • Ruft EapAuthenticatorGetInfo- für die Methode mit einer aufgefüllten EAP_TYPE Struktur auf, um eine Liste von Zeigern auf Funktionen abzurufen, die in der DLL implementiert sind. Nachfolgende Funktionsaufrufe durch die Authentifikatormethoden (Server) werden für die DLL implementiert.
  • Ruft EapAuthenticatorInitialize auf, die EAP-Methodenbibliothek anzuweisen, mindestens eine Authentifizierungssitzung mithilfe dieser Authentifikatormethode vorzubereiten.
  • Ruft EapMethodAuthenticatorBeginSession- auf, um eine eindeutige Authentifizierungssitzung einzurichten.
  • Wiederholt die folgenden Schritte, bis EapMethodAuthenticatorReceivePacket angibt, dass ein Authentifizierungsergebnis verfügbar ist.
    • Ruft EapMethodAuthenticatorSendPacket mit einem Zeiger auf ein Anforderungspaket auf, das an das Supplicant übergeben werden soll.
    • Ruft EapMethodAuthenticatorReceivePacket- auf, um das vom Supplicant gesendete Antwortpaket abzurufen. Diese Funktion gibt einen EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION Code zurück, der die nächste Aktion angibt, die der Authentifikator in der EAP-Authentifizierungssitzung ausführen muss.
    • Wenn der Aktionscode EAP_METHOD_AUTHENTICATOR_RESPONSE_RESPONDist, gibt er an, dass die EAP-Methode Attribute für den Authentifikator zum Abrufen und Übergeben an die Peermethode verfügbar ist. Authenticator ruft EapMethodAuthenticatorGetAttributes- auf, um die verschiedenen EAP-Authentifizierungsattribute aus der EAP-Authentifizierungsmethode abzurufen. Nachdem der Authentifikator die Attribute verarbeitet hat, EapMethodAuthenticatorSetAttributes, die aktualisierte EAP-Authentifizierungsattribute bereitstellt, die für die EAP-Authentifizierungsmethode festgelegt werden sollen. Diese Funktion gibt einen EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION Code zurück, der die nachfolgende Aktion bestimmt.
  • Wenn der Aktionscode EAP_METHOD_AUTHENTICATOR_RESPONSE_RESULTist, gibt er an, dass der Authentifikator die Ergebnisse der Authentifizierungssitzung bestimmt hat und diese Ergebnisse für EAPHost verfügbar sind. Authenticator ruft EapMethodAuthenticatorGetResult auf und ruft die Ergebnisse der Authentifizierungssitzung ab.
  • Darauf folgt ein Aufruf vonEapMethodAuthenticatorEndSession zum Beenden der Authentifizierungssitzung.
  • Schließlich wird ein Aufruf an EapMethodAuthenticatorShutdown zum Entladen der Authentifikatormethoden-DLL ausgeführt.
  • Entlädt die EAP-Methodenbibliothek.

EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION

API-Aufrufsequenz

API-Aufrufsequenz der Peermethode

EAPHost-Aufrufsequenzen