Android için MSAL’de oturum açma
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
,Info
veVerbose
.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. isecontainsPII
true
, bu yöntem iletileri iki kez alır: bir kezcontainsPII
parametre olarak ayarlanırfalse
vemessage
kişisel veriler olmadan, ikinci kezcontainsPii
parametresi olarak ayarlanırtrue
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çü 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.