MongoDB “MongoServerError: bad auth: Authentication failed” hatası, sunucunun bağlantı isteğinde verilen kullanıcı adı ve parolayı kabul etmediğini gösterir. Sorun genellikle bağlantı metnindeki kimlik bilgilerinin yanlış olması, kullanıcının farklı bir kimlik doğrulama veritabanında bulunması veya parolanın URI içinde hatalı yorumlanmasıyla ilgilidir.
Bağlantı metni, MongoDB sunucusunun adresiyle birlikte kullanıcı adı, parola ve authSource gibi seçenekleri taşır. Bu bilgileri kaynak koduna doğrudan yazmak yerine ortam değişkeninden okumak, parolanın kod içinde görünmesini ve yanlışlıkla paylaşılmasını azaltır.
Hata kimlik doğrulama aşamasında mı oluşur?
Bu hata, sunucunun verilen kullanıcı adı ve parolayı kabul etmediği kimlik doğrulama aşamasında oluşur. Uygulama önce MongoDB sunucusuna ulaşmaya, ardından bağlantı sırasında gönderilen kimlik bilgilerini doğrulatmaya çalışır. MongoDB dokümanlarında SCRAM kimlik doğrulama sorunları için MongoServerError: bad auth : authentication failed biçiminde bir hata örneği verilir.
Bu nedenle hata, DNS çözümleme problemi, sunucuya erişimin reddedilmesi, bağlantı zaman aşımı veya TLS el sıkışması sorunu ile aynı anlama gelmez. Örneğin alan adı çözümlenemediğinde DNS temelli bir hata, uygun sunucu zamanında seçilemediğinde ServerSelectionTimeoutError, TLS görüşmesi başarısız olduğunda ise SSL veya TLS içeren bir hata görebilirsin. Kimlik bilgileri sunucuya ulaştıktan sonra reddediliyorsa hata metninde bad auth ya da Authentication failed ifadesi bulunabilir.
PyMongo kullanan bir uygulamada kimlik doğrulama hatası, sürücü tarafından çoğunlukla pymongo.errors.OperationFailure istisnası olarak gösterilir. Hata metni OperationFailure: Authentication failed biçiminde görünebilir; tam gösterim sunucu yanıtına, sürücüye ve çalışma ortamına göre değişebilir. Bu yüzden teşhis sırasında yalnızca istisna sınıfına değil, istisnanın içindeki mesaja da bakmak gerekir.
from pymongo import MongoClient
# Kullanıcı adı, parola ve küme adresi yalnızca örnektir.
uri = (
"mongodb+srv://ornek_kullanici:yanlis_parola"
"@ornek-kume.mongodb.net/?authSource=admin"
)
client = MongoClient(uri, serverSelectionTimeoutMS=5000)
try:
client.admin.command("ping")
print("Bağlantı başarılı")
except Exception as error:
print(type(error).__name__, error)
finally:
client.close()
Bu örnekte ping çağrısı, istemcinin sunucuya ulaşıp ulaşamadığını ve işlem yapmadan önce kimlik doğrulamanın tamamlanıp tamamlanmadığını görmeye yardımcı olur. Gerçek bir küme adresi ve geçerli bilgiler kullanılmasına rağmen bad auth görülüyorsa kullanıcı adı, parola ve authSource birlikte incelenmelidir. Sunucuya hiç ulaşılamıyorsa aynı kod, ağ veya sunucu seçimiyle ilgili farklı bir PyMongo istisnası üretebilir. PyMongo bağlantıyı çoğu durumda ilk veritabanı işlemi sırasında kurduğu için yalnızca MongoClient nesnesini oluşturmak, kimlik bilgilerinin doğrulandığını göstermeyebilir.
Panel hesabı ile veritabanı kullanıcısı neden ayrıdır?

Bulut yönetim paneline girişte kullandığın hesap, MongoDB sunucusuna bağlanan uygulamanın veritabanı kullanıcısı değildir. MongoDB Atlas belgelerinde Atlas kullanıcılarının yönetim uygulamasına, veritabanı kullanıcılarının ise Atlas üzerinde barındırılan veritabanlarına eriştiği açıkça ayrılır.
Örneğin yonetici.ornek panelde projeyi yönetmek için kullanılan örnek bir Atlas hesabı, uygulama_ornek ise uygulamanın MongoDB bağlantısında kullanacağı örnek bir veritabanı kullanıcısı olabilir. Uygulamanın bağlantı metninde panel hesabının e-posta adresi veya panel parolası yerine, veritabanına erişim için oluşturulmuş kullanıcıya ait bilgiler yer almalıdır.
Veritabanı kullanıcılarının erişimi roller ve yetkilerle belirlenir. Bu yetkiler veritabanı, koleksiyon veya başka kaynaklar düzeyinde sınırlandırılabilir. Böylece panelde yönetim yetkisi bulunan bir hesabın parolasını uygulamaya koymadan, uygulamaya yalnızca ihtiyaç duyduğu veritabanı erişimini veren ayrı bir kimlik tanımlanabilir.
authSource değeri nasıl doğru seçilir?

authSource, MongoDB'nin kullanıcı adı ve parolayı hangi kimlik doğrulama veritabanındaki kullanıcı tanımına göre kontrol edeceğini belirler. Uygulamanın işlem yapacağı veritabanı ile kullanıcının tanımlı olduğu kimlik doğrulama veritabanının aynı olması gerekmez. MongoDB'de kullanıcı hangi veritabanında oluşturulduysa, o veritabanı kullanıcının kimlik doğrulama veritabanıdır.
Örneğin kullanıcı admin veritabanında oluşturulduysa bağlantı metninde authSource=admin kullanılır. Kullanıcı raporlar veritabanında oluşturulduysa değer authSource=raporlar olmalıdır. Uygulamanın bağlanacağı hedef veritabanı ise bağlantı metninin yol bölümünde yer alabilir:
mongodb+srv://kullanici:[email protected]/uygulama?authSource=admin
Bu bağlantı metnini parçalara ayırarak okumak, bad auth hatasının nedenini bulmayı kolaylaştırır:
kullanici:parola, kimlik bilgilerini belirtir.ornek-kume.mongodb.net, bağlanılacak küme adresidir.uygulama, bağlantıdan sonra kullanılacak hedef veritabanıdır.authSource=admin, kullanıcınınadminveritabanındaki tanımıyla doğrulanacağını belirtir.
authSource yazılmadığında bağlantı dizesindeki varsayılan veritabanı dikkate alınabilir, bu bilgi de yoksa MongoDB kimlik doğrulama için admin veritabanını kullanabilir. Hedef veritabanı ile kimlik doğrulama veritabanı farklıysa authSource değerini açıkça yazmak, yanlış veritabanında kullanıcı aranmasını önlemeye yardımcı olur. Ayrıntılar için MongoDB bağlantı dizesi seçenekleri dokümantasyonuna bakabilirsin.
Özel karakterli parola Python bağlantısında nasıl yazılır?
Parolada @, : veya / gibi karakterler varsa bunlar bağlantı dizesindeki kullanıcı adı, parola ve küme adresi ayraçlarıyla karışabilir. Bu nedenle kimlik bilgilerini URI içinde kullanırken yüzde kodlaması uygulanmalıdır. Aşağıdaki bağlantı metni bu açıdan hatalıdır:
mongodb+srv://ornek_kullanici:Ornek@Parola:123/@cluster0.example.mongodb.net/uygulama?authSource=admin
Burada paroladaki @, : ve / karakterleri URI'nin yapısını bozabilir. Düzeltilmiş örnekte parola doğrudan kaynak koda yazılmıyor, ortam değişkeninden okunuyor ve URI'ye eklenmeden önce urllib.parse.quote_plus ile kodlanıyor. MongoDB, URI içinde kullanıcı adı ve parola kullanıldığında bu karakterlerin yüzde kodlamasıyla yazılmasını önerir.
import os
from urllib.parse import quote_plus
import pymongo
username = os.environ["MONGODB_USERNAME"]
password = os.environ["MONGODB_PASSWORD"]
host = os.environ["MONGODB_HOST"]
database = os.environ["MONGODB_DATABASE"]
auth_source = os.environ["MONGODB_AUTH_SOURCE"]
uri = (
f"mongodb+srv://{quote_plus(username)}:{quote_plus(password)}"
f"@{host}/{database}?authSource={quote_plus(auth_source)}"
)
client = pymongo.MongoClient(uri)
client.admin.command("ping")
print("MongoDB bağlantısı başarılı.")
client.close()
Bu örnekte MONGODB_HOST için gerçek küme adresi, diğer ortam değişkenleri için de ilgili bağlantı bilgileri çalışma ortamında tanımlanır. Kod başarılı bir ping işleminden sonra MongoDB bağlantısı başarılı. çıktısını üretir. Bağlantı başarısız olduğunda oluşan PyMongo hata metni, kullanılan sürücü sürümüne, küme adresine ve bağlantı koşullarına göre değişebileceği için sabit bir çıktı olarak kabul edilmemelidir. PyMongo'da MongoClient oluşturmak ve admin.command("ping") göndermek bağlantıyı sınamak için kullanılan yöntemlerdendir.
Parolayı açık metin olarak kaynak koda, ekran görüntüsüne veya mesajlaşma uygulamasına koyma. Ortam değişkenlerini ve bağlantı metnini GitHub gibi uzak kod depolarına yüklemek de kimlik bilgilerinin açığa çıkmasına neden olabilir. quote_plus URI içindeki karakterleri kodlar, ancak parolanın güvenli saklanması ve paylaşılmaması sorumluluğunu ortadan kaldırmaz.
Bağlantı hatasını güvenli biçimde nasıl teşhis edersin?
Bu hatayı güvenli biçimde teşhis etmek için önce kullanıcı adı, veritabanı kullanıcısının bulunduğu kimlik doğrulama veritabanı ve URI kodlamasını kontrol etmelisin. Ardından küme adresinin ve ağ erişiminin çalıştığını ayrı test edip küçük bir ping denemesi yapabilirsin. Kimlik bilgileri sunucuya ulaştıktan sonra reddedildiğinde OperationFailure, sunucuya erişilemediğinde ise ServerSelectionTimeoutError gibi farklı hata türleri görülebilir.
URI ve ağ kontrollerini birbirinden ayır
Aşağıdaki ilk bağlantı metni hatalı bir örnektir. @ karakteri parola içinde bulunduğu için URI'nin kullanıcı bilgisi bölümünü bozabilir. İkinci örnekte parola ortam değişkeninden okunur ve özel karakterler quote_plus ile kodlanır.
# Hatalı örnek
uri = "mongodb+srv://ornek_kullanici:Kedi@[email protected]/uygulama?authSource=admin"
# Düzeltilmiş örnek
import os
from urllib.parse import quote_plus
from pymongo import MongoClient
username = quote_plus(os.environ["MONGO_USERNAME"])
password = quote_plus(os.environ["MONGO_PASSWORD"])
cluster = os.environ["MONGO_CLUSTER"]
uri = (
f"mongodb+srv://{username}:{password}"
f"@{cluster}/uygulama?authSource=admin"
)
client = MongoClient(uri, serverSelectionTimeoutMS=5000)
client.admin.command("ping")
print("MongoDB bağlantısı başarılı.")
Bu kodda MONGO_USERNAME, MONGO_PASSWORD ve MONGO_CLUSTER değerleri çalışma ortamında tanımlanır. Gerçek parolayı kaynak koda veya bağlantı metnine sabit olarak yazma. Bağlantı metnini loglara basmak da aynı riski oluşturur. Hata kaydı tutuluyorsa kullanıcı adı, parola ve tam URI yerine maskelenmiş bilgiler kullanılmalıdır.
Teşhis sırasında şu kontrol listesini sırayla uygulayabilirsin:
- Kullanıcı adının, panel hesabına değil veritabanı kullanıcısına ait olduğunu doğrula.
- Kullanıcının tanımlı olduğu kimlik doğrulama veritabanını ve
authSourcedeğerini karşılaştır. - Paroladaki özel karakterlerin URI içinde kodlandığını kontrol et.
- Küme adresinin çözümlendiğini ve uygulamanın bulunduğu ağdan erişilebilir olduğunu ayrı test et.
- Kimlik bilgilerini ortam değişkenlerinden oku ve değerlerin boş kalmadığını kontrol et.
- Loglarda parola, tam bağlantı metni veya ortam değişkeni değerlerinin görünmediğinden emin ol.
Bir parola daha önce GitHub gibi uzak bir kod deposuna gönderildiyse yalnızca dosyayı silmek yeterli olmayabilir. Eski parolayı geçersizleştirip yeni bir parola oluşturmayı, uygulamadaki ortam değişkenlerini güncellemeyi ve gerekirse depo geçmişindeki hassas veriyi temizlemeyi değerlendirmelisin. Hata metninin kesin biçimi sürücüye, sunucuya ve ağ koşullarına göre değişebileceği için teşhisi gerçek bağlantı denemesi ve küçük bir ping testiyle tamamlamak daha güvenlidir.
Sık Sorulan Sorular
authSource ile bağlantı metnindeki veritabanı adı aynı olmak zorunda mı?
Hayır, aynı olmak zorunda değildir. URI içindeki veritabanı adı uygulamanın çalışacağı varsayılan veritabanını, authSource ise kullanıcı bilgilerinin doğrulanacağı veritabanını belirtir.
Panel giriş parolası neden MongoDB bağlantısında çalışmaz?
Panel giriş parolası yönetim hesabına, veritabanı parolası ise MongoDB içinde tanımlanmış kullanıcıya aittir. Bu iki hesap farklı kimlik doğrulama sistemlerinde kullanıldığı için panel parolası bağlantı metninde geçerli olmayabilir.
MongoDB parolasındaki özel karakterler neden quote_plus ile kodlanır?
Özel karakterler bağlantı metninde ayraç olarak yorumlanabilir. quote_plus, paroladaki bu karakterleri URI içinde taşınabilecek biçime dönüştürerek kullanıcı adı, parola ve sunucu adresinin doğru ayrıştırılmasına yardımcı olur.
Parola GitHub gibi bir uzak kod deposuna yüklendiyse ne yapılmalıdır?
Önce açığa çıkan parolayı değiştirmeli veya geçersizleştirmelisin. Ardından yeni parolayı güvenli ortam değişkenlerine taşımalı, erişim kayıtlarını incelemeli ve gerekiyorsa eski parolanın depo geçmişindeki kopyalarını temizlemelisin.
Kimlik bilgilerini, URI yapısını ve ağ erişimini ayrı ayrı kontrol etmek, “Authentication failed” hatasının kaynağını daha güvenli ve anlaşılır biçimde daraltır.