Чому SSO у self-hosted ПЗ часто платний
Чому розробники обмежують OIDC та SAML у безкоштовних версіях. Розбираємо логіку ціноутворення та надаємо чек-лист для перевірки сервісів перед їх розгортанням на власному VPS.
Податок на SSO
«Податок на SSO» у self-hosted програмному забезпеченні — це модель, за якої застосунок безкоштовний, а єдиною платною функцією стає single sign-on (SSO). Ви можете запустити всю систему на власному VPS без ліцензійного ключа та обмеження за кількістю користувачів. Потім ви відкриваєте в документації сторінку автентифікації й виявляєте, що OpenID Connect (OIDC) або SAML (security assertion markup language) доступні лише в платному плані.
Це важливіше за звичайну функцію, доступну лише за плату, оскільки саме SSO дає змогу кільком self-hosted сервісам працювати як єдина система. Identity provider (IdP) надає один обліковий запис для кожної людини, одну політику паролів, одне місце для ввімкнення багатофакторної автентифікації (MFA) і одне місце для блокування доступу. Без IdP кожен застосунок зберігає власну невелику базу користувачів, і ви вручну обслуговуєте кожну з них.
Ця практика існує достатньо давно, щоб для неї з’явився публічний список. SSO Wall of Shame на sso.tax містить постачальників, які стягують значну додаткову плату за single sign-on. У списку є записи, починаючи з 2018 року, а його автор установив обґрунтований критерій: «Якщо підтримка SSO підвищує ціну на 10%, вас немає в цьому списку». Більшість у цьому списку — закрите програмне забезпечення. Та сама модель ціноутворення тепер з’являється і у проєктах із відкритим кодом, які ви розгортаєте самостійно.
Чому розробники розміщують single sign-on у платному тарифі
Є дві причини, і обидві цілком обґрунтовані. Підтримка SSO дорога, а це одна з небагатьох функцій, за яку велика організація готова платити.
Витрати на підтримку реальні, оскільки інтеграція з identity provider ніколи не буває завершеною. Кожен IdP трохи по-різному форматує свої claims. Відповідність груп, тривалість сесії, URL перенаправлення та розбіжність часу окремо можуть спричиняти помилки входу. Помилка входу одночасно блокує всіх користувачів, тому такі звернення мають високий пріоритет. Далі з’являються пов’язані запити: вкладені групи, відповідність ролей, автоматичне provisionування через SCIM (system for cross-domain identity management) та audit logs, які переглядатиме команда з compliance.
З погляду доходу це радше арифметика, ніж зловмисність. Компанія, яка не може підключити застосунок до власного IdP, узагалі його не впроваджуватиме. Тому SSO чітко розмежовує користувачів, які платять, і тих, хто не платить. Проєкту з open core потрібно десь провести цю межу. Для SSO це підходить краще, ніж майже для будь-якої іншої функції, тому так робить багато проєктів.
Є одне уточнення до поширеної претензії: перш ніж припускати, що функцію забрали, перевірте changelog, оскільки видалення відображається в release notes. У більшості проєктів, які я перевірив для цієї публікації, платні функції SSO від початку створювалися для платного тарифу. Винятком є Planka. Його безкоштовне Community edition підтримувало робочий OIDC до версії 2.2.0, випущеної 9 August 2026. У release notes цієї версії сказано: "OIDC/SSO has been removed from PLANKA Community." Тепер ця функція доступна в Planka Pro, і власне пояснення розробників підтверджує це: "The fact that it ended up in Community never fit that model." Grafana є типовим прикладом решти проєктів. На сторінці SAML є однорядкова примітка: "Available in Grafana Enterprise and Grafana Cloud", тоді як звичайний OAuth із вашим власним issuer працює у open source build.
Фактична вартість SSO tax
Гроші — лише менша частина витрат. Більшість платних тарифів розраховується за кількістю користувачів, тому рахунок зростає разом із командою, а хостинг і оновлення залишаються вашою відповідальністю. n8n є винятком: на сторінці з цінами зазначено, що всі плани включають необмежену кількість користувачів, а оплата залежить від щомісячної кількості запусків workflow.
Більша частина витрат — це ручна робота з ідентифікацією. Вона проявляється у чотирьох аспектах.
- Окреме сховище паролів для кожного застосунку. Повторно використаний пароль стає вразливістю в кожному застосунку, де його використовують.
- Видалення доступу під час offboarding залежить від пам’яті. Потрібно пам’ятати кожен сервіс, до якого мав доступ працівник. Забутий сервіс і створює найбільший ризик.
- MFA налаштовується окремо в кожному застосунку, якщо цей застосунок її взагалі підтримує.
- Спільні облікові дані. Саме до цього за такого навантаження зазвичай приходять невеликі команди.
Останній пункт заслуговує на окреме пояснення. Коли команда використовує один спільний administrator account у document manager, журнал аудиту записує одне ім’я для всіх дій. Тому неможливо визначити, хто видалив рахунок. Дозволи для окремих користувачів також перестають працювати, оскільки існує лише один користувач. У цьому і полягає реальна шкода SSO tax: він підштовхує невеликі команди до використання одного спільного облікового запису, що гірше за будь-яку альтернативу.
Чекліст перед розгортанням будь-якого застосунку
Виконайте його перед docker compose up, а не після того, як застосунок збереже 400 документів.
- Відкрийте в документації сторінку автентифікації та прочитайте примітку про тарифний план угорі. Платні функції позначаються бейджем або однорядковим описом доступності.
- Переконайтеся, що застосунок підтримує OIDC або SAML із вашим власним issuer, а не лише з фіксованим переліком публічних провайдерів.
- Перевірте зіставлення ролей і груп. Створення користувача — це лише половина роботи. Призначати дозволи вручну в десяти застосунках — найскладніша частина.
- Перевірте, чи приймає застосунок автентифіковане ім’я користувача в заголовку від довіреного проксі та чи можна явно вказати, якому проксі він довіряє.
- Перегляньте історію ліцензії в git і перевірте, чи підписують учасники CLA (contributor licence agreement).
- Перевірте процедуру деактивації доступу. З’ясуйте, що відбувається з API (application programming interface) токенами та активними сесіями, коли обліковий запис у IdP вимкнено.
Саме на пункті 2 найчастіше виникають розчарування. Кнопка «Sign in with Google» не означає підтримку OIDC із вашим identity provider: це фіксована інтеграція з одним постачальником. Повноцінна підтримка передбачає, що застосунок запитує URL issuer, а решту даних отримує через discovery. Сторону вашого провайдера можна перевірити однією командою.
curl -s https://id.example.com/.well-known/openid-configuration \
| jq '.issuer, .authorization_endpoint, .token_endpoint'Від справного провайдера повертаються три URL. Порожній результат або код 404 зазвичай означає, що шлях discovery неправильний. Цей шлях залежить від провайдера: Keycloak публікує його в /realms/<realm>/.well-known/openid-configuration. Якщо в застосунку взагалі немає поля для URL issuer, він не може взаємодіяти з вашим IdP, незалежно від заявленого переліку функцій.
Пункт 6 часто виявляється проблемою через кілька тижнів після звільнення працівника. Вимкнення облікового запису в IdP блокує нові входи. Воно не відкликає API-токен, який застосунок видав раніше, оскільки застосунок перевіряє цей токен самостійно й не звертається до IdP. Тому деактивація доступу складається з двох кроків: вимкніть обліковий запис у IdP, а потім видаліть користувача або його токени в кожному застосунку.
Що насправді означають позначки тарифів
Ці дані перевірено за документацією кожного проєкту 11 October 2026. Почнімо з платної частини.
Grafana зазначає SAML як "Available in Grafana Enterprise and Grafana Cloud", а також підтримує синхронізацію команд і provisioning через SCIM. Generic OAuth, GitHub OAuth, LDAP (lightweight directory access protocol) і auth proxy доступні у open source-збірці, тому невеликий self-hoster і далі може входити через власного провайдера. Платна межа проходить саме на рівні SAML, а не single sign-on загалом. Саме цю відмінність зазвичай нівелює вислів "SSO tax".
Metabase формулює це пряміше. У його документації сказано: "SAML authentication is only available on Pro and Enterprise plans (both self-hosted and on Metabase Cloud)." Open source-редакція зберігає вхід за паролем і LDAP.
Passbolt позначає документацію щодо SSO як Pro і Cloud, тому community edition не має цієї функції. Серед документованих провайдерів є Keycloak і Entra ID.
n8n закриває всі ці можливості за платним доступом. Self-hosted community edition є безкоштовною за fair-code ліцензією, але в документації вхід через SAML і LDAP зазначено для планів Business та Enterprise, а OIDC — лише для Enterprise. Отже, безкоштовного маршруту для single sign-on немає взагалі. Це один із пунктів довшого переліку того, чого немає у безкоштовній редакції n8n.
Тепер інший бік, оскільки така модель далеко не універсальна.
- GitLab Self-Managed має на сторінці SAML позначку "Tier: Free, Premium, Ultimate", тому SAML для власного GitLab нічого не коштує.
- Paperless-ngx налаштовує OIDC через django-allauth за допомогою
PAPERLESS_SOCIALACCOUNT_PROVIDERS, приховує локальну форму входу за допомогоюPAPERLESS_DISABLE_REGULAR_LOGINі зіставляє claims із групами за допомогоюPAPERLESS_SOCIAL_ACCOUNT_SYNC_GROUPS. - Planka більше не належить до цієї категорії. Його Community edition використовувала
OIDC_ISSUER,OIDC_CLIENT_IDіOIDC_CLIENT_SECRET, за замовчуванням призначала scopes якopenid profile emailі визначала адміністраторів із role claim за допомогоюOIDC_ADMIN_ROLES. Це тривало до версії 2.2.0, випущеної 9 August 2026, коли OIDC вилучили з Community і перенесли до Planka Pro. Старіші випуски Community зберігають цю функцію, але супроводжуються лише для останнього випуску. - BookStack перемикається за допомогою
AUTH_METHOD=oidc, а потім зіставляє групи провайдера зі своїми ролями за допомогоюOIDC_USER_TO_GROUPS=trueіOIDC_GROUPS_CLAIM. - Vaultwarden додав "support for SSO with OpenID Connect" у версії 1.35.0, випущеній 27 December 2025, на основі pull request від контриб’ютора, який підтримував цю функцію у fork.
- listmonk підтримує вхід через OIDC разом із власними ролями користувачів починаючи з v4.1.0, випущеної 12 November 2024.
Використовуйте цю інформацію під час вибору, а не після ухвалення рішення. Kanban-дошка Planka та інші self-hosted альтернативи Trello по-різному працюють з ідентифікацією. Те саме стосується BookStack, Wiki.js і Outline. Безкоштовний OIDC — це функція, яку можна оцінювати нарівні з обмеженнями сховища або підтримкою мобільних клієнтів. Якщо ви ще формуєте перелік, що self-hosted у 2026 році — прийнятна відправна точка. І менеджер документів Paperless-ngx, і Vaultwarden уже сьогодні надають безкоштовний OIDC.
Чому reverse proxy перед застосунком не є єдиним входом
Поширений обхідний варіант — forward auth. Reverse proxy затримує кожен запит, запитує сервіс автентифікації, чи виконано вхід у цьому браузері, і лише після цього передає запит застосунку. authentik називає це proxy provider із режимом forward auth для одного застосунку та окремим режимом для всього домену. Authelia і oauth2-proxy виконують те саме завдання.
Блок сайту Caddy має такий вигляд відповідно до власного прикладу authentik.
app.example.com {
forward_auth http://authentik-outpost:9000 {
uri /outpost.goauthentik.io/auth/caddy
copy_headers X-Authentik-Username X-Authentik-Email X-Authentik-Groups
trusted_proxies private_ranges
}
reverse_proxy app:8000
}Регістр цих назв заголовків у Caddy має значення, оскільки заголовок із невідповідною назвою надходить порожнім. Для кожного схваленого запиту outpost встановлює X-authentik-username, X-authentik-email, X-authentik-groups і ще кілька заголовків.
Ось що це дає. Ніхто не може отримати доступ до застосунку, не пройшовши спочатку через ваш identity provider. Тому невиправлена форма входу більше не доступна з інтернету, а MFA одночасно застосовується до всіх ресурсів за reverse proxy.
Ось чого це не дає: ідентифікації всередині застосунку. Застосунок і далі має власні облікові записи та власне визначення того, хто виконав вхід. Якщо всі проходять reverse proxy і потрапляють в один спільний обліковий запис адміністратора, ви маєте надійний зовнішній бар’єр і одну анонімну сесію за ним. У журналі аудиту й далі відображається одне ім’я. Розмежувати дозволи між користувачами все ще неможливо. Називати таку схему SSO — помилка безпеки, оскільки процес видалення доступу працює лише частково: видалення користувача з вашого IdP закриває зовнішній доступ, але створений ним API token усередині застосунку продовжує працювати для будь-кого, хто може напряму отримати доступ до застосунку.
Безпечне використання автентифікації через заголовок
Деякі застосунки приймають ім’я користувача від проксі. Це дає змогу визначати користувача без платного SSO. У кожному проєкті цей параметр має іншу назву.
Grafana називає цю функцію auth proxy і постачає її вимкненою. Назва заголовка за замовчуванням — X-WEBAUTH-USER. Її можна замінити на будь-який заголовок, який встановлює ваш проксі.
[auth.proxy]
enabled = true
header_name = X-authentik-username
header_property = username
auto_sign_up = true
whitelist = 10.0.0.5whitelist — це параметр, який часто пропускають. Документація Grafana прямо зазначає, що він запобігає підробленню заголовка користувачами. Тому тут має бути лише адреса вашого проксі. Gitea має таку саму функцію під іншими назвами та постачається з безпечнішим значенням за замовчуванням.
[security]
ENABLE_REVERSE_PROXY_AUTHENTICATION = true
REVERSE_PROXY_AUTHENTICATION_USER = X-WEBAUTH-USER
REVERSE_PROXY_TRUSTED_PROXIES = 10.0.0.5/32
REVERSE_PROXY_LIMIT = 1REVERSE_PROXY_TRUSTED_PROXIES має значення 127.0.0.0/8,::1/128 за замовчуванням. REVERSE_PROXY_LIMIT визначає, скільком проксі в ланцюжку довіряє Gitea. Якщо встановити це обмеження на нуль, обробку заголовка буде повністю вимкнено.
Paperless-ngx пропонує PAPERLESS_ENABLE_HTTP_REMOTE_USER разом із PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME. У документації наведено попередження, яке стосується всіх таких параметрів:
Це дасть змогу автентифікуватися, просто додавши до запиту заголовок Remote-User: <username>. Використовуйте з обережністю!
Безпечну автентифікацію через заголовок забезпечують два правила. Обидва стосуються доступності сервісу. По-перше, застосунок має бути недоступним у будь-який інший спосіб, крім проксі. Будь-хто, хто може відкрити до нього socket-з’єднання, зможе надіслати цей заголовок і ввійти від імені будь-якого користувача. У Docker ports: ["8000:8000"] публікує порт на всіх інтерфейсах. Прив’яжіть його до loopback-адреси за допомогою ports: ["127.0.0.1:8000:8000"] або приберіть опублікований порт і підключіть проксі до тієї самої Docker network. По-друге, проксі має видаляти будь-яку копію цього заголовка, отриману від клієнта. Тоді застосунок бачитиме лише значення, яке проксі встановлює після автентифікації.
Перевірте обидві умови. Першу команду виконайте з машини поза межами вашого VPS, а другу — безпосередньо на сервері.
curl -si -H "Remote-User: admin" http://203.0.113.10:8000/ | head -n 1
ss -ltnp | grep 8000curl має завершитися помилкою підключення, а ss має вивести 127.0.0.1:8000, а не 0.0.0.0:8000. Будь-який рядок стану, наприклад HTTP/1.1 302 Found (зазвичай це редирект на сторінку входу), означає, що застосунок безпосередньо відповідає на запити з публічного інтернету. Якщо автентифікацію через заголовок увімкнено, це створює вразливість: будь-хто може ввійти від імені будь-якого користувача, указавши його ім’я в заголовку.
Коли безкоштовного SSO немає, приймайте рішення, а не скаржтеся
Чотири варіанти в порядку, у якому я б їх розглядав.
- Виберіть застосунок із підтримкою OIDC. Якщо два проєкти виконують однакову роботу, але один безкоштовно взаємодіє з вашим identity provider, це реальна різниця в експлуатаційних витратах.
- Чесно використовуйте forward auth. Для адміністративного інструмента з одним обліковим записом і одним оператором достатньо проксі попереду. Ідентифікація кожного користувача всередині застосунку нічого не дає.
- Заплатіть. Якщо застосунок є важливим для вашої роботи, а ціна за seat відповідає розміру команди, ці кошти допомагають підтримувати проєкт. Альтернатива — витрачати на це власні вечори.
- Зверніться до розробників після пошуку в issue tracker. Підтримка OIDC у Vaultwarden з’явилася завдяки fork від учасника спільноти та pull request, який тривалий час перебував у роботі. Тому запит на функцію з готовою реалізацією іноді потрапляє до безкоштовної редакції.
Усе це неможливо без власного identity provider, і саме його слід розгорнути спочатку. Розгортання authentik на VPS дає вам провайдер OIDC і SAML, а також forward auth outpost, який використовувався вище. У порівнянні Keycloak, authentik і Zitadel описано компроміси, якщо ви поки не хочете остаточно визначатися.
Історія ліцензії та чому вона є в контрольному списку
Останній пункт контрольного списку стосується майбутнього, оскільки сьогоднішня структура рівнів ліцензування є лише моментальним станом. Два добре задокументовані випадки показують, як швидко змінюється ситуація в обох напрямках. 10 August 2023 HashiCorp перевела майбутні релізи всіх своїх продуктів, а також кількох бібліотек, з MPL 2.0 (Mozilla Public License) на Business Source License 1.1, тоді як її API, SDK і майже всі інші бібліотеки залишилися під MPL 2.0. У March 2024 Redis перейшла на SSPL (server side public license), а 1 May 2025 оголосила, що Redis 8 також випускається під AGPLv3 (GNU Affero General Public License).
Розглядайте обидва випадки як свідчення механізму, а не мотивів. Ліцензія, яку ви читаєте сьогодні, застосовується до версії, яку ви встановлюєте сьогодні, а проєкт, який володіє всіма авторськими правами, може самостійно змінити умови наступного релізу. Саме тому питання про CLA є в контрольному списку: широке передавання авторських прав дає змогу одноосібно змінити ліцензію.
Самостійно перевірте історію проєкту, перш ніж будувати на його основі.
git clone --filter=blob:none https://github.com/paperless-ngx/paperless-ngx.git
cd paperless-ngx
git log --follow --oneline -- LICENSEКороткий список комітів, переважно з моменту першого імпорту, є доброю ознакою. Якщо файл ліцензії переписували кілька разів, прочитайте повідомлення кожного коміту, перш ніж планувати роботу з урахуванням поточних умов.
FAQ
Що таке SSO tax?
SSO tax — це практика стягнення плати за single sign-on як за преміум-функцію, тоді як решта продукту є безкоштовною або недорогою. У self-hosted програмному забезпеченні це виглядає як open source застосунок, який можна запустити без licence key, але вхід через OIDC або SAML доступний лише в платному тарифі. Назва походить від SSO Wall of Shame на sso.tax, де відстежують постачальників, які встановлюють за цю функцію значну надбавку. Для self-hoster це означає, що кожен застосунок зберігає власну базу користувачів, тому облікові записи доводиться створювати й видаляти вручну.
Чи є reverse proxy із forward auth тим самим, що й SSO?
Ні. Forward auth захищає вхідну точку: проксі перевіряє запит через identity provider, перш ніж будь-який запит досягне застосунку. Застосунок за проксі все одно використовує власні облікові записи. Тому, якщо всі користувачі входять через один спільний логін, ви отримуєте одну анонімну сесію та журнал аудиту з одним ім’ям. Повноцінна ідентифікація окремих користувачів з’являється лише тоді, коли застосунок читає ім’я користувача із заголовка. Це можуть робити auth proxy у Grafana, reverse proxy authentication у Gitea та PAPERLESS_ENABLE_HTTP_REMOTE_USER у Paperless-ngx. Такі налаштування безпечні лише доти, доки до застосунку неможливо звернутися інакше, ніж через проксі, оскільки заголовок містить звичайний рядок, який може надіслати будь-який клієнт.
Які self-hosted застосунки містять OIDC у безкоштовній редакції?
Перевірено за документацією проєктів станом на 11 October 2026: Paperless-ngx, BookStack, Gitea, listmonk і Vaultwarden підтримують OIDC у безкоштовних збірках, а GitLab Self-Managed вказує SAML у категорії Tier: Free. Planka підтримувала його до version 2.2.0 у August 2026, після чого OIDC перенесли з її Community edition до Planka Pro. Open source build Grafana підтримує generic OAuth через власний issuer, тоді як SAML у ній є функцією Enterprise. Перевірте сторінку автентифікації самого проєкту перед встановленням, оскільки ці списки змінюються разом із releases.
Чи варто платити за тариф, який розблоковує single sign-on?
Оцініть це за двома показниками: скільком людям потрібні облікові записи та скількома застосунками вам інакше довелося б керувати вручну. Для одного або двох адміністраторів forward auth перед локальним обліковим записом достатньо, а платний тариф дає небагато переваг. У команді, де люди приєднуються та залишають її, один обліковий запис, який не видалили під час offboarding, може коштувати дорожче за licence, а оплата фінансує технічне обслуговування, на яке ви розраховуєте. Якщо ціна не відповідає бюджету, практичніше вибрати застосунок із вбудованою підтримкою OIDC, а не обходити обмеження застосунку, який її не має.