OAuth Yönlendirmesi localhost'a Gidiyor: Google/Microsoft Kimlik Bilgilerini Onarma

n8n bir Google veya Microsoft hesabı bağlarken redirect_uri_mismatch hatasını gösteriyorsa veya "Sign in" tıklandıktan sonra aniden http://localhost:5678/... adresine gidiyorsanız, bunun nedeni neredeyse her zaman n8n'in OAuth girişi için callback adresini gerçek genel (public) alan adınız yerine hâlâ localhost ve 5678 numaralı port varsayılan değerlerinden oluşturmasıdır. Google veya Microsoft, n8n sunucusu tarafından gönderilen bu redirect URI'yi Google Cloud Console'da veya Microsoft uygulama kaydında kayıtlı listeyle karşılaştırır ve ikisi tam olarak eşleşmediği anda girişi reddeder. Çözüm, N8N_HOST, N8N_PROTOCOL ve özellikle WEBHOOK_URL ya da N8N_EDITOR_BASE_URL ortam değişkenlerini genel alan adına doğru şekilde ayarlamak ve ardından n8n kimlik bilgisi formunda gösterilen redirect URI'yi değiştirmeden OAuth sağlayıcısına girmektir. Tarih: Temmuz 2026.

n8n redirect URI'yi neden localhost'tan oluşturuyor?

n8n varsayılan olarak editör ve webhook adreslerini üç değişkenden otomatik olarak hesaplar ve kendi yapılandırmanız olmadan, n8n'in dağıtım ortam değişkenleri hakkındaki dokümantasyonuna göre burada N8N_PROTOCOL için http, N8N_HOST için localhost ve N8N_PORT için 5678 varsayılan değerleri kullanılır. n8n'i yalnızca kendi bilgisayarınızda yerel olarak test ettiğiniz sürece bu bir sorun değildir, çünkü tarayıcı gerçekten localhost üzerinden erişir. Ancak n8n bir sunucuda, Docker içinde veya bir reverse proxy arkasında çalışır çalışmaz, Google veya Microsoft yine de aynı otomatik olarak hesaplanan localhost değerine erişir, çünkü n8n dışarıdan hangi alan adı altında gerçekten erişilebilir olduğunu bilmez.

N8N_HOST, WEBHOOK_URL ve N8N_EDITOR_BASE_URL nasıl doğru ayarlanır?

En güvenilir çözüm, WEBHOOK_URL'yi manuel olarak tam genel alan adına ayarlamaktır, çünkü bu değişken n8n'in reverse proxy arkasında webhook yapılandırması hakkındaki dokümantasyonuna göre otomatik olarak hesaplanan URL'nin tamamının yerini alır ve hem editörde gösterilir hem de dış hizmetlere kaydedilir.

• WEBHOOK_URL: n8n'in localhost yerine bu alan adını kullanması için, sonunda eğik çizgi bulunan tam genel adresi ayarlayın, örneğin https://n8n.alanadiniz.com/.
• N8N_HOST: n8n bu değeri N8N_PROTOCOL ve N8N_PORT ile birlikte otomatik URL hesaplaması için kullandığından, protokol olmadan yalnızca alan adını ayarlayın, örneğin n8n.alanadiniz.com.
• N8N_PROTOCOL: dokümantasyona göre varsayılan değer http olduğundan, sunucunuz SSL üzerinden erişilebilir olur olmaz https olarak ayarlayın.
• N8N_EDITOR_BASE_URL: kullanıcıların editöre eriştiği genel URL; dokümantasyona göre ayrıca n8n'den gönderilen e-postalar için ve SAML girişinde redirect URL olarak kullanılır.
• N8N_PROXY_HOPS: önünde bir reverse proxy varsa, n8n'in yönlendirme başlıklarını doğru şekilde değerlendirmesi için 1 olarak ayarlayın.

Bu değişkenler ayarlandıktan sonra n8n süreci veya konteyneri yeniden başlatılmalıdır, çünkü n8n ortam değişkenlerini yalnızca başlangıçta okur.

redirect_uri_mismatch hatası somut olarak nasıl çözülür?

Hata, n8n'in OAuth akışını başlatırken Google veya Microsoft'a, sağlayıcıda kayıtlı redirect URI ile eşleşmeyen bir redirect_uri parametresi göndermesinden kaynaklanır, bu nedenle her iki tarafı manuel olarak eşleştirmeniz gerekir. n8n'i yeniden başlattıktan sonra, ilgili kimlik bilgisini tekrar açın ve n8n'in /rest/oauth2-credential/callback yolu altında oluşturduğu güncel OAuth redirect URL'sinin gösterilmesini sağlayın. Bu adresi değiştirmeden Google OAuth istemcinizin veya Microsoft uygulama kaydınızın yetkili redirect URI'leri listesine kopyalayın ve orada kaydedin. Google bağlantıları için n8n'in Google Drive sorunları hakkındaki dokümantasyonu N8N_EDITOR_BASE_URL ve WEBHOOK_URL'nin tam nitelikli (fully qualified) alan adları kullanması gerektiğine, tam da bu redirect URI mismatch'i önlemek için açıkça işaret eder. Güncellenen token'ın alınması için ardından kimlik bilgisini n8n'de yeniden bağlayın.

n8n bir reverse proxy arkasında veya Docker içinde çalışırken ek olarak neye dikkat edilmeli?

n8n nginx, Traefik veya bir Cloudflare Tunnel arkasında konteynerize şekilde çalışıyorsa, yalnızca değişkenleri ayarlamak bazen yeterli olmaz, çünkü proxy'nin X-Forwarded-Proto ve X-Forwarded-Host gibi orijinal başlıkları n8n'e iletmesi gerekir, böylece hizmet, isteğin gerçekten https ve genel alan adı üzerinden geldiğini dahili olarak bilir. Bu nedenle proxy yapılandırmasına ek olarak N8N_PROXY_HOPS'un ayarlanıp ayarlanmadığını da kontrol edin, çünkü bu değer olmadan n8n proxy'nin yönlendirme başlıklarına güvenmez ve dahili olarak yeniden varsayılan değerlere döner. Birden fazla OAuth bağlantısıyla üretimde bir n8n örneği çalıştırmak isteyen ve her sunucu taşımasında redirect URI'leri yeniden yapılandırmak istemeyen kişiler, düzgün belgelenmiş bir kurulumdan fayda görür; NordFlux'un n8n kurulumundaki desteği de tam olarak bu noktalardan biridir, böylece Alman veri egemenliğine sahip otomasyonlar bir güncellemeden sonra da istikrarlı çalışmaya devam eder.

n8n'de OAuth yönlendirme sorunları hakkında sık sorulan sorular

Değişkenleri ayarladıktan sonra n8n'i yeniden başlatmam gerekir mi?

Evet, yeniden başlatma zorunludur, çünkü n8n ortam değişkenlerini yalnızca süreç veya konteyner başlatıldığında okur. Yeniden başlatma olmadan, WEBHOOK_URL veya N8N_HOST zaten doğru ayarlanmış olsa bile, localhost tabanlı eski redirect URI etkin kalır.

Yalnızca WEBHOOK_URL'yi ayarlamak yeterli mi?

Çoğu durumda evet, çünkü n8n dokümantasyonuna göre WEBHOOK_URL, otomatik olarak hesaplanan URL'nin tamamının yerini alır ve böylece OAuth callback adresini de düzeltir. Otomatik gönderilen e-postalardaki veya SAML yönlendirmelerindeki bağlantılar hâlâ yanlış gösteriliyorsa, ek olarak yalnızca N8N_EDITOR_BASE_URL'ye ihtiyacınız vardır.

redirect_uri_mismatch bazen n8n Cloud'da da neden ortaya çıkıyor?

Kimlik bilgisi iletişim kutusunda gösterilen redirect URL, örneğin bir workspace alan adı değişikliğinden sonra, sağlayıcıda kayıtlı adresle artık tam olarak eşleşmiyorsa, hata n8n Cloud'da da ortaya çıkabilir. Bu durumda, o anda gösterilen redirect URI'yi tekrar kopyalamak ve Google Cloud Console'da veya Microsoft uygulama kaydında güncellemek yardımcı olur.

Aynı çözüm Microsoft kimlik bilgileri için de geçerli mi?

Evet, Microsoft ya da Azure bağlantılarında da ilke aynıdır, çünkü orada da n8n tarafından gönderilen redirect URI ile uygulama kaydında kayıtlı reply URL arasında tam bir eşleşme gereklidir. Bu nedenle aynı N8N_HOST, N8N_PROTOCOL ve WEBHOOK_URL değişkenlerini ayarlayın ve n8n kimlik bilgisinde gösterilen adresi Azure uygulama kaydınızın reply URL'leri listesine girin.