Android için MSAL’de oturum açma

  • Makale

Microsoft Kimlik Doğrulama Kitaplığı (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 birkaç günlük ayrıntı düzeyi sağlar:

  • LogAlways: Bu günlük düzeyinde düzey filtrelemesi yapılmaz. Tüm düzeylerdeki günlük iletileri günlüğe kaydedilir.
  • 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ı: Hata veya hata olması şart değildir, ancak tanılama ve sorunları belirleme amacıyla 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.

Not

Tüm MSAL SDK'ları için tüm günlük düzeyleri kullanılamaz

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ük geri çağırması oluşturarak uygulama oluşturma sırasında günlüğü açın. Geri çağırma şu parametreleri alır:

  • tag , kitaplığı tarafından geri çağırmaya 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ük düzeyini istediğinize karar vermenizi sağlar. Desteklenen günlük düzeyleri şunlardır: Error, Warning, Infove Verbose.
  • message , günlük girdisinin 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. ise containsPIItrue, bu yöntem iletileri iki kez alır: bir kez containsPII parametre olarak ayarlanır false ve message kişisel veriler olmadan, ikinci kez containsPii parametresi olarak ayarlanır true ve ileti 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 bilgilerin veya kuruluş tarafından tanımlanabilir 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ük kaydı devre dışıdı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.