우리가 슬래시 하나에 신경 쓰는 이유
우리 사이트는 빌드가 끝나면 모든 내부 링크가 끝에 슬래시를 붙였는지 검사하는 스크립트를 실행합니다. 결벽 때문이 아닙니다. 슬래시 없는 주소는 서버가 먼저 308 리디렉션을 한 번 거치게 하고, 검색엔진의 웹마스터 도구는 이런 리디렉션을 전부 “리디렉션이 포함된 페이지”로 기록해 하나하나 보고해 오기 때문입니다.
그래서 EmDash 사이트에서 패스키 로그인이 되지 않는다는 커뮤니티 제보를 읽었고, 그 사이트 앞단에 주소에 슬래시를 붙여 주는 무언가가 있었다는 것을 알았을 때, 가장 먼저 든 마음은 동정이 아니라 찔림이었습니다. 이런 설정은 우리도 별생각 없이 넣을 수 있기 때문입니다.
그래서 새로 블로그 템플릿 사이트(EmDash 1.4.0, Node 어댑터, SQLite)를 만들어 재현해 보았습니다.
로그인이 실패할 때, 실제로는 어느 단계가 실패하는가?
패스키 로그인의 첫 단계는 페이지가 서버에 “챌린지”를 요청하는 것입니다. 요청 주소는 /_emdash/api/auth/passkey/options입니다. 브라우저에 지문이나 보안 키 확인 창이 뜨는 것은 이 단계가 성공한 뒤입니다.
스크립트가 지문 센서를 대신 눌러 줄 수는 없으므로, 이 단계만 curl로, 슬래시가 있을 때와 없을 때를 각각 테스트했습니다.
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 '{}'
첫 번째는 200을 반환하고, 안에는 챌린지와 rpId가 들어 있습니다. 두 번째는 슬래시 하나만 더 붙었을 뿐인데 다음과 같이 반환됩니다.
{"success":false,"error":{"code":"NOT_AUTHENTICATED","message":"Not authenticated"}}
/_emdash/api/auth/mode와 /_emdash/api/health도 마찬가지입니다. 슬래시가 없으면 200, 있으면 401입니다.
작은 에피소드도 하나 적어 둡니다. 처음에는 passkey/options에 브라우저처럼 GET으로 접근했는데, HTML 404 페이지가 통째로 돌아와서 이 엔드포인트가 없는 줄 알 뻔했습니다. 이 엔드포인트는 POST만 받습니다.
왜 404가 아니라 401일까?
EmDash 인증 미들웨어의 소스를 읽어 보았습니다. 그 안에는 “로그인하지 않아도 접근할 수 있는 엔드포인트” 목록이 있고, 표기 방식은 두 가지입니다. /로 끝나는 항목은 접두사로 일치시키고, 나머지는 문자열 전체를 정확히 일치시킵니다. passkey/options, passkey/verify, auth/mode, health는 모두 정확 일치 쪽에 적혀 있습니다.
주소에 슬래시가 하나 더 붙으면 목록의 어느 항목과도 같지 않게 됩니다. 그러면 미들웨어는 이를 로그인이 필요한 평범한 엔드포인트로 처리합니다. 그런데 지금 이 요청을 보내는 이유가 바로 로그인하기 위해서입니다.
결론은 수수께끼처럼 들리지만 사실이 그렇습니다. 로그인의 첫 단계가 먼저 로그인되어 있어야 한다고 판정되는 것입니다.
정말로 trailingSlash를 always로 설정했다면?
이것도 시도해 보았습니다. astro.config.mjs에 다음을 추가합니다.
export default defineConfig({
trailingSlash: "always",
// ...
});
그런 다음 같은 엔드포인트를 테스트합니다.
| 요청 주소 | 결과 |
|---|---|
/_emdash/api/auth/passkey/options | 404 |
/_emdash/api/auth/passkey/options/ | 401 NOT_AUTHENTICATED |
어느 쪽도 통하지 않습니다. 관리 페이지가 실제로 어느 형태의 주소를 보내는지는 확인하지 않았으므로 어느 쪽에 걸리는지는 단정할 수 없지만, 어느 쪽이든 로그인할 수 없습니다.
그럼 어떻게 해야 할까?
첫째, trailingSlash를 기본값으로 되돌리세요(아무것도 쓰지 않으면 ignore입니다). 기본값에서 테스트해 보니 페이지는 슬래시가 있든 없든 열리고, 로그인 엔드포인트도 정상이었습니다.
둘째, 슬래시를 붙이는 것이 앞단의 프록시나 게이트웨이라면 /_emdash/로 시작하는 경로는 고쳐 쓰지 말고 그대로 통과시키세요. 이 항목은 실제 프록시에서 시도해 보지 않았습니다. 위의 원리에서 추론한 것이므로 직접 검증해 주세요.
셋째, 버전에 관해서입니다. 우리가 테스트한 것은 1.4.0입니다. 커뮤니티에서는 해당 수정이 메인 브랜치에 병합되었지만, 우리가 테스트할 때 최신 릴리스는 여전히 1.4.0이었고 그 수정은 포함되어 있지 않았습니다. 그러니 나중에 업그레이드하더라도 당연하다고 여기지 말고, 위의 curl 두 줄을 다시 실행해 보세요. 10초면 됩니다.
매직 링크 로그인은 왜 계속 되었을까?
그 제보에는 매직 링크 로그인은 계속 정상이었다고 적혀 있었습니다. 목록을 보면 이상하지 않습니다. auth/magic-link/는 슬래시로 끝나는 항목이라 접두사로 일치시키므로, 뒤에 슬래시가 하나 더 붙어도 영향이 없습니다. 이것은 목록을 보고 한 우리의 추론이며, 따로 검증하지는 않았습니다.
내가 해당되는지 어떻게 판단할까?
두 가지가 동시에 맞아야 합니다.
- 패스키 로그인에서는
Not authenticated가 뜨는데, 매직 링크 로그인은 정상이다. - 위의 curl에서 슬래시가 있는 쪽은
401, 없는 쪽은200을 반환한다.
두 번째에서 둘 다 200이라면 다른 문제입니다. 이 글은 도움이 되지 않습니다.