Inicio de sesión en MSAL para Android

  • Artículo

Las aplicaciones de la biblioteca de autenticación de Microsoft (MSAL) generan mensajes de registro que pueden ayudar a diagnosticar problemas. Una aplicación puede configurar el registro con unas cuentas líneas de código y tener un control personalizado sobre el nivel de detalle y si se registran o no datos de la organización y personales. Se recomienda crear una implementación de registros de MSAL y proporcionar una forma de que los usuarios envíen registros cuando tengan problemas de autenticación.

Niveles de registro

MSAL ofrece varios niveles de detalle de registro:

  • LogAlways: no se realiza ningún filtrado de nivel en este nivel de registro. Se registrarán los mensajes de registro de todos los niveles.
  • Crítico: registros que describen una aplicación no recuperable o un bloqueo del sistema, o bien un error catastrófico que requiere atención inmediata.
  • Error: indica que algo no ha funcionado bien y se ha generado un error. Se usa para la depuración y la identificación de problemas.
  • Advertencia: No se ha producido necesariamente un error, pero es necesario realizar un diagnóstico e identificar los problemas.
  • Informativo: MSAL registrará los eventos de carácter informativo, no relacionados necesariamente con la depuración.
  • Detallado (predeterminado): MSAL registra todos los detalles del comportamiento de la biblioteca.

Nota

No todos los niveles de registro están disponibles para todos los SDK de MSAL

Datos personales y organizativos

De forma predeterminada, el registrador de MSAL no captura datos personales u organizativos sumamente confidenciales. La biblioteca ofrece la opción de habilitar el registro de datos personales y organizativos si decide hacerlo.

En las secciones siguientes se proporcionan más detalles sobre el registro de errores de MSAL para la aplicación.

Registro en MSAL para Android con Java

Active el registro al crear la aplicación mediante la creación de una devolución de llamada de inicio de sesión. La devolución de llamada toma estos parámetros:

  • tag es una cadena que la biblioteca pasa a la devolución de llamada. Se asocia a la entrada de registro y se puede usar para ordenar los mensajes de registro.
  • logLevel le permite decidir el nivel de registro deseado. Los niveles de registro admitidos son: Error, Warning, Info y Verbose.
  • message es el contenido de la entrada de registro.
  • containsPII especifica si se registran los mensajes que contienen datos personales o datos de la organización. De forma predeterminada, se establece en false para que la aplicación no registre datos personales. Si containsPII es true, este método recibirá los mensajes dos veces: una con el parámetro containsPII igual a false y el message sin datos personales y una segunda con el parámetro containsPii igual a true y el mensaje podría contener datos personales. En algunos casos (cuando el mensaje no contiene datos personales), el mensaje será el mismo.
private StringBuilder mLogs;

mLogs = new StringBuilder();
Logger.getInstance().setExternalLogger(new ILoggerCallback()
{
   @Override
   public void log(String tag, Logger.LogLevel logLevel, String message, boolean containsPII)
   {
      mLogs.append(message).append('\n');
   }
});

De forma predeterminada, el registrador de MSAL no capturará ninguna información de identificación personal ni información de identificación de la organización. Para habilitar el registro de información de identificación personal o de información de identificación de la organización:

Logger.getInstance().setEnablePII(true);

Para deshabilitar el registro de datos personales y de datos de la organización:

Logger.getInstance().setEnablePII(false);

De forma predeterminada, el registro se deshabilita en logcat. Para habilitar las siguientes opciones:

Logger.getInstance().setEnableLogcatLog(true);

Pasos siguientes

Para ver más ejemplos de código, consulte Ejemplos de código de la Plataforma de identidad de Microsoft.