Compartilhar via


Sequência de chamadas da API do método de túnel

Este tópico aborda a sequência de chamada de API API para métodos de túnel

Visão geral da sequência de chamadas do método de túnel

Quando o suplicante recebe uma solicitação de identidade e dados do usuário, normalmente ocorre o seguinte fluxo de chamada da API.

  • O suplicante chama EapHostPeerProcessReceivedPacket em EapHost para processar o pacote recebido do autenticador.
  • Ao processar esse pacote, o EAPHost o determina como pacote IdentityRequest e chama EapPeerGetIdentity no método de túnel para obter a identidade do usuário a ser usada para autenticação.
  • Se o método de túnel precisar obter a identidade do usuário do método interno, ele chamará EAPHostPeerGetIdentity no EAPHost interno que, por sua vez, chama EapPeerGetIdentity no método interno.

Interação do usuário com o fluxo de chamadas da API Tunnel Methods

Em certos casos, quando a identidade não está disponível ou quando o usuário deve fornecer informações adicionais, o Método Eap gera uma caixa de diálogo de interface do usuário no suplicante.

Nesses casos, a sequência de chamadas a seguir normalmente ocorre para obter informações diretamente do usuário.

  • O método Eap de túnel retorna o código de ação para invocar a interface do usuário para EapHost. O suplicante chama EapHostPeerGetUIContextpara obter as informações de contexto da interface do usuário atuais para a caixa de diálogo da interface do usuário.

  • Em seguida, o suplicante chama EapHostPeerInvokeInteractiveUI. Essa função usa as informações de contexto da interface do usuário para gerar uma interface do usuário interativa que é usada para obter informações de credencial do usuário. O processo de interface do usuário carrega Eappcfg.dll e obtém os ponteiros para EapPeerInvokeInteractiveUI e EapPeerFreeMemory.

    Observação

    O processo de interface do usuário normalmente coleta a interface do usuário ou manipula a interface do usuário interativa e é separado do processo suplicante. Separar os dois processos não é um requisito do EAPHost, mas isso tem a vantagem de permitir que o processo de interface do usuário interaja com a área de trabalho.

     

  • EapHost chama EapPeerInvokeIdentityUI no método de túnel para obter informações de identidade do usuário.

  • Para obter a identidade do usuário do método interno, o método de túnel chama EapHostPeerInvokeIdentityUI no EAPHost interno.

  • O EAPHost interno chama EapPeerInvokeIdentityUI no método interno para invocar a interface do usuário de identidade do usuário.

  • EapHostPeerSetUIContext fornece informações de contexto de interface do usuário novas ou atualizadas para o método par EAP carregado no EAPHost depois que a interface do usuário é gerada.

O diagrama a seguir explica a sequência de chamadas da API para métodos de túnel

sequência de chamadas da API de métodos de túnel

Sequência de chamadas EAPHost

Sequência de chamadas de API suplicante

Referência da API do suplicante EAPHost