매직 링크 로그인은 왜 실패하나요?

사용자 실수처럼 보이는 실패

증상은 언제나 같고 언제나 헷갈립니다. 누군가 로그인 링크를 요청하고, 링크가 도착하고, 클릭하면, 앱이 유효하지 않거나 이미 사용되었다고 답합니다. 로그에서는 망가진 곳이 보이지 않습니다. 메일은 수신되었고, 토큰은 생성되었으며, 토큰은 검증되었습니다. 검증은 되었습니다 — 다만 보낸 그 사람에 의해서가 아닙니다. 발송과 클릭 사이에는 그 메시지를 읽는 기계들의 줄이 있습니다. 수신 측 메일 보안 제품이 링크를 다시 쓰고 따라가 확인하고, 메일 클라이언트가 미리보기를 즉시 띄우려고 먼저 불러오고, 기업 게이트웨이가 격리 환경에서 URL을 실행하며, 때로는 입구의 필터가 같은 일을 합니다.

우리 자신의 운영 가입 흐름에서도 2026년 8월에 같은 일이 있었고, 아무 일도 아닌 것처럼 보이기 때문에 그 형태를 남겨둘 가치가 있습니다. 한 가입자가 한 자리에서 링크를 세 번 요청했습니다. 세 개 모두 발송 후 16~23초 안에 서버에서 검증되었고 — 받은편지함을 읽는 사람이라기에는 너무 빠릅니다 — 그 뒤의 사람 클릭은 전부 이미 사용됨으로 거절되었습니다. 그 사람은 소셜 로그인으로 처음부터 다시 시작해서야 들어올 수 있었습니다. 평범한 습관 두 가지가 상황을 더 나쁘게 만들면서 똑같은 로그 한 줄을 남깁니다. 휴대폰에서 링크를 요청하고 노트북에서 여는 것, 그리고 로그인 메일을 동료나 자기 두 번째 주소로 전달하는 것입니다. 토큰에 대한 첫 요청이 사람의 브라우저라고 가정한 설계에서는 이 셋이 모두 공격처럼 읽히지만, 실제로는 모두 정상적인 사용입니다.

내 경우가 어느 쪽인지 가려낸다

무엇을 바꾸기 전에, 실제로 토큰을 써버린 것이 무엇인지부터 찾으세요. 단서는 타임스탬프입니다. 스캐너나 프리페치는 발송 후 몇 초 안에 도착하고, 사람은 수십 초에서 몇 분이 걸립니다. 모든 검증의 시각과 사용자 에이전트, IP를 발송 시각 옆에 기록하고 함께 읽으세요.

고치는 순서가 결과를 가른다

순서가 핵심입니다. 이 중 두 가지는 따로 두면 안전하지만 순서가 어긋나면 위험해집니다.

1. 소비보다 만료를 먼저 확인한다 다른 무엇을 바꾸더라도 만료된 토큰이 세션을 열어서는 안 됩니다. 만료 검사를 앞에 두는 것이 다음 단계를 안전하게 만듭니다. 그것이 없으면 재열람을 허용하는 일이 링크의 수명을 늘리는 일이 되어, 방문 한 번을 더 견디는 수준을 넘어섭니다.
2. 만료 전 링크는 여러 번 열 수 있게 한다 이미 검증되었지만 아직 유효 기간 안에 있는 토큰은 받아들이고, 오류 대신 재사용임을 알리는 표시를 돌려주세요. 링크는 만료될 때 죽어야지, 첫 기계가 건드릴 때 죽어서는 안 됩니다.
3. 첫 검증 시각을 보존한다 재열람을 받아들일 때도 최초 소비 시각을 덮어쓰지 마세요. 어떤 접근이 실제로 먼저였는지 알려주는 유일한 기록이며, 다음에 누군가 같은 증상을 알려올 때 가장 먼저 보게 될 값입니다.
4. 열람 횟수가 아니라 유효 시간을 좁힌다 여러 번 열려도 되는 짧은 수명의 링크가, 첫 접촉에서 죽는 긴 수명의 링크보다 실무에서 더 안전합니다. 보안을 실제로 담당하는 것은 짧은 수명이고, 한 번만 쓸 수 있다는 제약은 처음부터 그 대용품이었을 뿐입니다.
5. 두 번째 문을 반드시 남긴다 비밀번호, 패스키, 소셜 로그인 가운데 다른 입구를 하나 제공하고, 세 번 클릭해야 닿는 곳이 아니라 실패 화면 자체에 보여주세요. 우리가 잃을 뻔한 가입자는 소셜 로그인으로 돌아왔습니다. 그 문이 없었다면 문턱에서 사라졌을 것입니다.
6. 실패했을 때 쓸모 있는 말을 한다 "유효하지 않은 링크"는 상대가 무언가 잘못했다고 말할 뿐입니다. "이 링크는 만료되었습니다 — 새 링크를 보내드립니다"와 같은 화면의 한 번 누르는 재발송은, 사람을 지원 메일함으로 보내지 않고 흐름 안에 붙잡아 둡니다.

버그로는 절대 보고되지 않는 피해

로그인 실패는 눈에 보입니다. 측정의 피해는 보이지 않고, 버그보다 오래 남습니다. 가입 전환 이벤트를 검증 엔드포인트에 처음 도착한 요청에서 발화시키고 있다면, 스캐너가 먼저 닿을 때마다 그 전환은 어떤 브라우저도 실행하지 않는 리다이렉트에 실려 갑니다. 우리에게 일어난 일이 정확히 그것이었습니다. 신규 가입을 뜻하는 표시가 스캐너의 요청과 함께 실려 가는 바람에, 그 사람의 광고 플랫폼 가입 전환은 끝내 기록되지 않았습니다. 그 데이터로 입찰하는 사람은, 가장 어렵게 얻은 전환 일부가 조용히 빠진 숫자에 입찰하고 있는 셈입니다.

이것을 잡아내는 습관은 밋밋하지만 확실합니다. 링크 클릭이 아니라 완료된 세션을 세고, "링크 요청"과 "세션 생성" 사이의 간격을 퍼널의 독립된 한 단계로 다루세요. 요청 가운데 의미 있는 비율이 끝내 세션이 되지 않는다면 랜딩 페이지를 아무리 손봐도 고쳐지지 않습니다. 설득의 실패가 아니라 작동의 실패이기 때문입니다. 이 앞 단계는 사이트 방문자를 가입으로 바꾸는 방법을, 다음 단계는 활성화율을 보세요. 메일이 아예 도착하지 않는다면 스팸으로 분류되지 않는 콜드 이메일 쓰는 법의 도메인 인증 순서가 트랜잭션 메일에도 그대로 적용됩니다. 어디서 보낼지를 이제 정하는 중이라면 Notifuse가 자체 운영 선택지 하나입니다.