Partilhar via


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

Este tópico aborda a sequência de chamadas de 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 a solicitação de identidade do usuário e dados do usuário, o seguinte fluxo de chamada de API normalmente ocorre.

  • 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 precisa obter a identidade do usuário do método interno, ele chama 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 de métodos de túnel

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.

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

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

    Observação

    O processo da 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 da 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 da interface do usuário novas ou atualizadas para o método de mesmo nível EAP carregado no EAPHost após a interface do usuário ter sido gerada.

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

Tunnel Methods API Call Sequence

Sequência de chamadas EAPHost

Sequência de chamadas de API suplicante

de referência da API suplicante EAPHost