Android için MSAL’de oturum açma

Microsoft Authentication Library (MSAL) uygulamaları sorunları tanılamaya yardımcı olabilecek günlük iletileri oluşturur. Bir uygulama birkaç kod satırıyla günlüğe kaydetmeyi yapılandırabilir ve ayrıntı düzeyi ile kişisel ve kuruluş verilerinin günlüğe kaydedilip kaydedilmediği üzerinde özel denetime sahip olabilir. Bir MSAL günlük uygulaması oluşturmanızı ve kullanıcıların kimlik doğrulaması sorunları olduğunda günlük göndermeleri için bir yol sağlamanızı öneririz.

Günlük düzeyleri

MSAL, çeşitli günlükleme ayrıntı düzeyleri sunar:

  • LogAlways: Bu günlükleme düzeyinde düzey tabanlı filtreleme yapılmaz. Tüm düzeylerdeki günlük mesajları kaydedilecektir.
  • Kritik: Kurtarılamayan bir uygulamayı veya sistem kilitlenmesini ya da acil dikkat gerektiren yıkıcı bir hatayı açıklayan günlükler.
  • Hata: Bir sorun oluştuğunu ve bir hata oluşturulduğunu gösterir. Hata ayıklama ve sorunları tanımlama için kullanılır.
  • Uyarı: Bu, mutlaka bir hata ya da başarısızlık olduğu anlamına gelmez; ancak tanılama yapmak ve sorunların kaynağını tam olarak belirlemek için tasarlanmıştır.
  • Bilgilendirilme: MSAL, hata ayıklamaya yönelik olması gerekmeyen bilgilendirme amaçlı olayları günlüğe kaydeder.
  • Ayrıntılı (Varsayılan): MSAL, kitaplık davranışının tüm ayrıntılarını günlüğe kaydeder.

Note

Tüm MSAL SDK’ları için tüm günlükleme düzeyleri mevcut değildir.

Kişisel ve kurumsal veriler

Varsayılan olarak, MSAL günlükçü son derece hassas kişisel veya kuruluş verilerini yakalamaz. Kitaplık, siz karar verirseniz kişisel ve kurumsal verilerin günlüğe kaydedilmesini etkinleştirme seçeneği sunar.

Aşağıdaki bölümlerde uygulamanız için MSAL hata günlüğü hakkında daha fazla ayrıntı sağlanır.

Java kullanarak Android için MSAL'de oturum açma

Bir günlükleme geri çağrısı oluşturarak uygulama oluştururken günlüklemeyi etkinleştirin. Geri çağırma şu parametreleri alır:

  • tag, kitaplık tarafından geri çağırım işlevine geçirilen bir dizedir. Günlük girişiyle ilişkilidir ve günlük iletilerini sıralamak için kullanılabilir.
  • logLevel, hangi günlüğe kaydetme düzeyini istediğinize karar vermenizi sağlar. Desteklenen günlük düzeyleri şunlardır: Error, Warning, Info ve Verbose.
  • message, günlük kaydının içeriğidir.
  • containsPII kişisel veri içeren iletilerin mi yoksa kuruluş verilerinin mi günlüğe kaydedildiğini belirtir. Varsayılan olarak, bu false olarak ayarlanır, böylece uygulamanız kişisel verileri günlüğe kaydetmez. Eğer containsPII, true ise, bu yöntem mesajları iki kez alır: bir kez, containsPII parametresi false olarak ayarlanmış şekilde ve kişisel veri içermeyen message ile; ikinci kez ise, containsPii parametresi true olarak ayarlanmış şekilde ve mesaj kişisel veriler içerebilir. Bazı durumlarda (ileti kişisel veriler içermediğinde), ileti aynı olur.
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');
   }
});

Varsayılan olarak, MSAL günlükçü herhangi bir kişisel bilgileri veya kuruluş tarafından tanımlanabilir bilgileri yakalamaz. Kişisel olarak tanımlanabilir bilgilerin veya kuruluşu tanımlayabilecek bilgilerin günlüğe kaydedilmesini etkinleştirmek için:

Logger.getInstance().setEnablePII(true);

Kişisel verilerin ve kuruluş verilerinin günlüğe kaydedilmesini devre dışı bırakmak için:

Logger.getInstance().setEnablePII(false);

Varsayılan olarak logcat’e günlüğe kaydetme devre dışı bırakılmıştır. Etkinleştirmek için:

Logger.getInstance().setEnableLogcatLog(true);

Sonraki Adımlar

Daha fazla kod örneği için bkz. Microsoft kimlik platformu kod örnekleri.

  • Last updated on