Povolení protokolování v aplikacích

K povolení protokolování MSAL JS pro vaše aplikace jsou potřeba tyto kroky:

1. V objektu MSAL Configuration můžete povolit protokolování ke shromažďování protokolů msal js. Umožňujeme různé úrovně protokolování a podle potřeby lze zvolit odpovídající úroveň.

2. Možnosti protokolovacího nástroje je možné nastavit níže, příklad zvolí 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);      

Tady najdete příklad použití v ukázce.

3. Ujistěte se, že máte v konzoli prohlížeče povolenou odpovídající úroveň protokolování, aby se tyto záznamy zobrazily; například může být nutné povolit úroveň „Verbose“.

   

Přepsat nastavení úrovně protokolování a PII

Toto jsou kroky, jak přepsat úroveň protokolování MSAL a nastavení PII při řešení chyb v nevývojových prostředích:

Přejděte do úložiště relací.

1. Otevření vývojářských nástrojů prohlížeče
   • Prohlížeče Edge, Chrome a Firefox: stiskněte F12
   • Safari: přejděte do předvoleb Safari (Safari Menu>Preferences), vyberte Advanced Tab a povolte .Show features for web developers Jakmile je tato nabídka povolená, zobrazí se konzola pro vývojáře kliknutím na Develop>Show Javascript Console
2. Přejděte na Session Storage:
   • Edge
   • Chrome
   • Firefox
   • Safari: přejít na kartu Storage a rozbalit Session Storage
3. Výběr cílové domény

Přepsat úroveň protokolování

Přidejte msal.browser.log.level klíč do Session Storage, nastavte jeho hodnotu na požadovanou úroveň protokolu (Verbosenapříklad), aktualizujte stránku a zkuste operaci přihlášení zopakovat.

Přepsat nastavení protokolování PII

Přidejte msal.browser.log.pii klíč do Session Storagesouboru , nastavte jeho hodnotu na true nebo falseaktualizujte stránku a zkuste operaci přihlášení zopakovat.

Načtení zachycených protokolů

1. Přejděte na kartu konzoly:
   • Edge
   • Chrome
   • Firefox
   • Safari: Otevřete konzolu JavaScriptu a přejděte na Console
2. Projděte si protokoly a ujistěte se, že před jejich sdílením neobsahují citlivá data.