Pular para o conteúdo principal

Comparação de provedores de CAPTCHA para páginas de login: reCAPTCHA, hCaptcha, Turnstile, GeeTest e Alibaba Cloud no Casdoor

· Leitura de 9 min
Yang Luo
Casdoor Maintainer

Para a maioria das páginas de login e cadastro na internet global, o Cloudflare Turnstile é a escolha mais fácil: o plano gratuito não tem limite de desafios, e seu modo padrão mostra uma caixa de seleção apenas para visitantes arriscados. Se muitos dos seus usuários estão na China continental, use o Alibaba Cloud Captcha ou GeeTest em vez disso, pois a Cloudflare informa que o Turnstile não é suportado lá. Se você precisa que o captcha funcione sem qualquer serviço externo, use o captcha de imagem integrado do Casdoor. O Casdoor suporta todos esses, além do Google reCAPTCHA (v2 e v3) e hCaptcha, como provedores de captcha, e você escolhe quando o captcha aparece por aplicação.

Personalize a Página de Login no Casdoor: Estilização Personalizada da UI de Autenticação Sem Fork

· Leitura de 11 min
Yang Luo
Casdoor Maintainer

Sim, o Casdoor suporta estilização personalizada de sua interface de autenticação, e você não precisa fazer um fork do frontend para isso. Cada aplicação possui uma aba UI Customization onde você define o logo, favicon, imagem de fundo, CSS personalizado para desktop e mobile, a posição do formulário, um painel lateral, HTML de rodapé e um tema. Duas tabelas, Signin items e Signup items, determinam quais campos são exibidos nas páginas de login e cadastro, em qual ordem, com quais rótulos e placeholders. Tudo é armazenado por aplicação no banco de dados, permitindo que uma instância do Casdoor atenda várias páginas de login com marcas diferentes, e os administradores da organização podem editar suas próprias páginas dentro de limites seguros.

Jenkins OIDC, Gitea OIDC e Grafana SSO com o Casdoor: Um único login para uma stack DevOps auto-hospedada

· Leitura de 10 min
Yang Luo
Casdoor Maintainer

Cada ferramenta em uma típica stack DevOps auto-hospedada pode atuar como um cliente OpenID Connect: Gitea e Argo CD suportam OIDC nativamente, Jenkins faz isso através do plugin oic-auth, Grafana e Portainer através de OAuth 2.0 genérico, e MinIO, Harbor e GitLab através de suas configurações OIDC. Aponte todas elas para uma única instância do Casdoor, dê a cada ferramenta sua própria aplicação no Casdoor e coloque seus usuários em grupos do Casdoor. Cada ferramenta então lê a claim groups e decide quem é administrador. Este post lista a URL de callback, as chaves de configuração e o mapeamento de grupos para cada ferramenta, depois cobre as partes que elas compartilham.

Login OAuth com Casdoor via DingTalk, WeCom, Lark, Infoflow e WeChat

· Leitura de 12 min
Yang Luo
Casdoor Maintainer

O Casdoor possui provedores OAuth integrados para DingTalk, WeCom (WeChat Work), Lark (Feishu), Baidu Infoflow e WeChat. Você cria um aplicativo no console de desenvolvedor de cada fornecedor, cola suas credenciais em um provedor do Casdoor e adiciona o provedor à sua aplicação. O Casdoor executa o fluxo do fornecedor (escaneamento de QR code no desktop ou login dentro do próprio cliente do fornecedor), obtém o token de acesso corporativo onde o fornecedor exige um, e mapeia o ID de usuário do fornecedor para um usuário do Casdoor. Sua aplicação apenas conversa via OIDC com o Casdoor e nunca vê um cabeçalho do DingTalk, um user_ticket do WeCom ou um unionid do WeChat. Para DingTalk, WeCom e Lark, um sincronizador também pode importar todo o diretório da organização antes do primeiro login.

Provedor de E-mail para Códigos de Verificação do Casdoor: Brevo SMTP, Resend, SendGrid, ACS Email e SES

· Leitura de 11 min
Yang Luo
Casdoor Maintainer

O Casdoor envia códigos de verificação de cadastro, links de redefinição de senha e magic links através de um provedor de e-mail (Email provider). Ele possui tipos de API nativos para Resend, SendGrid e Azure Communication Services (ACS) Email, um tipo Default SMTP que funciona com qualquer relay SMTP (seu próprio servidor, Google Workspace, Microsoft 365, Brevo, Amazon SES) e um tipo Custom HTTP Email para qualquer outra API HTTP. Se você deseja um nível gratuito e uma configuração rápida, comece com Resend ou Brevo. Se você já opera na AWS ou Azure, SES ou ACS mantém a cobrança em um só lugar. Independentemente da escolha, o trabalho de entregabilidade é o mesmo: um domínio remetente com SPF e DKIM alinhados ao endereço From.

Como hospedar arquivos estáticos em um CDN com o Casdoor: S3, MinIO, Azure Blob e outros provedores de armazenamento

· Leitura de 11 min
Yang Luo
Casdoor Maintainer

Para hospedar arquivos estáticos em um CDN, coloque-os no armazenamento de objetos (Amazon S3, MinIO, Azure Blob Storage, Google Cloud Storage, Alibaba Cloud OSS ou Tencent Cloud COS), faça o CDN buscar desse bucket como sua origem e distribua URLs no domínio do CDN. No Casdoor, isso é uma única configuração: crie um provedor de armazenamento para o bucket e coloque o endereço do CDN no campo Domain. O Casdoor envia avatares e outros arquivos por meio da API do provedor e salva URLs que começam com esse domínio. O frontend do próprio Casdoor também pode vir de um CDN, por meio de frontendCdnUrl e staticBaseUrl em app.conf.

MailHog vs Mailpit: Testando E-mails de Verificação e Redefinição de Senha com Casdoor

· Leitura de 10 min
Yang Luo
Casdoor Maintainer

MailHog e Mailpit são ambos servidores SMTP falsos para desenvolvimento: eles aceitam toda mensagem, mantêm-na e mostram-na em uma interface web em vez de entregá-la. Ambos usam as mesmas portas padrão, SMTP na 1025 e a interface web e API na 8025, então o endereço SMTP é smtp://127.0.0.1:1025 e a caixa de entrada está em http://127.0.0.1:8025 para qualquer um deles. A diferença é a manutenção: a última versão do MailHog, v1.0.1, foi lançada em agosto de 2020, enquanto o Mailpit lançou a v1.33.0 em 31 de outubro de 2026. Para um novo projeto, use o Mailpit. O Casdoor envia para ambos através de um provedor SMTP simples, permitindo testar códigos de cadastro, e-mails de redefinição de senha e links mágicos sem uma conta de e-mail real.

URIs de Redirecionamento OAuth MCP para Cursor, Claude e ChatGPT: Registrando Clientes MCP no Casdoor

· Leitura de 9 min
Yang Luo
Casdoor Maintainer

Todo cliente MCP envia sua própria URI de redirecionamento ao fazer login em um servidor MCP protegido por OAuth. O Cursor desktop usa http://localhost:8787/callback (versões anteriores a meados de 2026 usavam cursor://anysphere.cursor-mcp/oauth/callback), o Cursor na web e os Agentes Cloud do Cursor usam https://www.cursor.com/agents/mcp/oauth/callback, claude.ai, conectores do Claude Desktop, Claude mobile e Cowork usam https://claude.ai/api/mcp/auth_callback, e o ChatGPT usa https://chatgpt.com/connector_platform_oauth_redirect ou um https://chatgpt.com/connector/oauth/<callback-id> por conexão. Se você ativar o registro dinâmico de clientes no Casdoor, não precisará inserir nenhum destes: os clientes se registram sozinhos ou fornecem ao Casdoor um documento de metadados do ID do cliente. Você os adiciona a Redirect URLs somente quando cria uma aplicação Casdoor para um cliente manualmente.

Autenticação CAS e SSO no Nginx: Protegendo Qualquer Aplicativo Atrás do Nginx com Casdoor

· Leitura de 12 min
Yang Luo
Casdoor Maintainer

O nginx open-source não possui um módulo CAS, então "autenticação CAS no nginx" na prática significa uma das duas configurações. Ou o nginx consulta um serviço de autenticação sobre cada solicitação através de seu módulo auth_request, e o Casdoor responde (diretamente em /api/forward-auth, ou através de casdoor-forward-auth ou OAuth2 Proxy), ou o aplicativo atrás do nginx é ele próprio um cliente CAS e conversa com os endpoints do servidor CAS do Casdoor. Se você puder recompilar o nginx, o módulo nginx do Casdoor executa o login dentro do nginx, e se você preferir não executar o nginx, o proxy de site do Casdoor pode ficar na frente do aplicativo. Em todos os casos, a página de login é a do Casdoor, então uma sessão SSO, um conjunto de permissões e uma política MFA cobrem todos os aplicativos.

Logout Iniciado pelo RP e Logout SSO no OpenID Connect: Como o Casdoor Desconecta Usuários

· Leitura de 12 min
Yang Luo
Casdoor Maintainer

Desconectar um usuário de um aplicativo OpenID Connect exige mais do que apenas excluir seu próprio cookie de sessão. O usuário ainda está conectado ao provedor de identidade, então o próximo clique em "Sign in" passa direto sem senha, e os outros aplicativos que compartilham essa sessão do provedor de identidade permanecem conectados também. Um logout adequado tem três partes: limpar a sessão local do seu aplicativo, enviar o navegador para o end_session_endpoint do provedor (logout iniciado pelo RP) para que a sessão do provedor seja encerrada e permitir que o provedor informe os outros aplicativos através do logout back-channel. No Casdoor, o endpoint de fim de sessão é /api/logout, o logout back-channel é configurado por aplicação e os refresh tokens podem ser revogados em /api/login/oauth/revoke.