trailingSlash: always를 설정했더니 패스키 로그인이 Not authenticated로 실패합니다

로컬에서 재현한 로그인 장애입니다. 끝에 슬래시 하나가 더 붙는 것만으로 왜 패스키 로그인이 첫 단계에서 실패하는지, 그리고 curl 두 줄로 내가 해당되는지 판단하는 방법을 설명합니다.

우리가 슬래시 하나에 신경 쓰는 이유

우리 사이트는 빌드가 끝나면 모든 내부 링크가 끝에 슬래시를 붙였는지 검사하는 스크립트를 실행합니다. 결벽 때문이 아닙니다. 슬래시 없는 주소는 서버가 먼저 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/options404
/_emdash/api/auth/passkey/options/401 NOT_AUTHENTICATED

어느 쪽도 통하지 않습니다. 관리 페이지가 실제로 어느 형태의 주소를 보내는지는 확인하지 않았으므로 어느 쪽에 걸리는지는 단정할 수 없지만, 어느 쪽이든 로그인할 수 없습니다.

그럼 어떻게 해야 할까?

첫째, trailingSlash를 기본값으로 되돌리세요(아무것도 쓰지 않으면 ignore입니다). 기본값에서 테스트해 보니 페이지는 슬래시가 있든 없든 열리고, 로그인 엔드포인트도 정상이었습니다.

둘째, 슬래시를 붙이는 것이 앞단의 프록시나 게이트웨이라면 /_emdash/로 시작하는 경로는 고쳐 쓰지 말고 그대로 통과시키세요. 이 항목은 실제 프록시에서 시도해 보지 않았습니다. 위의 원리에서 추론한 것이므로 직접 검증해 주세요.

셋째, 버전에 관해서입니다. 우리가 테스트한 것은 1.4.0입니다. 커뮤니티에서는 해당 수정이 메인 브랜치에 병합되었지만, 우리가 테스트할 때 최신 릴리스는 여전히 1.4.0이었고 그 수정은 포함되어 있지 않았습니다. 그러니 나중에 업그레이드하더라도 당연하다고 여기지 말고, 위의 curl 두 줄을 다시 실행해 보세요. 10초면 됩니다.

매직 링크 로그인은 왜 계속 되었을까?

그 제보에는 매직 링크 로그인은 계속 정상이었다고 적혀 있었습니다. 목록을 보면 이상하지 않습니다. auth/magic-link/는 슬래시로 끝나는 항목이라 접두사로 일치시키므로, 뒤에 슬래시가 하나 더 붙어도 영향이 없습니다. 이것은 목록을 보고 한 우리의 추론이며, 따로 검증하지는 않았습니다.

내가 해당되는지 어떻게 판단할까?

두 가지가 동시에 맞아야 합니다.

  1. 패스키 로그인에서는 Not authenticated가 뜨는데, 매직 링크 로그인은 정상이다.
  2. 위의 curl에서 슬래시가 있는 쪽은 401, 없는 쪽은 200을 반환한다.

두 번째에서 둘 다 200이라면 다른 문제입니다. 이 글은 도움이 되지 않습니다.