새 버전을 배포했는데 기존 사용자가 모두 다시 로그인해야 합니다. 로그인 화면에서 새로 인증하면 정상이고, 다음 배포가 오기 전까지는 잘 동작합니다. 이런 가상 상황에서는 인증 코드만 비교하기보다 배포 전후에 함께 살아남아야 할 상태가 무엇인지 살펴볼 필요가 있습니다.
ASP.NET Core 서비스를 운영하는 관점에서 데이터베이스가 유지된다는 사실과 기존 인증 쿠키를 읽을 수 있다는 사실은 다릅니다. 회원 정보가 그대로 있어도 쿠키를 보호한 키가 없어지면 이전 상태를 해석하지 못할 수 있습니다. 반대로 로그인 해제가 발생했다고 언제나 키 문제라고 단정할 수도 없습니다.
이 글은 2026년 11월 1일 확인한 ASP.NET Core 10.0 공식 문서의 Data Protection 설정을 기준으로 진단 순서를 제안합니다. 실제 장애를 해결했다는 경험담이나 실행 결과가 아닙니다. 표준 쿠키 인증을 사용하는 앱을 중심으로 설명하며 별도 인증 체계에는 해당 체계의 저장·검증 규칙을 추가로 확인해야 합니다.
기존 쿠키만 실패하는지 먼저 나눠 봅니다
Microsoft의 키 관리 문서는 표준 ASP.NET Core 쿠키 인증이 Data Protection으로 쿠키를 보호한다고 설명합니다. 따라서 배포 전 발급한 쿠키를 새 프로세스에서도 처리하려면 관련 키에 접근할 수 있어야 합니다. 회원 테이블만 복원해도 모든 로그인 상태가 함께 복구되는 것은 아닙니다.
먼저 증상을 시간과 범위로 나눕니다. 배포 직후 기존 사용자에게만 생기는지, 신규 로그인도 실패하는지, 특정 서버를 거칠 때만 반복되는지 적습니다. 이 차이는 확인할 곳을 좁히는 단서입니다. 예를 들어 새 로그인도 안 된다면 보호 키 외에 로그인 처리나 외부 인증 연결의 변화도 함께 조사해야 합니다.
브라우저가 쿠키를 보내지 않은 경우와 서버가 받은 쿠키를 해석하지 못한 경우도 구별합니다. 쿠키 만료, 도메인과 경로 설정, 인증 설정 변경 등을 검토할 수 있습니다. 응답이 로그인 화면으로 이동했다는 결과 하나만으로 원인을 확정하지 않습니다. 오류 로그와 배포 변경 내용을 같은 시각 기준으로 비교하는 것이 출발점입니다.
이때 실제 쿠키 문자열이나 키 파일 내용을 작업 문서에 붙이지 않습니다. 확인에 필요한 것은 어떤 인스턴스에서 언제 실패했는지, 어떤 오류 종류인지, 저장 위치와 접근 가능성이 바뀌었는지입니다. 비밀값을 수집량의 기준으로 삼기보다 진단 질문에 답하는 최소 기록을 남기는 편이 관리하기 쉽습니다.
키가 저장된 위치와 배포 수명을 맞춥니다
Data Protection의 기본 저장 방식은 실행 환경에 따라 달라집니다. 개발 PC에서 재시작 후 잘 되었다는 사실만으로 컨테이너나 다른 서버에서도 같은 위치에 영속화된다고 가정하면 안 됩니다. 공식 문서는 컨테이너 수명을 넘어 유지되는 볼륨이나 외부 제공자를 이용해 키를 보관하는 구성을 설명합니다.
가령 새 컨테이너를 만들 때마다 이전 컨테이너의 내부 파일을 버리는 배포라면, 키가 그 내부에만 있었는지 확인합니다. 파일 경로 문자열이 두 배포에서 같아도 실제 저장 공간은 다를 수 있습니다. 경로 비교에서 끝내지 않고 볼륨 연결, 실행 계정의 권한, 배포 과정의 정리 대상까지 살펴봐야 합니다.
점검 기록에는 저장 방식, 실제 보관 자원, 읽고 쓰는 실행 주체, 재배포 후 유지 여부를 적습니다. 예를 들어 지속 볼륨을 사용한다면 마운트가 빠진 경우를 어떻게 감지하는지도 정합니다. 새 키가 생겼다는 사실만으로 정상이라고 판단하면 원래 보관소에 접근하지 못한 상태를 놓칠 수 있습니다.
키 보관과 키 보호는 별개의 설정입니다. Data Protection 구성 문서는 키 저장 위치를 명시적으로 바꾸면 자동 저장 시 암호화가 더 이상 적용되지 않는다고 경고합니다. 저장소를 지정한 뒤에는 환경에 맞는 ProtectKeys 설정과 저장소 접근권한을 함께 검토해야 합니다.
여기서 특정 인증서 파일이나 클라우드 서비스를 무조건 선택할 필요는 없습니다. 현재 운영 환경에서 복호화 수단을 어떻게 보관하고 누가 사용할 수 있는지까지 설명할 수 있는 방식을 고릅니다. 암호화된 키 파일을 복사했더라도 새 실행 계정이 복호화 수단에 접근하지 못하면 필요한 기능을 수행할 수 없습니다.
여러 인스턴스의 공유와 다른 환경의 격리를 구분합니다
한 앱을 여러 인스턴스로 운영한다면 한쪽이 발급한 보호 데이터를 다른 쪽이 처리해야 하는 상황을 고려해야 합니다. 키 저장소뿐 아니라 애플리케이션 식별자와 관련 설정이 맞는지 확인합니다. 공식 문서의 SetApplicationName은 이 식별자를 명시하는 수단이며, 기본 격리는 콘텐츠 루트 경로와 관련됩니다.
배포마다 폴더명이 달라지는 환경이라면 이전 배포와 새 배포의 식별자가 어떻게 결정되는지 확인할 이유가 있습니다. 다만 이름을 같은 값으로 넣는 것만으로 인증 공유가 완성되는 것은 아닙니다. 키 접근, 보호 목적, 인증 방식과 쿠키 설정 등 해당 앱이 요구하는 조건을 함께 검토해야 합니다.
가상으로 운영 서버 두 대를 늘리는 상황과 개발·운영 환경을 묶는 상황은 다릅니다. 전자는 같은 서비스의 요청을 이어받기 위한 설계일 수 있지만, 후자는 서로 다른 접근 경계를 넓히는 결정입니다. 오류를 빨리 없애려고 모든 환경에 같은 이름과 저장소를 넣는 방식은 피하고, 어떤 배포끼리 데이터를 읽어야 하는지 먼저 적습니다.
공유가 필요하다면 저장소에 대한 읽기뿐 아니라 쓰기와 새 키 생성 권한도 제한해야 합니다. 공식 구성 문서도 키 저장소를 앱 자체에 한정된 권한으로 보호하도록 설명합니다. 저장 시 암호화를 켰다는 이유로 여러 계정에 자유로운 쓰기 권한을 주는 것은 같은 보호가 아닙니다.
운영 문서에는 공유 대상을 이름만으로 적지 말고 실제 배포 단위로 적어 두면 좋습니다. 운영의 어느 인스턴스들이 같은 저장소와 식별자를 쓰는지, 스테이징은 어디에 분리되어 있는지를 연결합니다. 이를테면 인스턴스 추가 때 복사해야 할 설정과 복사하면 안 되는 설정을 나눌 수 있습니다.
회전과 삭제를 혼동하지 않고 재배포를 검증합니다
키가 오래되었다는 이유로 정리하는 작업도 주의해야 합니다. 공식 문서는 새 키로 전환된 뒤에도 이전 키가 남아 있으면 그 키로 보호한 데이터를 해제할 수 있다고 설명합니다. 키 회전은 이전 키를 즉시 삭제한다는 뜻이 아닙니다. 삭제는 과거 보호 데이터를 읽지 못하게 만들 수 있으므로 일반 파일 청소와 같은 기준을 적용하지 않습니다.
실제 적용 전에 확인할 시나리오를 작게 적습니다. 별도 검증 환경에서 배포 전 로그인, 재배포, 기존 로그인 상태 사용, 새 로그인 순서를 확인하는 방식입니다. 여러 인스턴스라면 요청이 서로 다른 인스턴스로 가는 상황도 포함합니다. 이 글에서는 해당 검증을 실행하지 않았으므로 아래 항목은 수행할 검사표입니다.
- 기존 상태: 배포 전에 받은 쿠키로 배포 후 허용된 화면에 접근할 수 있는지 확인합니다.
- 새 상태: 새 로그인과 로그아웃이 정상이며 기존 상태 유지 때문에 만료 정책을 풀지 않았는지 봅니다.
- 인스턴스 차이: 특정 인스턴스에서만 실패한다면 저장소 접근과 식별자 차이를 대조합니다.
- 실패 기록: 보관소 접근 실패를 발견할 수 있는지, 로그에 쿠키나 키 원문을 남기지 않는지 확인합니다.
성공 기준은 모든 사용자를 영원히 로그인 상태로 유지하는 것이 아닙니다. 의도한 만료와 로그아웃은 계속 동작하면서 배포로 인한 뜻밖의 해제가 줄어드는지를 봐야 합니다. 키 문제를 고치기 위해 쿠키 검증을 우회하거나 만료를 없애면 다른 문제를 만든 셈입니다.
설정을 바꾼 뒤에도 증상이 남으면 처음의 범위 구분으로 돌아갑니다. 배포 시각, 실패 인스턴스, 기존·신규 쿠키 차이가 예상과 맞는지 확인하고 다른 인증 설정을 조사합니다. 키가 원인이라는 가설을 끝까지 고집하기보다 실제 관찰 결과에 따라 조사 대상을 바꾸는 편이 낫습니다.
지금 할 일은 현재 키 저장소가 재배포 뒤에도 남는지 한 줄로 답하는 것입니다. 답이 불확실하면 배포 설정과 보관 자원을 먼저 확인합니다. 그다음 앱 식별자와 접근권한, 저장 시 보호를 연결해 기록하면 로그인 문제를 코드 변경 여부만으로 판단하는 범위를 벗어날 수 있습니다.
'개발 노트 > ASP.NET Core' 카테고리의 다른 글
| EF Core에서 동시에 고친 원고가 덮어써지지 않게 하는 방법 (0) | 2026.11.19 |
|---|---|
| .NET 8·9 지원 종료 전에 .NET 10 LTS로 옮길지 판단하는 기준 (0) | 2026.10.27 |
| EF Core 11 Complex Types·FullJoin 프리뷰를 도입하기 전 검증 항목 (0) | 2026.09.30 |
| ASP.NET Core Rate Limiting 정책을 API 비용과 공정 사용량에 맞추는 법 (1) | 2026.09.29 |
| .NET 11 Runtime Async를 기존 async/await와 비교해 본 체크리스트 (0) | 2026.09.28 |