# 관리자 계정 관리 · 웹 비밀번호 변경 2026-09-27 갱신 · F76 · E02 사용자 지정 관리자 기능. 기존 단일 관리자 인증을 사용한다. ## 사용 방법 1. [기기 관리](https://remote.n3m.kr/)에 로그인하고 좌측 **계정 관리**를 연다. 바로가기는 `/#account`다. 2. 현재 비밀번호, 새 비밀번호, 새 비밀번호 확인을 입력한다. 원하는 비밀번호를 입력한다. 길이·문자 구성·기존 비밀번호 재사용 제한은 없다. 빈 값은 입력할 수 없다. 3. **비밀번호 변경**을 누르면 현재 비밀번호를 서버에서 확인한다. 성공하면 모든 관리자 로그인을 해제하고 로그인 화면으로 돌아간다. 4. 새 비밀번호로 다시 로그인한다. 이후 명령어를 이용한 앱 다운로드에서도 새 관리자 비밀번호를 사용한다. 현재 비밀번호가 틀리면 계정 관리 화면에서 다시 입력한다. 새 비밀번호 확인이 다르거나 필수 입력칸이 비어 있으면 요청을 보내지 않는다. 비밀번호를 잊었다면 서버 관리자의 기존 `set-admin-password` 명령으로 복구한다. 로그인만 알고 있는 세션에서 현재 비밀번호 없이 변경하는 기능은 제공하지 않는다. ## 변경 범위와 원본 대조 기준 원본은 Windows Parsec 150-104a, 코어 SHA-256 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f`다. 이번 화면은 사용자가 요청한 개인 Ubuntu 서버 관리 E02 범위의 독립 구현이다. Parsec 클라우드 계정 관리의 소스·서버 구조를 확보하거나 같은 화면으로 복구한 결과가 아니다. 기존 관리자 웹과 같은 사이드바·밝은 테마·입력 규칙을 사용한다. 로그인 전에는 계정 관리 페이지와 메뉴를 숨긴다. 로그인 후 기기/승인/다운로드 화면과 계정 관리 화면을 오갈 수 있고, 주소 및 브라우저 뒤로/앞으로 이동에도 대응한다. F76 전체 parity는 `different`, 기능 진행은 `partial`을 유지한다. ## 서버 처리 - `POST /notparsec-admin/api/account/password`: 유효한 관리자 Bearer 토큰과 `current_password`, `new_password`가 필요하다. 기기 토큰이나 다운로드용 Basic 인증으로 변경할 수 없다. - 현재 비밀번호 검증은 로그인·터미널 다운로드와 동일한 서버 전체 **1분 5회** 한도를 공유한다. 2026-09-27 사용자 요청으로 12자 최소 길이·256바이트 상한·CR/LF/NUL 금지·동일 비밀번호 재사용 금지를 제거했다. 빈 값만 거부한다. 웹 변경/로그인/다운로드/CLI 초기화와 PC 앱이 `notparsec-access`의 공통 Argon2id 해시·검증 및 빈 값만 거부하는 규칙을 사용한다. 관리자와 PC의 실제 비밀번호·저장 위치는 서로 독립적이다. [앱 정책 통일](CLIENT_PASSWORD_POLICY.ko.md)을 참고한다. - Argon2id 연산은 비동기 요청 루프 밖에서 실행하고, 새 salt를 사용한 해시만 저장한다. 요청 비밀번호는 Rust 요청 객체가 해제될 때 지우며 응답·로그·URL·브라우저 저장소에 쓰지 않는다. - 최종 저장 직전에 세션 만료·로그아웃과 인증 generation을 다시 확인한다. DB의 기존 generation이 확인 시점과 같을 때만 verifier와 generation을 한 번에 교체한다. 동시 변경이나 CLI 초기화가 끝난 뒤 이전 요청이 덮어쓰지 못한다. - 성공한 변경은 현재 세션을 포함한 이전 generation의 모든 관리자 세션을 무효화한다. 기기 인증 키·호스팅 설정·PC의 원격 접속 비밀번호를 수정하지 않는다. - 응답: 성공 `204`, 무효/만료 세션 `401`, 현재 비밀번호 불일치 `403`, 빈 새 비밀번호 `400`, 시도 한도 초과 `429`. 브라우저의 이전 목록 갱신 응답이 늦게 도착해도 변경 성공 안내나 새 로그인 상태를 덮어쓰지 않도록 요청별 로그인 세대를 확인한다. 모든 비밀번호 입력칸은 요청 제출·로그아웃·계정 관리 화면 이탈 시 지운다. ## 검증 검증에는 운영 계정과 분리한 임시 DB·비밀번호를 사용한다. 실제 서버의 현재 비밀번호를 바꾸는 시험은 하지 않는다. [검증 기록](evidence/admin-account-validation.json)에 서버/API 시험, 실제 Chromium의 두 로그인 세션 무효화, 새 비밀번호의 재시작 후 로그인, 데스크톱·모바일 표시 및 배포 확인을 기록한다. 실제 Safari·Edge의 비밀번호 관리자와 스크린 리더 사용성은 별도 미검증이다. 관련 구현: `apps/control-server/src/api/admin.rs`, `apps/control-server/src/admin_password.rs`, `apps/control-server/web/admin.html`, `admin.css`, `admin.js`. 기존 DB schema 6을 사용하며 별도 데이터 이전은 필요하지 않다. [관리자 웹 운영 안내](../deploy/ubuntu/WEB_ADMIN.ko.md), [API 계약](CONTROL_API_V1.ko.md). ## 2026-09-27 · 비밀번호 제한 해제 검증 서버의 기존 API 요청 크기 한도(JSON 본문 4 KiB)와 HTTP 헤더의 전송 한도는 비밀번호 구성 정책과 별개로 유지한다. 브라우저 폼은 표준 단일행 비밀번호 입력칸을 사용한다. API는 CR/LF/NUL을 포함한 문자열을 해시·검증할 수 있으나 웹 입력칸 자체는 여러 줄 편집기가 아니다. CLI의 `--password-stdin`은 마지막 입력 종료용 LF/CRLF 하나만 제거하고, 비밀번호의 다른 공백은 보존한다. 임시 DB에서 한 글자, 현재와 같은 값, 256바이트를 넘는 한글 문자열, CR/LF/NUL을 포함한 값으로 변경 → 세션 무효화 → 새 로그인 → Basic 다운로드 → 현재 비밀번호 재검증을 확인한다. 브라우저는 긴 비밀번호 CLI 초기화/로그인, 한 글자 변경·재로그인, 같은 비밀번호 재사용, 긴 한글 비밀번호 변경·로그인을 시험한다. 현재 비밀번호 확인·확인칸 일치·세션 폐기·시도 한도·기존 해시 호환성을 유지한다. 실제 운영 계정의 비밀번호는 시험에서 변경하지 않는다. 이 변경은 E02 사용자 지정 정책이며 Parsec 원본 정책을 복원한 것으로 판정하지 않는다. 검증 결과는 [제한 해제 기록](evidence/admin-password-policy-validation.json)을 따른다.