SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-10-22

Imposto do SSO: OIDC e SAML em planos pagos

Veja por que apps open source cobram por OIDC e SAML, quais custos operacionais isso cria e o checklist para avaliar o SSO antes de instalar.

O que é o imposto do SSO

O imposto do SSO em software autoalojado é o padrão em que a aplicação é gratuita, mas o início de sessão único (SSO) é a única funcionalidade que tem de comprar. Pode executar tudo no seu próprio VPS, sem uma chave de licença e sem limite de utilizadores. Depois, abre a página de autenticação na documentação e encontra OpenID Connect (OIDC) ou SAML (security assertion markup language) incluído num plano pago.

Isto é mais importante do que uma funcionalidade comum bloqueada por pagamento, porque o SSO é o que faz um conjunto de serviços autoalojados comportar-se como um único sistema. Um fornecedor de identidade (IdP) fornece uma conta por pessoa, uma política de palavras-passe, um único local para ativar a autenticação multifator (MFA) e um único local para desativar o acesso de alguém. Sem isso, cada aplicação mantém a sua própria pequena base de dados de utilizadores, e tem de gerir cada uma manualmente.

Este padrão é suficientemente antigo para ter um registo público. O SSO Wall of Shame em sso.tax lista fornecedores que cobram um prémio elevado pelo início de sessão único, com entradas desde 2018, e o seu autor define um critério razoável: "Se o suporte para SSO aumentar o preço em 10%, não está nesta lista." A maior parte dessa lista é composta por software fechado. A mesma lógica de preços surge agora em projetos de código aberto que aloja por conta própria.

Por que os mantenedores colocam o início de sessão único atrás de um plano pago

Há duas razões, e ambas são legítimas. O SSO é caro de suportar e é uma das poucas funcionalidades pelas quais uma organização de grande dimensão está disposta a pagar.

O custo do suporte é real porque uma integração com um IdP nunca fica concluída. Cada IdP formata as suas claims de forma ligeiramente diferente. O mapeamento de grupos, a duração da sessão, os URLs de redirecionamento e a diferença de relógio podem causar problemas de início de sessão. Um problema de início de sessão bloqueia todos os utilizadores ao mesmo tempo, por isso esses pedidos de suporte são urgentes. Depois surgem os pedidos adicionais: grupos aninhados, mapeamento de funções, provisionamento automático com SCIM (system for cross-domain identity management) e logs de auditoria que uma equipa de conformidade irá consultar.

A questão da receita é aritmética, não malícia. Uma empresa que não consiga ligar a aplicação ao seu próprio IdP não a irá implementar. Por isso, o SSO estabelece uma separação clara entre o utilizador que paga e o utilizador que não paga. Um projeto open core tem de colocar essa separação em algum ponto. O SSO adapta-se a esse modelo melhor do que quase qualquer outra funcionalidade, e é por isso que tantos projetos o escolhem.

Uma correção à reclamação habitual: consulte o changelog antes de assumir que uma funcionalidade foi retirada, porque uma remoção aparece nas notas de versão. Na maioria dos projetos que analisei para este artigo, as funcionalidades de SSO pago foram desenvolvidas para o plano pago desde o início. O Planka é a exceção. A sua edição Community gratuita incluía OIDC funcional até à versão 2.2.0, lançada em 9 August 2026, cujas notas de versão dizem "OIDC/SSO has been removed from PLANKA Community." A funcionalidade está agora no Planka Pro, e a explicação dos próprios mantenedores confirma o ponto: "The fact that it ended up in Community never fit that model." O Grafana é típico dos restantes. A sua página sobre SAML inclui uma nota de uma linha, "Available in Grafana Enterprise and Grafana Cloud", enquanto o OAuth genérico contra o seu próprio issuer funciona na compilação open source.

O que o imposto do SSO realmente lhe custa

O dinheiro é a parte menor. A maioria dos níveis pagos é vendida por utilizador, por isso a fatura cresce com a equipa, enquanto o alojamento e as atualizações continuam a ser da sua responsabilidade. O n8n é uma exceção: a página de preços indica que todos os planos incluem utilizadores ilimitados e que a cobrança é feita pelo número mensal de execuções de workflows.

O custo maior é o trabalho manual de gestão de identidades, que surge em quatro áreas.

  • Um armazenamento de palavras-passe por aplicação, pelo que uma palavra-passe reutilizada cria uma vulnerabilidade em todas as aplicações que a partilham.
  • Remoção de acessos baseada na memória. Tem de se lembrar de todos os serviços a que uma pessoa teve acesso, e o serviço que esquecer será precisamente o mais importante.
  • MFA configurado aplicação a aplicação, quando a aplicação oferece essa funcionalidade.
  • Logins partilhados, que é o que acontece na prática em equipas pequenas sujeitas a esta pressão.

Este último ponto merece uma frase própria. Quando uma equipa partilha uma única conta de administrador num gestor de documentos, o registo de auditoria associa todas as ações ao mesmo nome, pelo que não é possível saber quem eliminou a fatura. As permissões por utilizador também deixam de funcionar, porque existe apenas um utilizador. Esse é o verdadeiro impacto do imposto do SSO: empurra as equipas pequenas para uma única conta partilhada, que é pior do que qualquer uma das alternativas.

Checklist para executar antes de adotar qualquer ferramenta

Execute esta verificação antes de docker compose up, não depois de a aplicação armazenar 400 documentos.

  1. Abra a página de autenticação na documentação e leia a nota sobre os níveis no topo. As funcionalidades pagas têm um distintivo ou uma frase de disponibilidade.
  2. Confirme que a aplicação comunica por OIDC ou SAML com o seu próprio issuer, em vez de usar uma lista fixa de fornecedores públicos.
  3. Verifique o mapeamento de funções e grupos. Criar o utilizador é metade do trabalho. Atribuir permissões manualmente em 10 aplicações é a metade mais difícil.
  4. Verifique se a aplicação aceita, num cabeçalho enviado por um proxy confiável, um nome de utilizador autenticado e se pode definir explicitamente em qual proxy confia.
  5. Leia o histórico da licença no git e verifique se os contribuidores assinam um CLA (contributor licence agreement).
  6. Verifique o processo de desativação de utilizadores. Descubra o que acontece aos tokens de API (application programming interface) e às sessões ativas quando a conta no IdP é desativada.

O item 2 é onde ocorre a maior parte das desilusões. Um botão "Iniciar sessão com Google" não é OIDC com o seu fornecedor de identidade. É uma integração fixa com um único fornecedor. O suporte real pede um URL de issuer. Tudo o resto vem da descoberta. Pode confirmar o lado do seu fornecedor com um comando.

curl -s https://id.example.com/.well-known/openid-configuration \
  | jq '.issuer, .authorization_endpoint, .token_endpoint'

Um fornecedor funcional devolve 3 URLs. Um resultado vazio ou um erro 404 normalmente significa que o caminho de descoberta está errado. Esse caminho depende do fornecedor: o Keycloak publica-o em /realms/<realm>/.well-known/openid-configuration. Se a aplicação não tiver sequer um campo para um URL de issuer, não consegue comunicar com o seu IdP, independentemente do que indique a lista de funcionalidades.

O item 6 apanha muitas pessoas semanas depois de alguém sair da organização. Desativar a conta no IdP impede novos inícios de sessão. Isso não revoga um token de API emitido anteriormente pela aplicação, porque a própria aplicação valida esse token e nunca consulta o IdP. O processo de desativação tem, portanto, 2 passos: desativar a conta no IdP e, depois, eliminar o utilizador ou os respetivos tokens dentro de cada aplicação.

O que os distintivos de nível realmente indicam

Estas informações foram verificadas na documentação de cada projeto em 11 de outubro de 2026. Comece pelas opções pagas.

O Grafana apresenta o SAML como "Available in Grafana Enterprise and Grafana Cloud", juntamente com a sincronização de equipas e o aprovisionamento SCIM. O OAuth genérico, o GitHub OAuth, o LDAP (lightweight directory access protocol) e o proxy de autenticação estão todos disponíveis na versão open source. Assim, quem aloja um serviço pequeno ainda pode iniciar sessão através do seu próprio fornecedor. A limitação paga aplica-se ao SAML, e não ao single sign-on em geral. Esta é a nuance que a expressão "SSO tax" tende a simplificar em excesso.

O Metabase é mais direto. A documentação diz: "SAML authentication is only available on Pro and Enterprise plans (both self-hosted and on Metabase Cloud)." A edição open source mantém o início de sessão por palavra-passe e o LDAP.

O Passbolt classifica a documentação de SSO como Pro e Cloud. Por isso, a edição Community não inclui esta funcionalidade. Os fornecedores documentados incluem o Keycloak e o Entra ID.

O n8n coloca todas estas funcionalidades atrás de um plano pago. A edição Community self-hosted é gratuita sob uma licença fair-code. No entanto, a documentação lista o início de sessão SAML e LDAP nos planos Business e Enterprise, e o OIDC apenas no plano Enterprise. Portanto, não existe qualquer opção gratuita de single sign-on. Esta é uma entrada na lista mais extensa de funcionalidades que a edição gratuita do n8n não inclui.

Agora, o outro lado, porque este padrão está longe de ser universal.

  • O GitLab Self-Managed apresenta "Tier: Free, Premium, Ultimate" na página de SAML. Assim, usar SAML com o seu próprio GitLab não tem custos.
  • O Paperless-ngx configura OIDC através do django-allauth com PAPERLESS_SOCIALACCOUNT_PROVIDERS, oculta o formulário de início de sessão local com PAPERLESS_DISABLE_REGULAR_LOGIN e associa claims a grupos com PAPERLESS_SOCIAL_ACCOUNT_SYNC_GROUPS.
  • O Planka já não pertence a este grupo. A edição Community incluía OIDC_ISSUER, OIDC_CLIENT_ID e OIDC_CLIENT_SECRET, usava openid profile email como scopes predefinidos e promovia administradores a partir de um role claim com OIDC_ADMIN_ROLES, até à versão 2.2.0, em 9 de agosto de 2026. Essa versão removeu o OIDC da Community e transferiu-o para o Planka Pro. As versões Community mais antigas continuam a incluí-lo, mas os responsáveis pelo projeto apenas dão suporte à versão mais recente.
  • O BookStack faz a troca com AUTH_METHOD=oidc e depois associa os grupos do fornecedor às suas próprias funções com OIDC_USER_TO_GROUPS=true e OIDC_GROUPS_CLAIM.
  • O Vaultwarden passou a incluir "support for SSO with OpenID Connect" na versão 1.35.0, em 27 de dezembro de 2025. A funcionalidade veio de um pull request de um colaborador que a tinha mantido num fork.
  • O listmonk inclui início de sessão OIDC juntamente com as suas funções de utilizador desde a versão v4.1.0, lançada em 12 de novembro de 2024.

Use estas informações quando estiver a escolher, e não depois de já ter tomado a decisão. Um quadro kanban do Planka e as outras alternativas self-hosted ao Trello não tratam a identidade da mesma forma. O mesmo acontece com BookStack, Wiki.js e Outline. O OIDC gratuito é uma funcionalidade que pode avaliar, tal como os limites de armazenamento ou os clientes móveis. Se ainda estiver a elaborar a lista, o que alojar por conta própria em 2026 é um ponto de partida razoável. Tanto o gestor de documentos Paperless-ngx como o Vaultwarden disponibilizam OIDC gratuito atualmente.

Por que um reverse proxy à frente da aplicação não é single sign-on

A solução habitual é usar autenticação encaminhada. O reverse proxy retém cada pedido, pergunta a um serviço de autenticação se este navegador tem uma sessão iniciada e só depois encaminha o pedido para a aplicação. O authentik chama a isto um proxy provider, com um modo de forward auth para uma única aplicação e outro para um domínio inteiro. O Authelia e o oauth2-proxy fazem o mesmo trabalho.

Um bloco de site do Caddy tem este aspeto, seguindo o exemplo do próprio 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
}

A capitalização dos nomes destes cabeçalhos é importante no Caddy, porque um nome diferente chega vazio. Em cada pedido que aprova, o outpost define X-authentik-username, X-authentik-email, X-authentik-groups e mais alguns.

Eis o que isto permite. Ninguém chega à aplicação sem passar primeiro pelo seu fornecedor de identidade. Assim, um formulário de início de sessão sem correções já não fica exposto à Internet, e a MFA aplica-se de uma só vez a tudo o que está atrás do proxy.

Eis o que isto não permite: estabelecer a identidade dentro da aplicação. A aplicação continua a ter as suas próprias contas e a sua própria noção de quem tem uma sessão iniciada. Se todas as pessoas passarem pelo proxy e chegarem à mesma conta de administrador partilhada, terá uma entrada protegida e uma única sessão anónima atrás dela. O log de auditoria continuará a mostrar um único nome. As permissões continuarão sem poder variar entre pessoas. Chamar SSO a esta configuração é um erro de segurança, porque o processo de remoção de acessos só é parcialmente eficaz: remover a pessoa do seu IdP fecha a entrada, mas um token de API que ela tenha criado dentro da aplicação continuará a funcionar para qualquer pessoa que consiga aceder diretamente à aplicação.

Tornando segura a autenticação por cabeçalho

Algumas aplicações aceitam um nome de utilizador enviado pelo proxy. Isto fornece uma identidade por utilizador sem SSO pago. A definição tem um nome diferente em cada projeto.

O Grafana chama-lhe auth proxy e fornece-a desativada. O nome do cabeçalho predefinido é X-WEBAUTH-USER. Pode indicar qualquer cabeçalho definido pelo proxy.

[auth.proxy]
enabled = true
header_name = X-authentik-username
header_property = username
auto_sign_up = true
whitelist = 10.0.0.5

whitelist é a linha que muitas pessoas ignoram. A documentação do Grafana explica claramente que ela impede os utilizadores de falsificarem o cabeçalho. Por isso, deve conter apenas o endereço do proxy. O Gitea tem a mesma funcionalidade com nomes diferentes e fornece uma predefinição mais segura.

[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 = 1

REVERSE_PROXY_TRUSTED_PROXIES tem o valor predefinido 127.0.0.0/8,::1/128. REVERSE_PROXY_LIMIT indica quantos proxies o Gitea pode confiar na cadeia. Definir esse limite como zero desativa totalmente o tratamento do cabeçalho.

O Paperless-ngx disponibiliza PAPERLESS_ENABLE_HTTP_REMOTE_USER com PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME. A documentação inclui o aviso que deve acompanhar todas estas definições:

Isto permite autenticar apenas adicionando um cabeçalho Remote-User: <username> a um pedido. Utilize com cuidado!

Duas regras mantêm a autenticação por cabeçalho segura. Ambas dizem respeito à acessibilidade. Primeiro, a aplicação deve estar inacessível por qualquer via que não seja o proxy. Qualquer pessoa que consiga abrir um socket para a aplicação pode enviar esse cabeçalho e assumir a identidade de qualquer utilizador. No Docker, ports: ["8000:8000"] publica em todas as interfaces. Por isso, associe-o ao endereço de loopback com ports: ["127.0.0.1:8000:8000"], ou remova a porta publicada e coloque o proxy na mesma rede Docker. Segundo, o proxy deve eliminar qualquer cópia do cabeçalho recebida do cliente. Assim, o único valor que a aplicação vê é o valor definido pelo proxy depois da autenticação.

Verifique ambos os pontos. Execute o primeiro comando a partir de uma máquina fora da sua VPS e o segundo no próprio servidor.

curl -si -H "Remote-User: admin" http://203.0.113.10:8000/ | head -n 1
ss -ltnp | grep 8000

O curl deve falhar ao estabelecer a ligação. ss deve apresentar 127.0.0.1:8000 em vez de 0.0.0.0:8000. Qualquer linha de estado, como HTTP/1.1 302 Found (normalmente um redirecionamento para a página de login), significa que a aplicação está a responder diretamente à Internet pública. Com a autenticação por cabeçalho ativada, essa exposição permite que qualquer pessoa inicie sessão como qualquer utilizador, indicando o nome desse utilizador num cabeçalho.

Quando não há SSO gratuito, decida em vez de reclamar

Quatro opções, pela ordem em que eu as tentaria.

  1. Escolha a aplicação que inclui OIDC. Quando dois projetos fazem o mesmo trabalho e um deles comunica gratuitamente com o seu fornecedor de identidade, essa é uma diferença real no custo de operação.
  2. Use forward auth de forma objetiva. Para uma ferramenta de administração com uma conta e um operador, um proxy à frente é suficiente, e a identidade de cada utilizador dentro da aplicação não traz qualquer benefício.
  3. Pague. Se a aplicação for central para o seu trabalho e o preço por utilizador for compatível com o tamanho da sua equipa, o dinheiro ajuda a manter o projeto, e a alternativa é pagar com as suas noites.
  4. Contacte o projeto upstream depois de pesquisar o issue tracker. O suporte de OIDC do Vaultwarden surgiu através de um fork de um contribuidor e de um pull request que se manteve aberto durante muito tempo. Por isso, um pedido de funcionalidade acompanhado de uma implementação funcional pode, por vezes, chegar à edição gratuita.

Nada disto funciona sem um fornecedor de identidade próprio, e essa é a peça que deve construir primeiro. Executar o authentik numa VPS fornece um fornecedor de OIDC e SAML, além do outpost de forward auth usado acima. A comparação entre Keycloak, authentik e Zitadel apresenta os compromissos envolvidos caso prefira ainda não assumir esse compromisso.

Histórico da licença e motivo pelo qual está na checklist

O último item da checklist diz respeito ao futuro, porque a organização atual dos níveis é apenas um retrato momentâneo. Dois casos bem documentados mostram como a situação pode mudar rapidamente, em ambas as direções. Em 10 August 2023, a HashiCorp mudou as licenças das versões futuras de todos os seus produtos, além de várias bibliotecas, de MPL 2.0 (Mozilla Public License) para Business Source License 1.1. As suas APIs, SDKs e quase todas as outras bibliotecas continuaram sob MPL 2.0. A Redis mudou para SSPL (server side public license) em March 2024 e anunciou depois, em 1 May 2025, que o Redis 8 também é distribuído sob AGPLv3 (GNU Affero General Public License).

Interprete ambos como evidência sobre o mecanismo, não sobre a motivação. A licença que lê hoje aplica-se à versão que instala hoje. Um projeto que detenha todos os direitos de autor pode alterar por si próprio os termos da próxima versão. Por isso, a pergunta sobre o CLA está na checklist: a cessão ampla dos direitos de autor é o que torna possível uma relicenciação unilateral.

Verifique por si próprio o histórico de um projeto antes de criar dependências sobre ele.

git clone --filter=blob:none https://github.com/paperless-ngx/paperless-ngx.git
cd paperless-ngx
git log --follow --oneline -- LICENSE

Uma lista curta de commits, sobretudo os do primeiro import, é um bom sinal. Várias reescritas do ficheiro de licença significam que deve ler a mensagem de cada commit antes de basear os seus planos nos termos atuais.

FAQ

O que é o imposto do SSO?

O imposto do SSO é a prática de cobrar pelo single sign-on como funcionalidade premium, enquanto o resto do produto é gratuito ou barato. Em software self-hosted, isto aparece como uma aplicação open source que pode ser executada sem uma chave de licença, mas em que o início de sessão OIDC ou SAML está incluído num escalão pago. O nome vem do SSO Wall of Shame em sso.tax, que regista fornecedores que cobram um valor adicional elevado por esta funcionalidade. Para quem aloja o próprio software, a consequência é que cada aplicação mantém a sua própria base de dados de utilizadores. As contas têm de ser criadas e removidas manualmente.

Um reverse proxy com forward auth é o mesmo que SSO?

Não. O forward auth protege a entrada: o proxy consulta o fornecedor de identidade antes de qualquer pedido chegar à aplicação. A aplicação continua a usar as suas próprias contas. Assim, se todos entrarem com um único login partilhado, obtém uma única sessão anónima e um log de auditoria com um só nome. A identidade individual só é efetiva quando a aplicação lê o nome de utilizador a partir de um cabeçalho. O proxy de autenticação do Grafana, a autenticação por reverse proxy do Gitea e o PAPERLESS_ENABLE_HTTP_REMOTE_USER do Paperless-ngx conseguem fazer isso. Estas definições só são seguras enquanto a aplicação não puder ser acedida sem passar pelo proxy, porque o cabeçalho é uma cadeia de texto simples que qualquer cliente pode enviar.

Que aplicações self-hosted incluem OIDC na edição gratuita?

Verificado na documentação dos projetos em 11 October 2026: Paperless-ngx, BookStack, Gitea, listmonk e Vaultwarden suportam OIDC nas suas versões gratuitas. O GitLab Self-Managed inclui SAML no Tier: Free. O Planka suportava OIDC até à versão 2.2.0, em August 2026. Nessa versão, o OIDC passou da edição Community para o Planka Pro. A versão open source do Grafana suporta OAuth genérico através do seu próprio issuer. O SAML no Grafana é uma funcionalidade Enterprise. Confirme a informação na página de autenticação do próprio projeto antes de instalar. Estas listas mudam com os releases.

Devo pagar pelo escalão que desbloqueia o single sign-on?

Tome a decisão com base em dois números: quantas pessoas precisam de contas e quantas aplicações teria de gerir manualmente. Para um ou dois administradores, o forward auth à frente de uma conta local é suficiente. Nesse caso, o escalão pago oferece pouco. Numa equipa em que as pessoas entram e saem, uma conta que não seja removida durante o offboarding pode custar mais do que a licença. O pagamento financia a manutenção de que depende. Se o preço não for adequado, a opção prática é escolher uma aplicação que inclua OIDC, em vez de contornar as limitações de uma aplicação que não o inclui.

Este artigo foi útil?