Aktivieren der Protokollierung in Ihren Anwendungen

Dies sind Schritte zum Aktivieren der MSAL JS-Protokollierung für Ihre Anwendungen:

  1. Im MSAL-Konfigurationsobjekt können Sie die Protokollierung aktivieren, um msal js-Protokolle zu sammeln. Wir unterstützen unterschiedliche Protokollierungsebenen, und bei Bedarf kann eine geeignete Ebene ausgewählt werden.

  2. Die Loggeroptionen können wie unten festgelegt werden, das Beispiel wählt 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);

Auf eine Beispielverwendung in einem Beispiel kann hier zugegriffen werden.

  1. Stellen Sie sicher, dass in Ihrer Browserkonsole die geeignete Protokollstufe aktiviert ist, damit diese Protokolleinträge angezeigt werden. Beispielsweise muss dafür gegebenenfalls „Verbose“ aktiviert sein.

    Browserkonsole

Überschreiben der Protokollierungsstufe und der PII-Einstellung

Dies sind die Schritte zum Überschreiben der MSAL-Protokollebene und der PII-Einstellungen zur Problembehandlung von Fehlern in Nicht-Entwicklungsumgebungen:

  1. Öffnen von Browserentwicklertools
    • Edge-, Chrome- und Firefox-Browser: Drücken Sie F12
    • Safari: Öffnen Sie die Safari-Einstellungen (Safari Menu>Preferences), wählen Sie Advanced Tab aus und aktivieren Sie Show features for web developers. Sobald dieses Menü aktiviert ist, finden Sie die Entwicklerkonsole, indem Sie auf Develop>Show Javascript Console
  2. Navigieren Sie zu Session Storage:
    • Edge
    • Chrome
    • Firefox
    • Safari: Navigieren Sie zur Storage Registerkarte, und erweitern Sie Session Storage
  3. Zieldomäne auswählen

Protokollierungsstufe überschreiben

Fügen Sie den Schlüssel msal.browser.log.level zu Session Storage hinzu, setzen Sie seinen Wert auf die gewünschte Protokollebene fest (Verbose beispielsweise), aktualisieren Sie die Seite, und wiederholen Sie den Anmeldevorgang.

PII-Protokollierungseinstellung überschreiben

Fügen Sie msal.browser.log.pii schlüssel zu Session Storage, legen Sie den Wert auf true oder false, aktualisieren Sie die Seite, und wiederholen Sie den Anmeldevorgang.

Abrufen erfasster Protokolle

  1. Navigieren Sie zur Registerkarte „Konsole“:
    • Edge
    • Chrome
    • Firefox
    • Safari: Öffnen Sie die JavaScript-Konsole, und navigieren Sie zu Console
  2. Überprüfen Sie die Protokolle, um sicherzustellen, dass sie keine vertraulichen Daten enthalten, bevor Sie sie freigeben.
  • Zuletzt aktualisiert um