notParsec / 문서전체 문서

생성 코드·템플릿

password_plan_extension.py

design/password_plan_extension.py

출처: 현재 작업 폴더 · 원문 다운로드

"""Single-owner, per-host password access and an Ubuntu control plane."""

def extend(add, features):
    add('F80', 'M0', '접속 대상 PC 비밀번호·보호 저장',
        '계정 없이 각 접속 대상 PC에 설정한 비밀번호로 원격 접속을 제한한다.',
        '접속 대상 Windows PC가 Argon2id+무작위 salt verifier만 보관하고 DPAPI로 host 개인키와 함께 보호한다. Ubuntu 연결 관리 서버에는 접속 비밀번호나 verifier를 저장하지 않는다. 로컬 비밀번호 설정/변경은 기존 인증서 identity를 보존하며 빈 값·손상된 저장소는 접속 불가로 처리한다.',
        ['같은 비밀번호에도 다른 salt가 생성되고 원문 비밀번호가 파일·로그·명령행에 남지 않음', '올바른 비밀번호만 성공, 손상된 verifier·과대 KDF 설정 거부, 변경 뒤 이전 비밀번호 거부 및 인증서 유지'],
        ['F06'], 'crates/access / host::credentials', 'RustCrypto Argon2id·Windows DPAPI·zeroize', '비밀번호 분실 시 해당 PC의 로컬 OS 권한으로 재설정한다. 계정 복구·이메일·로그인/로그아웃 기능은 만들지 않는다.')
    add('F81', 'M1', 'QUIC 연결별 비밀번호 인증·시도 제한',
        '새 연결마다 접속 비밀번호가 확인되기 전에는 영상·소리·입력을 허용하지 않는다.',
        '사전 확인한 host 인증서를 검증한 QUIC/TLS 채널에서만 비밀번호를 전송한다. 인증 전에는 크기·시간이 제한된 password 메시지만 처리하고 0-RTT 인증·자동 비밀번호 저장은 사용하지 않는다. 호스트 전체 실패 budget·동시 검증 제한으로 재접속/IP 변경 우회를 막는다. 중앙 서버 ticket이나 이전 연결 성공은 비밀번호 검사를 대체하지 않는다.',
        ['비밀번호 실패·미전송·취소·잘못된 인증서·버전/크기 오류에서 media/input 경로가 열리지 않음', '다른 QUIC 연결에서도 연속 실패 제한 유지; 비밀번호 변경·재접속 때 다시 입력; 암호문 relay 경로에서도 host만 검증'],
        ['F10', 'F80'], 'host::authentication / crates/wire / client::connect', 'Quinn/rustls·bounded framing·host-wide gate')
    add('F82', 'M2', '계정 없는 시작 화면·비밀번호 입력 UI',
        '가입·로그인·로그아웃 화면 대신 기기 선택과 연결 비밀번호 입력으로 사용한다.',
        '앱은 저장한 서버 주소·로컬 장치 키로 시작한다. 기기 선택→host 인증서 확인→마스킹 비밀번호 입력→연결 순서를 제공한다. 설정에는 이 PC의 접속 비밀번호 설정/변경, 서버 주소, 장치 등록/해제가 있다. 비밀번호 입력 취소·오류·대기 시간·다시 입력을 표시하고 앱 종료/연결 해제를 계정 로그아웃과 구별한다.',
        ['가입/로그인/로그아웃 UI 없이 장치 목록 또는 직접 주소에서 접속 시작; 새 연결마다 입력', '비밀번호 입력/설정 화면의 IME·마스킹·취소·재시도와 로컬 재설정 검증; 비밀번호를 브라우저 설계 문서나 메모에 저장하지 않음'],
        ['F81', 'F47'], 'client::password-dialog / host::settings', '자체 UI; Parsec 계정 UI는 분석 근거로만 유지')
    by_id = {f['id']: f for f in features}
    by_id['F10']['dependencies'].append('F80')
    by_id['F17']['dependencies'].append('F81')
    by_id['F24']['dependencies'].append('F82')
    by_id['F17']['implementation'] += ' F81의 연결별 비밀번호 성공 뒤에만 보기/제어 권한을 열고 서버 ticket만으로 입력을 허용하지 않는다.'
    by_id['F61']['implementation'] = by_id['F61']['implementation'].replace('재인증·로그아웃 중 활성 세션 처리 방침', '장치 재등록·연결 해제 중 활성 세션 처리 방침')
    by_id['F61']['acceptance'] = [a.replace('로그아웃/신뢰 해제 시', '연결 종료/장치 신뢰 해제 시') for a in by_id['F61']['acceptance']]
    by_id['F73']['implementation'] += ' 이는 앱 내부 장치 인증이며 사용자 계정 로그인 화면을 만들지 않는다. host 접속 비밀번호는 이 API로 전송하지 않는다.'
    by_id['F75']['implementation'] += ' ticket은 암호화 연결 시도만 허용하며 host에서 AwaitingPassword→PasswordVerified를 거친 뒤에만 media 권한이 생긴다. 비밀번호 원문/verifier는 서버에 전달하지 않는다.'
    by_id['F78']['implementation'] = by_id['F78']['implementation'].replace('Linux Compose 또는 systemd 중 실제 환경에 맞는', 'Ubuntu systemd를 기본으로 하는')
    by_id['F78']['risk'] = 'Ubuntu 실행 확정. 24.04 LTS를 초기 CI/배포 기준으로 두되 실제 Ubuntu 버전·도메인·경로·회선 속도는 배포 전 확인한다.'
    by_id['F71']['acceptance'][0] = 'Ubuntu 대상 clean build와 임시 설정 기동·정상 종료, Windows host/client와 protocol 호환 시험'
    features.sort(key=lambda f: int(f['id'][1:]))