Aanmelden bij MSAL voor Python

De Microsoft Authentication Library-apps (MSAL) genereren logboekberichten waarmee problemen kunnen worden vastgesteld. Een app kan logboekregistratie met een paar regels code configureren en aangepaste controle hebben over het detailniveau en of persoonlijke en organisatorische gegevens al dan niet worden vastgelegd. U wordt aangeraden een IMPLEMENTATIE van MSAL-logboekregistratie te maken en gebruikers een manier te bieden om logboeken in te dienen wanneer ze verificatieproblemen ondervinden.

Logboekregistratie in MSAL Python is ontworpen voor het gebruik van de standaardmechanismen voor Python logboekregistratie, zodat al uw kennis van Python logboekregistratie van toepassing is op MSAL-Python.

• De logboekregistratie in een Python script is standaard uitgeschakeld. Als u logboekregistratie voor foutopsporing wilt inschakelen voor ALLE modules in uw hele Python script, gebruikt logging.basicConfig(level=logging.DEBUG)u .
• De meeste MSAL-Python-logboeken bevinden zich al op foutopsporingsniveau. Deze optie is standaard uitgeschakeld. Maar als u debuglogboekregistratie wilt inschakelen om de ANDERE modules in uw Python-script te debuggen en daarom MSAL wilt dempen, schakelt u eenvoudigweg de door MSAL Python gebruikte logger uit: logging.getLogger("msal").setLevel(logging.WARN).
• MSAL Python logt geen Persoonsgegevens (PII). Er is niet eens een schakelaar om PII-logboekregistratie in te schakelen in MSAL Python. App-ontwikkelaars kunnen nog steeds standaard Python logboekregistratie gebruiken om alle inhoud te registreren. Door dit te doen, neemt de app de verantwoordelijkheid voor het veilig verwerken van zeer gevoelige gegevens en het volgen van wettelijke vereisten.

Logboekregistratieniveaus

MSAL biedt verschillende niveaus van logboekregistratiedetails:

• LogAlways: Er wordt geen niveaufiltering uitgevoerd op dit logboekniveau. Logboekberichten van alle niveaus worden vastgelegd.
• Critical: Logboeken die een onherstelbare toepassing of systeemcrash beschrijven, of een onherstelbare fout waarvoor onmiddellijke aandacht is vereist.
• Error: Geeft aan dat er iets mis is gegaan en er een fout is gegenereerd. Wordt gebruikt voor foutopsporing en het identificeren van problemen.
• Warning: Er is niet noodzakelijkerwijs sprake van een fout of storing, maar ze zijn bedoeld voor diagnose en het opsporen van problemen.
• Informational: MSAL zal gebeurtenissen vastleggen die zijn bedoeld voor informatieve doeleinden, niet noodzakelijkerwijs bedoeld voor foutopsporing.
• Verbose (Standaard): MSAL registreert de volledige details van het gedrag van de bibliotheek.

Note

Niet alle logboekniveaus zijn beschikbaar voor alle MSAL-bibliotheken.

Persoonlijke en organisatorische gegevens

Standaard legt de MSAL-logboekregistratie geen zeer gevoelige persoonlijke of organisatorische gegevens vast. De bibliotheek biedt de optie om persoonlijke en organisatiegegevens in te schakelen als u dit wilt doen.

In de volgende secties vindt u meer informatie over MSAL-foutenlogboekregistratie voor uw toepassing.

MSAL voor Python logboekregistratie

Logboekregistratie in MSAL voor Python maakt gebruik van de logboekregistratiemodule in de Python standaardbibliotheek. U kunt MSAL-logboekregistratie als volgt configureren (en deze in actie bekijken in de username_password_sample):

Logboekregistratie voor foutopsporing inschakelen voor alle modules

De logboekregistratie in een Python script is standaard uitgeschakeld. Als u uitvoerige logging wilt inschakelen voor alle Python-modules in uw script, gebruikt u logging.basicConfig met een niveau van logging.DEBUG:

import logging

logging.basicConfig(level=logging.DEBUG)

Hiermee worden alle logberichten die aan de loggingmodule worden doorgegeven, afgedrukt op de standaarduitvoer.

MSAL-logboekregistratieniveau configureren

U kunt het logniveau van de logprovider van MSAL voor Python configureren met behulp van de methode logging.getLogger() met de loggernaam "msal":

import logging

logging.getLogger("msal").setLevel(logging.WARN)

MSAL-logboekregistratie configureren met Azure-app Insights

Python-logberichten worden doorgegeven aan een loghandler, wat standaard de StreamHandler is. Als u MSAL-logboeken naar Application Insights wilt verzenden met een Instrumentation Key, gebruikt u de AzureLogHandler die wordt geleverd door de opencensus-ext-azure-bibliotheek.

Als u het pakket wilt installeren, opencensus-ext-azure voegt u het opencensus-ext-azure pakket van PyPI toe aan uw afhankelijkheden of pip-installatie:

pip install opencensus-ext-azure

Wijzig vervolgens de standaard-handler van de "msal" logprovider in een exemplaar van AzureLogHandler met een instrumentatiesleutel die is ingesteld in de omgevingsvariabele APP_INSIGHTS_KEY:

import logging
import os

from opencensus.ext.azure.log_exporter import AzureLogHandler

APP_INSIGHTS_KEY = os.getenv('APP_INSIGHTS_KEY')

logging.getLogger("msal").addHandler(AzureLogHandler(connection_string='InstrumentationKey={0}'.format(APP_INSIGHTS_KEY)))

Persoonlijke en organisatorische gegevens in Python

MSAL voor Python logt geen persoonlijke gegevens of organisatiegegevens. Er is geen eigenschap om logboekregistratie van persoonlijke of organisatiegegevens in of uit te schakelen.

U kunt standaard Python logboekregistratie gebruiken om te registreren wat u wilt, maar u bent verantwoordelijk voor het veilig verwerken van gevoelige gegevens en het volgen van wettelijke vereisten.

Raadpleeg voor meer informatie over loggen in Python Python's Loggen: handleiding.