自架軟體的 SSO 稅:安裝前必看的檢查清單
許多開放原始碼應用程式將 OIDC 與 SAML 放入付費方案。了解維護者的定價理由,並在安裝前確認支援、IdP 相容性與替代方案。
SSO 稅是什麼
自架軟體中的 SSO 稅,是指應用程式本身免費,但必須購買單一登入(SSO)才能使用。您可以在自己的 VPS 上執行完整系統,不需要授權金鑰,也不受席次數量限制。接著,您在文件中開啟驗證頁面,卻發現 OpenID Connect (OIDC) 或 SAML(security assertion markup language)被列在付費方案中。
這比一般的付費功能更值得注意,因為 SSO 能讓一組自架服務以單一系統的方式運作。身分識別提供者(IdP)可為每位使用者提供一個帳號、一套密碼政策、一個啟用多重要素驗證(MFA)的位置,以及一個停用使用者的位置。沒有 SSO 時,每個應用程式都會維護自己的小型使用者資料庫,而您必須逐一手動管理。
這種模式早已存在,甚至有公開的評比名單。sso.tax 上的 SSO Wall of Shame(https://sso.tax/)列出對單一登入收取高額溢價的供應商,最早的項目可追溯至 2018 年。其作者設定了合理的標準:「如果您的 SSO 支援只讓價格提高 10%,就不會列入這份名單。」名單中的大多數是閉源軟體。如今,採用相同定價邏輯的情況,也出現在由您自行託管的開放原始碼專案中。
維護者將單一登入放在付費方案的原因
原因有兩個,而且都很實際。SSO 的支援成本很高,也是大型組織少數願意付費的功能之一。
支援成本確實存在,因為身分整合永遠不會真正完成。每個 IdP 的 claims 格式都有些差異。群組對應、工作階段存留時間、重新導向 URL 與時鐘偏差,都可能造成登入錯誤。登入錯誤會同時阻擋所有使用者,因此相關工單都很緊急。接著還會出現後續需求,例如巢狀群組、角色對應、使用 SCIM(system for cross-domain identity management)自動佈建,以及合規團隊會檢視的稽核日誌。
營收方面只是算術問題,而不是惡意行為。無法將應用程式連接到自有 IdP 的公司,根本不會部署它。因此,SSO 很清楚地劃分了付費使用者與非付費使用者。採用 open core 模式的專案必須在某處劃出這條界線。SSO 比幾乎任何其他功能都更適合放在這條界線上,這就是許多專案選擇它的原因。
對常見抱怨有一點需要更正:不要直接假設某項功能遭到移除,請先查看變更日誌,因為移除功能會出現在版本說明中。我檢查本文提到的大多數專案後發現,付費 SSO 功能從一開始就是為付費方案打造的。Planka 是例外。其免費 Community 版本一直提供可運作的 OIDC,直到 2.2.0 版本;該版本於 9 August 2026 發布,版本說明寫著「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」,但在 open source 版本中,針對自有 issuer 的一般 OAuth 仍可使用。
SSO 稅實際上讓你付出多少
金錢成本反而較小。多數付費方案按使用者數量計費,因此團隊擴大時帳單也會增加,而主機代管與升級仍由你負責。n8n 是例外之一:其定價頁面表示所有方案都包含不限使用者數量,改以每月工作流程執行次數計費。
較大的成本是手動處理身分管理,而且會出現在4個方面。
- 每個應用程式各自使用一個密碼儲存庫,因此只要重複使用一組密碼,所有共用該密碼的應用程式都會出現安全漏洞。
- 憑記憶執行離職處理。你必須記住某人使用過的每項服務,而遺漏的那項往往就是關鍵。
- 逐一在各應用程式中設定 MFA,而且前提是該應用程式支援 MFA。
- 共用登入帳號。小型團隊承受這種壓力時,實際上往往會採用這種做法。
最後一點值得另外說明。當團隊在文件管理器中共用一個管理員帳號時,稽核軌跡會將所有操作記錄在同一個名稱下,因此你無法判斷是誰刪除了發票。每位使用者的權限也會失效,因為實際上只有一個使用者。這就是 SSO 稅造成的真正損害:它會把小型團隊推向共用單一帳號,而這比其他任何替代方案都更糟。
採用前應執行的檢查清單
請在 docker compose up 前執行這些檢查,不要等到應用程式已經保存 400 份文件後才處理。
- 開啟文件中的驗證頁面,閱讀頂端的方案說明。付費功能通常會有標章或一行可用性說明。
- 確認應用程式能透過 OIDC 或 SAML 連線到您自己的 issuer,而不是只能連線到固定的公開供應商清單。
- 檢查角色與群組對應。建立使用者只完成一半工作,另一半是處理權限;若要在 10 個應用程式中手動設定,這部分最容易造成負擔。
- 檢查應用程式是否接受受信任 proxy 在標頭中傳入的已驗證使用者名稱,以及是否能鎖定它所信任的 proxy。
- 閱讀 git 中的授權條款歷程,並確認貢獻者是否簽署 CLA (contributor licence agreement)。
- 檢查離職處理流程。確認 IdP 帳戶停用後,API (application programming interface) token 與現有工作階段會如何處理。
第 2 項最容易造成失望。Sign in with Google 按鈕不代表應用程式能透過您的 identity provider 使用 OIDC;它只是與單一供應商的固定整合。真正的支援會要求您提供 issuer URL,其餘資訊則透過 discovery 取得。您可以使用一個命令確認供應商端是否正確。
curl -s https://id.example.com/.well-known/openid-configuration \
| jq '.issuer, .authorization_endpoint, .token_endpoint'正常的供應商會回傳 3 個 URL。空白結果或 404 通常表示 discovery 路徑錯誤,而該路徑取決於供應商:Keycloak 會在 /realms/<realm>/.well-known/openid-configuration 發布這項資訊。如果應用程式完全沒有 issuer URL 欄位,無論功能清單如何描述,它都無法連線到您的 IdP。
第 6 項通常會在有人離職數週後才被注意到。在 IdP 中停用帳戶會阻止新的登入,但不會撤銷應用程式先前核發的 API token,因為應用程式會自行驗證該 token,且不會向 IdP 查詢。因此,離職處理包含兩個步驟:先在 IdP 中停用帳戶,再在每個應用程式內刪除使用者或其 token。
層級徽章實際代表的內容
這些資訊已於 11 October 2026 對照各專案自己的文件確認。先看付費方案。
Grafana 將 SAML 標示為「Available in Grafana Enterprise and Grafana Cloud」,並提供團隊同步與 SCIM provisioning。Generic OAuth、GitHub OAuth、LDAP(lightweight directory access protocol)及 auth proxy 都包含在 open source build 中,因此小型自架環境仍可透過自己的 provider 登入。付費功能的分界在 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 edition 仍提供密碼登入與 LDAP。
Passbolt 將 SSO 文件標示為 Pro 和 Cloud,因此 community edition 不提供這項功能。文件列出的 provider 包括 Keycloak 與 Entra ID。
n8n 則將所有功能都限制在付費方案。self-hosted community edition 依 fair-code licence 免費提供,但文件將 SAML 與 LDAP 登入列在 Business 和 Enterprise plans,OIDC 則僅列在 Enterprise,因此完全沒有免費的 single sign-on 途徑。這也是免費 n8n edition 所缺少的功能清單中的一項。
接著看另一邊,因為這種模式並不普遍。
- GitLab Self-Managed 的 SAML 頁面標示「Tier: Free, Premium, Ultimate」,因此使用自有 GitLab 進行 SAML 驗證不需付費。
- Paperless-ngx 透過 django-allauth 搭配
PAPERLESS_SOCIALACCOUNT_PROVIDERS設定 OIDC,使用PAPERLESS_DISABLE_REGULAR_LOGIN隱藏本機登入表單,並透過PAPERLESS_SOCIAL_ACCOUNT_SYNC_GROUPS將 claims 對應至群組。 - Planka 已不再屬於這一邊。其 Community edition 曾使用
OIDC_ISSUER、OIDC_CLIENT_ID與OIDC_CLIENT_SECRET,將 scopes 預設為openid profile email,並透過 role claim 使用OIDC_ADMIN_ROLES提升管理員權限;直到 version 2.2.0 在 9 August 2026 從 Community 移除 OIDC,改列為 Planka Pro。較舊的 Community releases 仍保留這項功能,但維護者只支援最新版本。 - BookStack 使用
AUTH_METHOD=oidc切換至該功能,接著透過OIDC_USER_TO_GROUPS=true與OIDC_GROUPS_CLAIM將 provider groups 對應至自身的 roles。 - Vaultwarden 在 1.35.0 中加入「support for SSO with OpenID Connect」,該版本於 27 December 2025 發布。這項功能來自一名 contributor 的 pull request;該 contributor 先前已在 fork 中維護這項功能。
- listmonk 自 v4.1.0 起便提供 OIDC 登入與 user roles;該版本於 12 November 2024 發布。
請在做出選擇前使用這些資訊,而不是決定後才查看。Planka kanban board 與其他self-hosted Trello alternatives 對 identity 的處理方式並不相同,BookStack、Wiki.js 與 Outline 也是如此。免費 OIDC 是可以與儲存空間限制或 mobile clients 一樣納入評估的功能。如果你仍在整理清單,2026 年適合自架的服務是合理的起點,而Paperless-ngx 文件管理器與Vaultwarden目前都提供免費 OIDC。
為什麼應用程式前的反向代理不等於單一登入
常見的替代做法是 forward auth。反向代理會暫停處理每個請求,詢問驗證服務此瀏覽器是否已登入,確認後才將請求傳給應用程式。authentik 將此功能稱為 proxy provider,提供適用於單一應用程式的 forward auth 模式,以及適用於整個網域的另一種模式。Authelia 和 oauth2-proxy 也能執行相同工作。
以下是依照 authentik 官方範例撰寫的 Caddy site block。
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 及其他幾個標頭。
這樣做可以帶來以下效果。任何人都必須先通過你的身分識別提供者,才能連到應用程式。因此,未修補的登入表單不再直接暴露於網際網路,MFA 也會一次套用到反向代理後方的所有服務。
但這樣做無法提供應用程式內的身分識別。應用程式仍有自己的帳號,也有自己判定登入者的方式。如果所有人都通過反向代理,最後使用同一個共用管理員帳號登入,你得到的是一道強固的入口,以及後方的一個匿名工作階段。稽核日誌仍只會顯示同一個名稱。不同使用者之間仍無法套用不同權限。將這種架構稱為 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"] 會繫結所有網路介面,因此請使用 ports: ["127.0.0.1:8000:8000"] 將其繫結至 loopback 位址;或者移除公開的連接埠,讓代理伺服器與應用程式位於同一個 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 時,請做決定,不要只抱怨
以下列出 4 個選項,順序是我會採用的優先順序。
- 選擇內建 OIDC 的應用程式。如果兩個專案功能相同,而其中一個能免費連接你的身分識別提供者,這就是實際的執行成本差異。
- 誠實使用 forward auth。對只有一個帳戶和一名操作人員的管理工具而言,前方的代理已經足夠;應用程式內的個別使用者身分不會帶來實質效益。
- 付費。如果應用程式是工作流程的核心,且按席次計費的價格符合團隊規模,這筆費用能維持專案持續維護;否則替代方案就是耗費你晚上的時間。
- 先搜尋 issue tracker,再向上游提出要求。Vaultwarden 的 OIDC 支援來自貢獻者的 fork 和長期維護的 pull request,因此,若功能請求後面有可運作的實作,有時確實能進入免費版本。
如果沒有自己的身分識別提供者,上述方法都無法運作;因此應先建立這個元件。在 VPS 上執行 authentik 會提供 OIDC 與 SAML provider,以及前文使用的 forward auth outpost;Keycloak、authentik 與 Zitadel 的比較 則說明各方案之間的取捨,供你在尚未決定前參考。
授權歷史,以及它列入檢查清單的原因
最後一項檢查清單著眼於未來,因為今天的分層配置只是某個時間點的狀態。兩個有完整文件記錄的案例顯示,情況可能迅速朝不同方向發展。2023 年 8 月 10 日,HashiCorp 將其所有產品的後續版本及數個函式庫,從 MPL 2.0(Mozilla Public License)改為 Business Source License 1.1;其 API、SDK 和幾乎所有其他函式庫則仍採用 MPL 2.0。Redis 於 2024 年 3 月改用 SSPL(server side public license),之後在 2025 年 5 月 1 日宣布,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 稅?
SSO 稅是指將單一登入(single sign-on)列為付費進階功能,而產品其餘部分免費或價格低廉的做法。在自架軟體中,常見形式是可以不使用 license key 執行的開放原始碼應用程式,卻將 OIDC 或 SAML 登入功能放在付費方案中。這個名稱源自 sso.tax 的 SSO Wall of Shame,該網站追蹤對此功能收取高額溢價的供應商。對自架使用者而言,結果是每個應用程式都維護自己的使用者資料庫,因此必須手動建立和刪除帳戶。
使用 forward auth 的反向代理等同於 SSO 嗎?
不等同。Forward auth 保護的是入口:代理會先向身分提供者確認,再讓請求到達應用程式。後方的應用程式仍使用自己的帳戶,因此如果所有人都進入同一個共用登入,得到的只是一個匿名工作階段,稽核日誌中也只會顯示同一個名稱。只有在應用程式讀取標頭中的使用者名稱時,才算是真正的個別使用者身分;Grafana 的 auth proxy、Gitea 的 reverse proxy authentication,以及 Paperless-ngx 的 PAPERLESS_ENABLE_HTTP_REMOTE_USER 都能做到這點。只有在應用程式無法繞過代理直接連線時,這些設定才安全,因為標頭只是純文字字串,任何用戶端都能自行傳送。
哪些自架應用程式在免費版本中包含 OIDC?
截至 11 October 2026,根據各專案文件確認:Paperless-ngx、BookStack、Gitea、listmonk 和 Vaultwarden 的免費版本都支援 OIDC,GitLab Self-Managed 則將 SAML 列在 Tier: Free。Planka 在 2026 年 8 月的 version 2.2.0 前仍提供 OIDC,之後將 OIDC 從 Community edition 移至 Planka Pro。Grafana 的開放原始碼版本可針對自己的 issuer 使用一般 OAuth,而 SAML 在 Grafana 中屬於 Enterprise 功能。安裝前請確認專案本身的 authentication 頁面,因為這些清單會隨版本發布而變更。
我應該付費購買解鎖單一登入的方案嗎?
用兩個數字來決定:需要帳戶的人數,以及若不使用單一登入,必須手動維護的應用程式數量。對一或兩位管理員而言,在本機帳戶前方使用 forward auth 已經足夠,付費方案能提供的價值不高。對成員會加入和離開的團隊而言,離職時漏刪一個帳戶所造成的成本可能高於 license fee,而這筆費用也支援你所依賴的維護工作。如果價格不合適,實際做法是選擇內建 OIDC 的應用程式,而不是設法繞過不支援 OIDC 的應用程式。