Jira'yi n8n ile baglamak: kimlik dogrulama, eylemler ve Confluence meselesi

n8n, sorunlari (issue), ekleri, yorumlari ve kullanicilari yoneten kendi uygulama node'u araciligiyla Jira'ya baglanir; kimlik dogrulama ise Cloud OAuth2, Cloud API token'i veya sunucu kimlik bilgileri araciligiyla yapilabilir. Confluence icin ise ayri bir n8n node'u bulunmaz, bu nedenle bilgi sayfalarina yalnizca genel HTTP Request node'u uzerinden erisilebilir. Bu yazi, uc Jira yonteminden hangisinin sizin ortaminiza uygun oldugunu, Jira node'unun gercekte neler yapabildigini ve n8n kullanicilarinin pratikte en sik nerede hatalarla karsilastigini gosterir. Guncelleme: Agustos 2026.

Jira ortaminiza hangi kimlik dogrulama yontemi uygundur?

Dogru yontem oncelikle Jira Cloud mu yoksa bir sunucu kurulumu mu kullandiginiza baglidir. Her uc secenek de Jira icin n8n kimlik bilgileri belgesinde aciklanmistir.

• SW Cloud OAuth2: Jira Software Cloud icin dusunulmustur. Atlassian Developer Console'da bir OAuth 2.0 entegrasyonu olusturur, n8n'den gelen geri cagirma (callback) URL'sini kaydeder ve read:jira-user, read:jira-work, write:jira-work, manage:jira-webhook, manage:jira-user ve offline_access kapsamlarini (scope) etkinlestirirsiniz. Ardindan n8n'de Client ID, Client Secret ve alan adini, ornegin ornekfirma.atlassian.net, girersiniz.
• SW Cloud API Token: Yine Jira Cloud icindir, ancak kendi OAuth uygulamaniz olmadan. Token'i Atlassian profil sayfasinda olusturur ve n8n'de e-posta adresini, token'i ve alan adini girersiniz. n8n belgelerine gore, yeni olusturulan token'larin calismasi bir dakikaya kadar surebilir.
• SW Server Account: Jira Software sunucu kurulumlari icin, Atlassian yonetiminde ek bir kurulum yapmadan e-posta, sifre ve Jira erisim URL'sinden olusan klasik bir kimlik bilgisi cifti yeterlidir.

Jira node'u hangi eylemleri kapsar?

Jira node'u dort alani kapsar: sorunlar (issue), ekler, yorumlar ve kullanicilar. Sorunlarda olusturma, silme, tek tek veya liste olarak getirme, degisiklik gecmisini (changelog) goruntuleme, durum gecislerini (transition) calistirma ve e-posta bildirimlerini tetikleme islemlerini yapabilirsiniz. Ekler eklenebilir, getirilebilir ve kaldirilabilir; yorumlar eklenebilir, guncellenebilir ve silinebilir; kullanicilarda ise olusturma, silme ve getirme mumkundur. Filtre sorgulari basit parametre alanlari yerine Jira Query Language (JQL) uzerinden yurutulur, bu da biraz aliskanlik gerektirir. Node bir islemi kapsamiyorsa, Jira node'una iliskin n8n belgeleri bizzat HTTP Request node'una yonlendirir; bu node ayni kayitli kimlik bilgilerini yeniden kullanabilir.

Neden bir Confluence node'u yok ve buna ragmen nasil cozulur?

Birçok ekip Jira ticket'larini ve Confluence bilgi sayfalarini ayni surecte yonetmek istese de, n8n su anda ozel bir Confluence node'u sunmuyor. Olagan cozum, bir Atlassian ortaminin Confluence REST API'siyle konusan HTTP Request node'udur. n8n bunun icin tam olarak hangi uc noktalarin (endpoint), kapsamlarin (scope) ve izinlerin gerekli oldugunu belgelememistir; bir is akisini canliya almadan once bunu dogrudan Atlassian'in kendi Confluence API belgelerinde kontrol edin. "Bir Jira ticket'i kapatildiginda yeni bir sayfa olustur" gibi basit durumlar icin Jira node'uyla ayni kimlik bilgilerine sahip bir HTTP Request node'u genellikle yeterlidir; daha karmasik sayfa yapilari icin canliya gecmeden once bir sandbox ortaminda test yapmakta fayda vardir.

Pratikte en sik hangi hatalar ortaya cikiyor?

n8n topluluğunda, baslangici zorlastiran esas olarak uc hata deseni bulunuyor. Jira Data Center kullanicilari, token Jira'nin kendisinde gecerli olsa bile bir Personal Access Token baglarken 403 hatalari bildiriyor. Digerleri, kimlik bilgileri genel olarak calismasina ve liste bir sonraki denemede yuklenmesine ragmen, Jira node'undaki acilir listelerin "Could not load list, please check credentials" hatasiyla basarisiz oldugunu bildiriyor. Ucuncu bir grup, kisisel hesaplar yerine Atlassian hizmet hesaplarini kaydetmeye calisirken sorun yasiyor; kimlik bilgilerinin kaydedilmesi bu durumda "Forbidden" hatasiyla basarisiz oluyor. Kendi devreye almanizdan once n8n topluluguna goz atmak bu tur durumlarda genellikle zaman kazandirir, cunku benzer durumlar genellikle daha once tartisilmistir. Guvenilir bir Jira otomasyonunu kendiniz kurup surdurmek istemiyorsaniz, NordFlux bunu sabit fiyatli bir projede ustlenir, bkz. NordFlux'un n8n otomasyonu.

n8n'de Jira ve Confluence hakkinda sik sorulan sorular

n8n ile Confluence sayfalarini otomatik olarak da olusturabilir miyim?

Ozel bir node uzerinden degil, ancak Confluence REST API'sine karsi HTTP Request node'u uzerinden mumkundur. n8n bu yolu ayrintili olarak belgelemez, bu nedenle uc noktalari ve izinleri Atlassian belgelerinde kendiniz aramaniz gerekir. Bir ticket kapatildiginda sayfa olusturmak gibi basit kullanim durumlari icin gereken caba sinirlidir.

Jira Cloud icin hangi Jira kimlik dogrulamasi en uygunudur?

Cogu ekip icin SW Cloud API Token yontemi en pragmatik baslangic noktasidir, cunku kendi OAuth uygulamaniz olmadan calisir. OAuth2 secenegi, birden fazla kullanicinin ayni is akisini kullanmasi gerektiginde veya ayrintili kapsamlara (scope) ihtiyac duyuldugunda degerlidir.

Jira kimlik bilgilerini baglarken "Forbidden" veya 403 hatalari alirsaniz ne yapmalisiniz?

Once token veya hesabin secilen kimlik dogrulama yontemi icin gercekten uygun olup olmadigini kontrol edin; ornegin Data Center'dan bir Personal Access Token her alana uymaz. n8n topluluğunda benzer durumlar defalarca belgelenmistir ve bunlari kendi kurulumunuzla karsilastirmak genellikle yeniden denemekten daha hizli yardimci olur.

Jira node'u karmasik filtre sorgularini isleyebilir mi?

Evet, ancak yalnizca basit acilir menu parametreleri yerine Jira Query Language (JQL) uzerinden. Jira arayuzunden JQL'i zaten bilenler, ayni sorgulari node icinde yeniden kullanabilir.