Bagikan melalui

Masuk ke MSAL untuk Android

  • Artikel

Aplikasi Microsoft Authentication Library (MSAL) membuat pesan log yang dapat membantu mendiagnosis masalah. Aplikasi yang dapat mengonfigurasi pengelogan dengan beberapa baris kode, dan memiliki kontrol kustom atas tingkat detail dan apakah data pribadi dan organisasi dicatat atau tidak. Sebaiknya Anda membuat implementasi pengelogan MSAL dan menyediakan cara bagi pengguna untuk mengirimkan log saat mereka memiliki masalah autentikasi.

Tingkat Pengelogan

MSAL menyediakan beberapa tingkat detail pengelogan:

  • LogAlways: Tidak ada pemfilteran tingkat yang dilakukan pada tingkat log ini. Pesan log dari semua tingkatan akan dicatat.
  • Kritis: Log yang menjelaskan aplikasi atau crash sistem yang tidak dapat dipulihkan, atau kegagalan bencana yang membutuhkan perhatian segera.
  • Kesalahan: Menunjukkan ada sesuatu yang salah dan kesalahan dibuat. Digunakan untuk penelusuran kesalahan dan mengidentifikasi masalah.
  • Peringatan: Belum tentu ada kesalahan atau kegagalan, tetapi ditujukan untuk diagnostik dan menentukan masalah.
  • Informasi: MSAL akan mencatat peristiwa yang ditujukan untuk tujuan informasi yang belum tentu ditujukan untuk penelusuran kesalahan.
  • Verbose (Default): MSAL mencatat detail lengkap perilaku pustaka.

Catatan

Tidak semua tingkat log tersedia untuk semua MSAL SDK

Data pribadi dan organisasi

Secara default, pencatat MSAL tidak menangkap data pribadi atau organisasi yang sangat sensitif. Pustaka menyediakan opsi untuk mengaktifkan pengelogan data pribadi dan organisasi jika Anda memutuskan untuk melakukannya.

Bagian berikut ini menyediakan detail selengkapnya tentang pengelogan kesalahan MSAL untuk aplikasi Anda.

Pengelogan di MSAL untuk Android menggunakan Java

Aktifkan pengelogan di pembuatan aplikasi dengan membuat panggilan balik pengelogan. Panggilan balik mengambil parameter ini:

  • tag adalah untai yang diluluskan ke panggilan balik oleh pustaka. Ini terkait dengan entri log dan dapat digunakan untuk mengurutkan pesan pengelogan.
  • logLevel memungkinkan Anda menentukan tingkat pengelogan yang Anda inginkan. Tingkat log yang didukung adalah: Error, Warning, Info, dan Verbose.
  • message adalah isi entri log.
  • containsPII menentukan apakah pesan berisi data pribadi, atau data organisasi dicatat. Secara default, ini diatur ke false, sehingga aplikasi Anda tidak mencatat data pribadi. Jika containsPII adalah true, metode ini akan menerima pesan dua kali: sekali dengan parameter containsPII diatur ke false dan message tanpa data pribadi, dan kedua kali dengan parameter containsPii diatur ke true dan pesan mungkin berisi data pribadi. Dalam beberapa kasus (ketika pesan tidak berisi data pribadi), pesan akan sama.
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');
   }
});

Secara default, pencatat MSAL tidak akan mengambil informasi identitas pribadi atau informasi identitas organisasi. Untuk mengaktifkan pengelogan informasi identitas pribadi atau informasi identitas organisasi:

Logger.getInstance().setEnablePII(true);

Untuk menonaktifkan pengelogan data pribadi dan data organisasi:

Logger.getInstance().setEnablePII(false);

Secara default pengelogan ke logcat dinonaktifkan. Untuk mengaktifkan:

Logger.getInstance().setEnableLogcatLog(true);

Langkah berikutnya

Untuk sampel kode lainnya, lihat sampel kode platform identitas Microsoft.