Casdoor vs. Keycloak
Keycloak e Casdoor são ambos provedores de identidade open-source, auto-hospedados, sob a licença Apache-2.0. Ambos falam OAuth 2.0, OpenID Connect e SAML, e ambos podem ficar na frente de LDAP ou Active Directory. Eles diferem principalmente em como são construídos e como você os opera e personaliza.
Resumo
| Casdoor | Keycloak | |
|---|---|---|
| Backend | Go, single binary | Java on Quarkus |
| Admin and login UI | React, configured in the web console | Admin console plus FreeMarker or React-based themes packaged as files |
| Tenancy | Organizations, with applications shared or scoped per organization | Realms, plus Organizations inside a realm |
| Protocols served | OAuth 2.0, OIDC, SAML, CAS, LDAP, RADIUS, SCIM, WebAuthn, Kerberos | OAuth 2.0, OIDC, SAML, WebAuthn, Kerberos; LDAP and AD as user federation |
| Social and enterprise sign-in | More than 70 built-in providers, including WeChat, DingTalk, Lark, Alipay | A smaller built-in set; others through generic OIDC/SAML or community extensions |
| Extending | REST API, webhooks, SDKs in 10+ languages | Java Service Provider Interfaces (SPIs) deployed into the server |
| Autorização | Casbin models (ACL, RBAC, ABAC) | Authorization Services (UMA 2.0, policies) |
| AI agents and MCP | Built-in MCP server; OAuth 2.1 authorization server for MCP | Standard OAuth; no built-in MCP server |
| Governance | Casdoor community, commercial support from Casbin | CNCF project, commercial support from Red Hat |
Arquitetura e operações
O Keycloak é uma aplicação Java construída sobre Quarkus. É maduro e escala bem, e espera ajustes de JVM, uma etapa de build quando você altera provedores ou recursos, e caches Infinispan quando você executa um cluster.
O Casdoor é um backend Go que serve um frontend React. Ele inicia como um único processo, mantém seu estado em um banco de dados SQL e suporta MySQL, MariaDB, PostgreSQL, SQL Server, Oracle, SQLite, TiDB e CockroachDB. Para um teste, você pode executar tudo com um único comando:
docker run -p 8000:8000 casbin/casdoor-all-in-one
Veja Server installation e Kubernetes deployment para configurações de produção.
Personalizando a experiência de login
No Keycloak, alterar a aparência das páginas de login significa escrever um tema (templates FreeMarker ou um tema baseado em React), empacotá-lo e implantá-lo no servidor.
No Casdoor, cada application tem suas próprias páginas de sign-in e sign-up que você edita no console de administração: quais campos aparecem, quais provedores são oferecidos, o layout, o fundo e CSS ou HTML personalizados. Veja UI customization e Sign-up items. Nada é redeployed.
Se você precisar de comportamento que o servidor não oferece, a resposta do Keycloak é um SPI Java rodando dentro do servidor. A resposta do Casdoor é chamar sua REST API ou reagir a webhooks do seu próprio serviço, em qualquer linguagem.
Protocolos
Ambos os produtos cobrem OAuth 2.0, OIDC e SAML como provedor de identidade e como service provider. As diferenças estão nas bordas:
- CAS: O Casdoor é um CAS server nativo. O Keycloak precisa de uma extensão da comunidade.
- LDAP e RADIUS: O Casdoor pode atuar como um LDAP server e um RADIUS server, para que aplicações legadas, VPNs e dispositivos de rede possam autenticar contra ele. O Keycloak consome diretórios LDAP, mas não serve LDAP ou RADIUS.
- Perfis avançados de OAuth: ambos suportam device authorization grant, token exchange e DPoP. O Keycloak também cobre UMA 2.0, FAPI e pushed authorization requests (PAR); se você depende deles, o Keycloak é a escolha mais segura.
Agentes de IA e MCP
O Casdoor trata agentes como clientes de primeira classe:
- A API de gerenciamento do Casdoor está disponível como um MCP server, então Claude, Cursor ou ChatGPT podem gerenciar usuários e aplicações com tokens escopados.
- Casdoor é um servidor de autorização OAuth 2.1 para seus próprios servidores MCP: metadados do servidor de autorização, Registro Dinâmico de Clientes, PKCE e indicadores de recursos são nativos.
Keycloak pode emitir tokens para clientes MCP via OAuth padrão e suporta o Registro Dinâmico de Clientes, mas as partes específicas de MCP ficam a seu cargo montar.
Autorização
O modelo de Authorization Services do Keycloak gerencia recursos, escopos, políticas e permissões dentro do servidor e segue a UMA 2.0.
Casdoor usa Casbin. Você escolhe ou escreve um modelo (ACL, RBAC, RBAC com domínios, ABAC), gerencia políticas na interface e pode chamar a mesma API de aplicação dos seus serviços. Se suas aplicações já usam Casbin, políticas e identidade residem em um só lugar.
Migrando do Keycloak
Você não precisa fazer a troca em uma única etapa.
- Importe usuários. O sincronizador do Keycloak lê as tabelas do banco de dados do Keycloak e mapeia usuários, credenciais e grupos para o Casdoor.
- Execute lado a lado. Adicione o Keycloak ao Casdoor como um provedor SAML ou um provedor OIDC personalizado para que as sessões existentes do Keycloak continuem funcionando enquanto as aplicações são migradas.
- Mova as aplicações uma por vez. Cada aplicação só precisa de uma nova URL de emissão, ID de cliente e segredo de cliente, pois ambos os servidores falam OIDC e SAML padrão.
Quando escolher qual
Escolha Keycloak se você precisar de seus perfis avançados de OAuth, já mantiver SPIs Java ou quiser a distribuição suportada pela Red Hat.
Escolha Casdoor se quiser um serviço menor para operar, páginas de login que sua equipe possa alterar sem um deploy, servidores CAS, LDAP e RADIUS embutidos, provedores de entrada para o mercado chinês ou suporte de primeira classe para agentes de IA e MCP.
Você pode hospedar o Casdoor gratuitamente por conta própria, ou deixar que nós o executemos: o Casdoor Cloud oferece uma instância dedicada, com preço por instância em vez de por usuário.
Veja também a visão geral das comparações.