Por que nos importamos com uma barra?
No nosso próprio site, depois de cada build roda um script que verifica se cada link interno termina com uma barra final. Isso não é mania. Um endereço sem a barra recebe primeiro um redirecionamento 308 do servidor, e as ferramentas para webmasters do mecanismo de busca registram cada um desses redirecionamentos como «Página com redirecionamento» e nos avisam um por um.
Por isso, quando lemos um relato da comunidade dizendo que alguém não conseguia entrar com passkey no seu site EmDash, e que na frente do site havia justamente algo que acrescenta uma barra aos endereços, a nossa primeira reação não foi compaixão, e sim a consciência pesada: essa configuração, nós mesmos poderíamos ter adicionado sem pensar.
Então criamos um site novo com o modelo de blog (EmDash 1.4.0, adaptador Node, SQLite) e o reproduzimos.
Quando o login falha, qual passo realmente falha?
O primeiro passo do login com passkey é a página pedir ao servidor um «desafio» (challenge). A requisição vai para /_emdash/api/auth/passkey/options. O navegador só mostra o aviso de impressão digital ou chave de segurança depois que esse passo tem sucesso.
Não conseguimos fazer um script apertar um sensor de impressão digital, então testamos só esse passo, com curl, com e sem a barra final:
curl -i -X POST http://localhost:4400/_emdash/api/auth/passkey/options \
-H 'X-EmDash-Request: 1' -H 'Content-Type: application/json' -d '{}'
curl -i -X POST http://localhost:4400/_emdash/api/auth/passkey/options/ \
-H 'X-EmDash-Request: 1' -H 'Content-Type: application/json' -d '{}'
A primeira retorna 200, com um desafio e um rpId. A segunda difere só por uma barra e retorna:
{"success":false,"error":{"code":"NOT_AUTHENTICATED","message":"Not authenticated"}}
/_emdash/api/auth/mode e /_emdash/api/health se comportam do mesmo jeito: 200 sem a barra, 401 com ela.
Vale registrar um pequeno desvio. No começo chamamos passkey/options com um GET, como faria um navegador, e recebemos uma página HTML 404 inteira, e quase concluímos que o endpoint não existia. Ele só aceita POST.
Por que 401 e não 404?
Lemos o código-fonte do middleware de autenticação do EmDash. Nele há uma lista de endpoints que podem ser acessados sem login, escrita de duas formas: as entradas que terminam em / são comparadas como prefixos, e todas as outras precisam coincidir exatamente. passkey/options, passkey/verify, auth/mode e health estão todos no grupo de correspondência exata.
Se se acrescenta uma barra, o endereço deixa de ser igual a qualquer entrada da lista. O middleware então o trata como um endpoint comum que exige estar logado. E você envia essa requisição justamente porque está tentando fazer login.
A conclusão soa como um enigma, mas é assim: o primeiro passo do login é julgado como um passo para o qual é preciso já estar logado.
E se eu realmente defini trailingSlash como always?
Isso também testamos. Em astro.config.mjs acrescentamos:
export default defineConfig({
trailingSlash: "always",
// ...
});
Depois testamos o mesmo endpoint:
| Endereço requisitado | Resultado |
|---|---|
/_emdash/api/auth/passkey/options | 404 |
/_emdash/api/auth/passkey/options/ | 401 NOT_AUTHENTICATED |
Nenhum dos lados funciona. Não capturamos qual forma de endereço a página de administração realmente envia, então não podemos dizer em qual lado ela cai, mas, caia onde cair, não dá para entrar.
O que fazer agora?
Primeiro, volte trailingSlash ao valor padrão (se você não escrever nada, é ignore). Testamos com o valor padrão: as páginas abrem com ou sem a barra, e os endpoints de login funcionam.
Segundo, se a barra é acrescentada pelo seu proxy ou gateway, deixe passar sem reescrever os caminhos que começam com /_emdash/. Não testamos isso em um proxy real. Decorre do princípio acima, então verifique você mesmo.
Terceiro, sobre as versões. Testamos a 1.4.0. A correção correspondente foi incorporada ao ramo principal na comunidade, mas quando testamos a versão mais recente ainda era a 1.4.0 e não a incluía. Por isso, quando você atualizar mais tarde, não dê como certo: rode de novo os dois comandos curl acima. Leva dez segundos.
Por que o login com link mágico continua funcionando?
Aquele relato mencionava que o login com link mágico continuava normal. Olhando a lista, não é de estranhar: auth/magic-link/ é uma entrada que termina em barra, então é comparada como prefixo, e uma barra final a mais não a afeta. É uma dedução nossa a partir da lista. Não a verificamos separadamente.
Como saber se fui afetado?
Duas coisas, e as duas precisam valer:
- O login com passkey responde
Not authenticated, enquanto o login com link mágico funciona. - No teste curl acima, o endereço com barra retorna
401e o sem barra retorna200.
Se no segundo ponto os dois retornam 200, você tem outro problema, e este artigo não vai ajudar.