← Назад до блогу

Помилки входу в n8n: що перевірити перед SSO або LDAP

Коли вхід у n8n раптово ламається на self-hosted інстансі, рішення рідко в SSO чи LDAP. Цей гайд показує, що перевірити першим.

Ілюстрація замка у формі cookie, клапана труби та конверта, які перевіряють перед невикористаним кардридером для входу в n8n.

Перевірено за наведеними джерелами .

Чому вхід в n8n перестає працювати на self-hosted інстансі: три звичайні причини

Коли вхід у n8n раптово перестає працювати для всієї команди на self-hosted інстансі, перший порух часто — шукати масштабніше рішення: single sign-on, LDAP чи інший шар ідентифікації. У більшості випадків це неправильний перший крок. Помилки входу в n8n на self-hosted інстансі зазвичай зводяться до трьох буденних проблем конфігурації: неузгодженості secure-cookie та HTTPS, неправильно налаштованого реверс-проксі або помилки в налаштуванні керування користувачами.

У кожної причини є свій сигнал і своє рішення — коротко підсумовано нижче, перш ніж ми розберемо їх детальніше.

Три звичайні причини помилок входу в n8n на self-hosted інстансах
ПричинаПриклад сигналуЙмовірне рішення
Неузгодженість secure-cookie / HTTPSСторінка входу перезавантажується або відхиляє правильні облікові дані при доступі через HTTPНадавайте n8n через справжній HTTPS з відповідними N8N_PROTOCOL та N8N_WEBHOOK_URL
Неправильна конфігурація реверс-проксіПомилки forwarded-заголовків, повторні вихід із системи або зламаний інтерфейсВстановіть N8N_PROXY_HOPS і переконайтеся, що проксі передає потрібні заголовки
Помилка налаштування керування користувачамиЗапрошення або листи для відновлення пароля не приходять, або попередньо налаштований власник не може увійтиНалаштуйте SMTP і надайте пароль власника у вигляді bcrypt-хешу

Sources: Security | Deploy | n8n Docs, Configure webhook URLs with reverse proxy | Deploy | n8n Docs, Constantly logged out after less than a minute - Questions - n8n Community, Set up SSL | Deploy | n8n Docs, User management | Deploy | n8n Docs, User management and 2FA | Deploy | n8n Docs

Причина 1: неузгодженість secure-cookie / HTTPS

За замовчуванням n8n позначає свою cookie для входу як HTTPS-only — ця настройка задокументована у власному довіднику змінних середовища n8n як N8N_SECURE_COOKIE. Це означає, що доступ до інстансу через звичайний HTTP, або через HTTPS-адресу, яка не відповідає тій, на якій, на думку n8n, він працює, може взагалі заблокувати встановлення cookie для входу, тож екран входу виглядає так, наче відхиляє правильні облікові дані.

Це також найшвидше, що можна виключити, і саме це ми перевіряли б першим за будь-якого звернення про проблему входу, оскільки рідко потребує глибокого дослідження проксі. Описуючи саме цю помилку в розгортанні на Coolify та Docker, один незалежний IT-спеціаліст висловився проти вимкнення налаштування secure-cookie як рішення:

Один користувач self-hosted рішення, що працював із Nginx Proxy Manager, натрапив саме на цю помилку і обійшов її, вимкнувши secure cookie, лише щоб виявити, що справжньою проблемою було те, що реверс-проксі з самого початку неправильно маршрутизував його піддомен. Вимкнення N8N_SECURE_COOKIE може лише приховати проблему маршрутизації, а не вирішити її, і ця проблема має тенденцію повертатися.

Sources: Security | Deploy | n8n Docs, Solution for the Error: "Your n8n server is configured to use a secure cookie, however, you are visiting this via an insecure URL" - Daniel Lautenbacher, Your n8n server is configured to use a secure cookie, however you are either visiting this via an insecure URL, or using Safari - Questions - n8n Community

Причина 2: неправильна конфігурація реверс-проксі (webhook URL, proxy hops, заголовки, CSP, SSE)

Діаграма браузера, з'єднаного через багатоступеневу трубу проксі з сервером під час перевірки входу.
Спрощене уявлення про те, як реверс-проксі розташовується між браузером і self-hosted сервером n8n під час входу.

Якщо з HTTPS і cookie все гаразд, далі варто перевірити реверс-проксі, що стоїть перед n8n. Власна документація n8n щодо SSL рекомендує завершувати TLS на реверс-проксі, наприклад Traefik, або на мережевому балансувальнику навантаження, а не передавати сертифікати безпосередньо в n8n, а в рекомендаціях щодо реверс-проксі вказано встановлювати N8N_PROXY_HOPS на 1 при роботі за одним проксі-хопом.

Якщо тут помилитися, симптоми можуть виглядати точнісінько як проблема входу, хоча справжньою причиною є проксі. В одному повідомленні зі спільноти користувач з'ясував, що повторні, незрозумілі виходи з системи були пов'язані з відсутньою настройкою перевірки forwarded-заголовків, і встановлення N8N_PROXY_HOPS на 1 вирішило проблему; тема датована 2024 роком і не є задокументованим загальним механізмом, тож варто сприймати це як підказку, а не гарантію.

Перевірка заголовків проксі після проблеми входу або виходу: 1. Перевірте webhook URL; 2. Встановіть кількість proxy hops; 3. Перевірте forwarded-заголовки; 4. Виключіть доданий заголовок CSP

Дві старіші теми зі спільноти вказують на пов'язані, але відмінні симптоми: реверс-проксі, який додає власний заголовок Content-Security-Policy, може зламати інтерфейс n8n, оскільки сам n8n не встановлює жодного CSP, а проксі, не налаштований для Server-Sent Events, може залишити інтерфейс застряглим на постійному повідомленні 'Connection lost' замість прямої помилки входу. Обидва повідомлення — старі, відповідно з 2024 та 2020 років, і позначені як застарілі, тож ми радимо сприймати їхні конкретні рішення як відправну точку для перевірки, а не остаточний діагноз для будь-якої конфігурації.

Sources: Configure webhook URLs with reverse proxy | Deploy | n8n Docs, Constantly logged out after less than a minute - Questions - n8n Community, Set up SSL | Deploy | n8n Docs, Cors issue on self hosted with reverse proxy - #2 by netroy - Questions - n8n Community, /!\ Connection lost with http reverse proxy Apache - #2 by jan - Questions - n8n Community

Причина 3: помилки налаштування керування користувачами (SMTP, налаштування власника, JWT/2FA)

Третя звичайна причина перебуває у власному налаштуванні керування користувачами n8n, а не в мережевому шляху. Документація n8n описує SMTP як опціональний, починаючи з n8n 0.210.1, але він усе ж необхідний для того, щоб листи відновлення пароля та запрошення справді надходили; до цієї версії передбачений потік — створити власника інстансу через вбудований екран реєстрації, а потім запрошувати інших користувачів.

Також варто знати, що більше не працює: n8n видалив підтримку базової автентифікації та автентифікації на основі JWT у n8n 1.0, і в поточних версіях немає підтримуваного способу повністю вимкнути екран входу.

Ще два деталі налаштування спричиняють справжні блокування доступу. Якщо ви попередньо налаштовуєте власника інстансу через змінні середовища, пароль потрібно вказувати у вигляді bcrypt-хешу; значення у відкритому тексті одразу зламає вхід. n8n також за замовчуванням включає двофакторну автентифікацію через N8N_MFA_ENABLED, а окремі налаштування тривалості JWT-сесії та оновлення контролюють, наскільки часто користувачів виходить із системи і просить увійти знову.

Sources: User management | Deploy | n8n Docs, User management and 2FA | Deploy | n8n Docs

Практичний порядок перевірки входу в n8n перед додаванням SSO чи LDAP

Рука перевіряє бірки у формі cookie, труби та конверта на кільці з ключами, перед тим як узяти окремий орнаментальний ключ.
Проходження перевірок cookie, проксі та керування користувачами перед зверненням до SSO чи LDAP.

Коли ви знаєте трьох звичних підозрюваних, практичне питання — у якому порядку перевіряти проблему входу в n8n. Наведена нижче послідовність базується на ймовірності та швидкості перевірки, а не на алфавітному порядку.

Sources: Security | Deploy | n8n Docs, Your n8n server is configured to use a secure cookie, however you are either visiting this via an insecure URL, or using Safari - Questions - n8n Community, Configure webhook URLs with reverse proxy | Deploy | n8n Docs, Constantly logged out after less than a minute - Questions - n8n Community, Cors issue on self hosted with reverse proxy - #2 by netroy - Questions - n8n Community, User management | Deploy | n8n Docs, User management and 2FA | Deploy | n8n Docs

Коли переходити до SSO чи LDAP замість пошуків базових причин

SSO та LDAP додають новий шар ідентифікації над тією самою інфраструктурою cookie та проксі, описаною вище; вони не замінюють її. Якщо проблеми входу команди насправді стосуються HTTPS, заголовків проксі чи SMTP, додавання SSO не вирішить їх, і ті самі симптоми мають тенденцію повертатися в новому потоці.

Коли ви справді виключили ці звичні причини, і справжньою проблемою є керування великою кількістю облікових записів, ролей чи зовнішнім каталогом у зростаючій команді, тоді й варто вести розмову про SSO чи LDAP. Ми вважаємо, що саме цей момент правильний для інвестування в SSO чи LDAP, але це не замінює виправлення зламаної cookie чи налаштування проксі насамперед.

Sources: Security | Deploy | n8n Docs, Configure webhook URLs with reverse proxy | Deploy | n8n Docs, Set up SSL | Deploy | n8n Docs

Спробуйте на практиці

Практичні завдання з n8n

Оберіть завдання й створіть робочий воркфлоу у власному середовищі n8n – до кожного завдання є п’ять поступових підказок.

Спробувати практичне завдання

Для вашої команди

Програми навчання n8n для однієї команди чи відділу – на вашому власному екземплярі n8n, з вашими інструментами й даними.

Навчання для вашої команди

Оцінка навичок n8n

Безкоштовний тест приблизно на 20 хвилин, англійською: 30 запитань у 10 напрямах і рівень від початківця до експерта. На AI Adoption Score – іншому проєкті автора цього сайту.

Дізнатися свій рівень n8n