Manejo de los mensajes de error de Autodiscover

Artículo
03/29/2023

Obtenga información sobre los diferentes tipos de errores de detección automática y qué hacer con ellos.

La detección automática permite a las aplicaciones recuperar información de configuración automáticamente y funciona muy bien. Sin embargo, las cosas no siempre van según el plan. Echemos un vistazo a los errores comunes que pueden producirse y cómo puede controlarlos para minimizar la necesidad de pedir al usuario que configure manualmente el cliente.

Errores de estado HTTP

El primer tipo de error que puede encontrar al enviar solicitudes de detección automática es el estado HTTP. Si el estado HTTP de la respuesta es distinto de 200 (Aceptar), la carga de respuesta no contiene la respuesta de detección automática que estaba buscando. Por motivos de simplicidad, podemos agrupar códigos de estado que no sean 200 en tres categorías.

Tabla 1. Códigos de estado HTTP

Código de estado	Tipo de error	Para controlar...
301 o 302	Error de redireccionamiento	Vuelva a enviar la solicitud al URI contenido en el encabezado de respuesta HTTP "Ubicación". Para obtener más información, consulte Control de errores de redireccionamiento.
401	Error no autorizado	Dado que el proceso de detección automática implica probar varias direcciones URL potenciales, podría obtenerlo en una dirección URL solo para que la siguiente acepte sus credenciales. Por este motivo, no debe considerar un único error 401 para indicar que las credenciales no son válidas. Sin embargo, si recibe errores 401 de varias direcciones URL, es posible que desee pedir al usuario que vuelva a escribir su contraseña (si es posible).
Cualquier otro estado distinto de 200	Error de punto de conexión de detección automática no válido	Considere que la dirección URL que devuelve cualquier otro código de estado que no sea 200 no es válida y siga intentando la siguiente dirección URL de la lista.

Errores de detección automática

Incluso si obtiene un código de estado 200 (Correcto) después de enviar una solicitud de detección automática, eso no significa que el servidor haya enviado la información que necesita. El estado 200 solo significa que tiene una respuesta de detección automática y que la respuesta podría contener un error dentro de la carga. La ubicación de la información de error varía en función de si el formato es SOAP o POX.

Errores de detección automática de SOAP

Para la detección automática de SOAP, la respuesta puede contener uno o varios elementos ErrorCode (SOAP) en diferentes lugares. Normalmente, puede esperar uno como elemento secundario del elemento Response (SOAP) y otro como elemento secundario de cada elemento UserResponse (SOAP) de la respuesta. También puede encontrar uno como elemento secundario de un elemento UserSettingError (SOAP), si está presente. El contexto del error depende de dónde se encuentre el elemento ErrorCode , como se indica a continuación:

Como elemento secundario del elemento Response , el elemento ErrorCode representa un error que se aplica a toda la solicitud.
Como elemento secundario del elemento UserResponse , representa un error que se aplica solo a ese usuario específico.
Como elemento secundario de un elemento UserSettingError , representa un error que se aplica a una configuración específica que se solicitó.

Echemos un vistazo a un ejemplo de una respuesta. En este ejemplo, el elemento ErrorCode del elemento Response tiene un valor de "NoError", lo que indica que se ha realizado correctamente. Sin embargo, el elemento ErrorCode del elemento UserResponse tiene un valor de "RedirectAddress", que indica que se produjo un error para ese usuario determinado.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/" 
    xmlns:a="http://www.w3.org/2005/08/addressing">
  <s:Header>
    <a:Action s:mustUnderstand="1">https://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetUserSettingsResponse</a:Action>
    <h:ServerVersionInfo xmlns:h="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <h:MajorVersion>14</h:MajorVersion>
      <h:MinorVersion>3</h:MinorVersion>
      <h:MajorBuildNumber>136</h:MajorBuildNumber>
      <h:MinorBuildNumber>1</h:MinorBuildNumber>
      <h:Version>Exchange2010_SP2</h:Version>
    </h:ServerVersionInfo>
  </s:Header>
  <s:Body>
    <GetUserSettingsResponseMessage xmlns="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <ErrorCode>NoError</ErrorCode>
        <ErrorMessage />
        <UserResponses>
          <UserResponse>
            <ErrorCode>RedirectAddress</ErrorCode>
            <ErrorMessage>Redirection address.</ErrorMessage>
            <RedirectTarget>elvin@mail.contoso.com</RedirectTarget>
            <UserSettingErrors />
            <UserSettings />
          </UserResponse>
        </UserResponses>
      </Response>
    </GetUserSettingsResponseMessage>
  </s:Body>
</s:Envelope>

El artículo ErrorCode (SOAP) contiene una lista completa de posibles errores. La mayoría de ellos indican un error irrecuperable, pero algunos garantizan un control especial.

Tabla 2. Valores de ErrorCode de distribución automática de SOAP

Valor de ErrorCode	Para controlar...
RedirectAddress	Reiniciar la detección automática con una nueva dirección de correo electrónico con la dirección de correo electrónico en el elemento RedirectTarget (SOAP).
RedirectUrl	Volver a enviar la solicitud a una nueva dirección URL a la dirección URL del elemento RedirectTarget .
ServerBusy	Vuelva a intentar esta dirección URL después de un pequeño retraso. Puede esperar una cantidad de tiempo establecida o simplemente mover esta dirección URL al final de la lista de direcciones URL para intentarlo. Si recibe este error varias veces desde una dirección URL, debe considerar que la dirección URL no es válida.

Errores de detección automática de POX

El servicio de detección automática pox notifica errores de forma un poco diferente. Los errores no recuperables se encuentran en el elemento Error (POX). El artículo ErrorCode (POX) contiene una lista completa de posibles códigos de error.

Los errores de redireccionamiento se encuentran en el elemento Action (POX). Cualquier valor del elemento Action distinto de "settings" indica un error de redirección.

Tabla 3. Valores de Código de error de distribución automática de POX

Valor de acción	Para controlar...
redirectAddr	Reiniciar la detección automática con una nueva dirección de correo electrónico con la dirección de correo electrónico en el elemento RedirectAddr (POX).
redirectUrl	Volver a enviar la solicitud a una nueva dirección URL a la dirección URL en el elemento RedirectUrl (POX).

En este ejemplo, el elemento Action tiene un valor de "redirectAddr", que indica que se debe enviar una nueva solicitud con la nueva dirección de correo electrónico contenida en el elemento RedirectAddr .

<?xml version="1.0" encoding="utf-8"?>
<Autodiscover xmlns="https://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
  <Response xmlns="https://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
    <Account>
      <Action>redirectAddr</Action>
      <RedirectAddr>elvin@mail.contoso.com</RedirectAddr>
    </Account>
  </Response>
</Autodiscover>

Control de errores de redireccionamiento

Puede controlar los escenarios de error de redirección de dos maneras:

Reiniciando detección automática con una nueva dirección de correo electrónico.
Reenviando la solicitud a una nueva dirección URL.

Ambos escenarios requieren cierta validación antes de continuar.

Reinicio de la detección automática con una nueva dirección de correo electrónico

Cuando obtenga una nueva dirección de correo electrónico en una respuesta de redireccionamiento de detección automática, compruebe primero que la nueva dirección de correo electrónico que se proporcionó en la respuesta de error de redirección no es la misma dirección que envió en la solicitud que produjo el error. Si es así, no debe reiniciar detección automática y, en su lugar, considerar que la dirección URL que generó la respuesta no es válida.

Si la nueva dirección de correo electrónico es diferente, descarte la lista existente de posibles direcciones URL de punto de conexión de detección automática y genere una nueva lista basada en la nueva dirección de correo electrónico.

Volver a enviar la solicitud a una nueva dirección URL

Al obtener una nueva dirección URL en una respuesta de redireccionamiento de detección automática, primero debe validar la dirección URL de la siguiente manera:

Compruebe que la dirección URL es una dirección URL HTTPS.
Compruebe que no ha recibido un error de esta dirección URL con la dirección de correo electrónico actual antes.
Si es aplicable a la aplicación, informe al usuario del redireccionamiento y obtenga su permiso para seguir la redirección.
Envíe una solicitud a la dirección URL y compruebe que el certificado SSL presentado por el servidor es válido.

Si la dirección URL pasa la validación, vuelva a enviar la solicitud a esta nueva dirección URL.