Activer la journalisation dans vos applications

Voici les étapes nécessaires pour activer la journalisation MSAL JS pour vos applications :

  1. Dans l’objet MSAL Configuration , vous pouvez activer la journalisation pour collecter les journaux msal js. Nous allons activer différents niveaux de journalisation et un niveau approprié peut être choisi en fonction des besoins.

  2. Les options d’enregistreur d’événements peuvent être définies comme ci-dessous, l’exemple choisit LogLevel.Trace


import { PublicClientApplication, LogLevel } from "@azure/msal-browser";

const msalConfig = {
    auth: {
        ...
    },
    cache: {
        ...
    },
    system: {
        loggerOptions: {
            logLevel: LogLevel.Trace,
            loggerCallback: (level, message, containsPii) => {
                if (containsPii) {	
                    return;	
                }
                switch (level) {	
                    case LogLevel.Error:	
                        console.error(message);	
                        return;	
                    case LogLevel.Info:	
                        console.info(message);	
                        return;	
                    case LogLevel.Verbose:	
                        console.debug(message);	
                        return;	
                    case LogLevel.Warning:	
                        console.warn(message);	
                        return;	
                    default:
                        console.log(message);
                        return;
                }    
            }
        }
    },

    ...
}

const msalInstance = new PublicClientApplication(msalConfig);

Un exemple d’utilisation dans un exemple est accessible ici.

  1. Assurez-vous que le niveau de journalisation approprié est activé dans la console de votre navigateur pour voir ces logs ; par exemple, le niveau « verbose » doit parfois être activé pour que le navigateur les affiche.

    console de navigateur

Redéfinir le niveau de journalisation et le paramètre des données personnelles identifiables

Voici les étapes à suivre pour remplacer le niveau de journal MSAL et les paramètres d’identification personnelle pour résoudre les erreurs dans les environnements non-dev :

  1. Ouvrir les outils de développement du navigateur
    • Navigateurs Edge, Chrome et Firefox : appuyez sur F12
    • Safari : accédez aux préférences de Safari (Safari Menu>Preferences), sélectionnez l’option Advanced Tab et activez Show features for web developers. Une fois ce menu activé, vous trouverez la console du développeur en cliquant sur Develop>Show Javascript Console
  2. Accédez à Session Storage:
    • Edge
    • Chrome
    • Firefox
    • Safari : accédez à l’onglet Storage et développez Session Storage
  3. Sélectionner le domaine cible

Substituer le niveau de journalisation

Ajoutez une clé msal.browser.log.level à Session Storage, définissez sa valeur sur le niveau de journalisation souhaité (Verbose, par exemple), rechargez la page et réessayez l’opération de connexion.

Redéfinir le paramètre de journalisation des informations personnelles identifiables

Ajoutez la clé msal.browser.log.pii à Session Storage, définissez sa valeur sur true ou false, actualisez la page et réessayez de vous connecter.

Récupérer les journaux capturés

  1. Accédez à l’onglet console :
  2. Passez en revue les journaux pour vous assurer qu’ils ne contiennent pas de données sensibles avant de les partager
  • Last updated on