Solución de problemas del agente de autenticación web

En este tema se describen sugerencias para solucionar problemas al usar las API del agente de autenticación web en tus páginas web.

  • Registros operativos
  • Uso de Fiddler con el agente de autenticación web
  • Temas relacionados

Registros operativos

Con frecuencia, los registros operativos ayudan a determinar qué no está funcionando. Existe un canal de registro de eventos dedicado, Microsoft-Windows-WebAuth\Operational, que permite a los desarrolladores de sitios web comprender cómo el agente de autenticación web procesa sus páginas web. Para habilitarlo, inicia eventvwr.exe y habilita el registro operativo en Registros de aplicaciones y servicios\Microsoft\Windows\WebAuth. Asimismo, el agente de autenticación web anexa una cadena única a la cadena de agente de usuario para identificarse en el servidor web. La cadena es "MSAuthHost/1.0". Ten en cuenta que el número de versión podría cambiar en el futuro, por lo que no debes depender de dicho número de versión en tu código. El siguiente es un ejemplo de la cadena de agente de usuario completa:

User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; Win64; x64; Trident/6.0; MSAuthHost/1.0)

Ejemplo de uso de los registros operativos

  1. Habilitar los registros operativos
  2. Ejecuta la aplicación social de ContosoVisor de eventos que muestra los registros operativos WebAuth
  3. Las entradas de los registros generados se pueden usar para comprender el comportamiento del agente de autenticación web con más detalle. En este caso, pueden incluir:
    • Navegación - iniciar: registra cuándo se inicia AuthHost y contiene información sobre las direcciones URL de inicio y terminación.
    • Ilustra los detalles de Inicio de navegación
    • Navegación - completa: registra la finalización de la carga de una página web.
    • Etiqueta meta: registra cuándo se encuentra una etiqueta meta, incluidos los detalles.
    • Navegación - finalizar: navegación terminada por el usuario.
    • Navegación - error: AuthHost encuentra un error de navegación en una dirección URL e incluye HttpStatusCode.
    • Navegación - fin: se ha encontrado la dirección URL de terminación.

Uso de Fiddler con el agente de autenticación web

El depurador web Fiddler se puede usar con las aplicaciones de Windows 8.

  1. Como AuthHost se ejecuta en su propio contenedor de aplicación para darle la funcionalidad de red privada, debes establecer una clave del Registro: Windows Registry Editor Version 5.00

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\authhost.exe\EnablePrivateNetwork = 00000001

  2. Agrega una regla para AuthHost ya que está generando el tráfico saliente.

    CheckNetIsolation.exe LoopbackExempt -a -n=microsoft.windows.authhost.a.p_8wekyb3d8bbwe
    CheckNetIsolation.exe LoopbackExempt -a -n=microsoft.windows.authhost.sso.p_8wekyb3d8bbwe
    CheckNetIsolation.exe LoopbackExempt -a -n=microsoft.windows.authhost.sso.c_8wekyb3d8bbwe
    D:\Windows\System32>CheckNetIsolation.exe LoopbackExempt -s
    List Loopback Exempted AppContainers
    [1] -----------------------------------------------------------------
        Name: microsoft.windows.authhost.sso.c_8wekyb3d8bbwe
        SID:  S-1-15-2-1973105767-3975693666-32999980-3747492175-1074076486-3102532000-500629349
    [2] -----------------------------------------------------------------
        Name: microsoft.windows.authhost.sso.p_8wekyb3d8bbwe
        SID:  S-1-15-2-166260-4150837609-3669066492-3071230600-3743290616-3683681078-2492089544
    [3] -----------------------------------------------------------------
        Name: microsoft.windows.authhost.a.p_8wekyb3d8bbwe
        SID:  S-1-15-2-3506084497-1208594716-3384433646-2514033508-1838198150-1980605558-3480344935
    
  3. Agrega una regla de firewall para el tráfico entrante a Fiddler.

Para obtener más información, consulta el blog sobre cómo usar el depurador web Fiddler con las aplicaciones de la Tienda Windows.

Temas relacionados

Muestra de agente de autenticación web

Windows.Security.Authentication.Web

Conexión a proveedores de identidad en Internet