Inicio de sesión en MSAL para Android

Las aplicaciones de 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 algunas líneas de código y tener control personalizado sobre el nivel de detalle y si se registran o no datos personales y de la organización. Se recomienda crear una implementación de registro de MSAL y proporcionar una manera de que los usuarios envíen registros cuando tengan problemas de autenticación.

Niveles de registro

MSAL proporciona varios niveles de detalle de registro:

• LogAlways: no se realiza ningún filtrado de nivel en este nivel de registro. Los mensajes de registro de todos los niveles se registrarán.
• Crítico: registros que describen un bloqueo irrecuperable de la aplicación o del sistema, o un fallo catastrófico que requiere atención inmediata.
• Error: indica que algo ha ido mal y se generó un error. Se usa para depurar e identificar problemas.
• Advertencia: no necesariamente se ha producido un error o un fallo, pero sirve para fines de diagnóstico y para localizar problemas.
• Informativo: MSAL registrará los eventos de carácter informativo, no relacionados necesariamente con la depuración.
• Detallado (valor predeterminado): MSAL registra los detalles completos del comportamiento de la biblioteca.

Datos personales y organizativos

De forma predeterminada, el registrador de MSAL no captura ningún dato personal o organizativo altamente confidencial. La biblioteca proporciona 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.

Inicio de sesión 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 función de retorno acepta los siguientes parámetros:

• tag es una cadena que la biblioteca pasa a la función de devolución de llamada. Está asociado a la entrada de registro y se puede usar para ordenar los mensajes de registro.
• logLevel le permite decidir qué nivel de registro desea. Los niveles de registro admitidos son: Error, Warning, Infoy Verbose.
• message es el contenido de la entrada de registro.
• containsPII especifica si se registran los mensajes que contienen datos personales o los datos de la organización. De forma predeterminada, se establece en false, de modo que la aplicación no registre los datos personales. Si containsPII es true, este método recibirá los mensajes dos veces: una vez con el parámetro containsPII establecido en false y el message sin datos personales, y una segunda vez con el parámetro containsPii establecido en 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 organizativa. Para habilitar el registro de información de identificación personal o información de identificación organizativa:

Logger.getInstance().setEnablePII(true);

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

Logger.getInstance().setEnablePII(false);

De forma predeterminada, el registro en logcat está deshabilitado. Para habilitar:

Logger.getInstance().setEnableLogcatLog(true);

Pasos siguientes

Para obtener más ejemplos de código, consulte Plataforma de identidad de Microsoft ejemplos de código.