암호 위젯

AES-256-GCM Windows 자격증명 30초 자동 비움

암호 위젯은 평소 자주 입력하는 로그인 정보를 안전하게 저장해 두고, 검색 → 한 번의 클릭으로 클립보드에 복사할 수 있는 빠른 복사용 위젯입니다. 비밀번호 자체는 암호화되어 저장되며, 복사 후 30초가 지나면 클립보드가 자동으로 비워집니다.

또한 암호 관리 페이지에서 암호 데이터를 추가/편집/삭제할 수 있습니다.

위젯 화면 구성

┌──────────────────────────────────────┐
│ 🔐 암호           [+] [⚙]            │ ← 헤더
├──────────────────────────────────────┤
│ [검색...                          ]   │
├──────────────────────────────────────┤
│  ┌────────────────────────────────┐  │
│  │ 링크   github.com         [📋] │  │
│  │ 사용자 myname             [📋] │  │
│  │ 암호   ●●●●●●●●           [📋] │  │
│  └────────────────────────────────┘  │
└──────────────────────────────────────┘

영역	설명
헤더	추가(+), 설정(⚙) 버튼
검색바	사이트명, 사용자명, URL을 부분 일치로 실시간 필터링
카드	입력된 필드만 행으로 노출 (URL / 사용자 / 암호)
복사 버튼(📋)	각 행 우측의 클립보드 아이콘

항목 추가 / 편집 / 삭제

위젯 안에서 직접 항목을 관리할 수 있습니다.

헤더의 + 버튼을 누르면 목록 위에 인라인 입력 폼이 나타납니다.
URL, 사용자명, 비밀번호 중 최소 1개 이상 입력합니다. (셋 다 비어 있으면 저장되지 않습니다.)
저장 버튼으로 등록하거나 취소(또는 Esc)로 닫습니다.
기존 카드를 우클릭 → 편집을 누르거나, 카드 자체를 클릭(편집 아이콘이 있는 경우)해 인라인 폼으로 진입합니다.
편집 폼에서는 우측 하단의 삭제 버튼으로 항목을 제거할 수도 있습니다.

저장이 완료되면 passwords:updated IPC 이벤트가 모든 창으로 전송되어, 다른 암호 위젯 인스턴스나 암호 관리 페이지가 자동으로 새로고침됩니다.

빠른 복사

각 행의 **클립보드 버튼(📋)**을 누르면 해당 값이 클립보드에 복사됩니다.

버튼 위치	복사 대상
URL 행	URL 문자열
사용자 행	사용자명(아이디)
암호 행	평문 비밀번호

복사 후에는 위젯 하단에 토스트 메시지(“클립보드에 복사됨”)가 짧게 표시됩니다.

URL/경로 클릭

URL 행의 텍스트(링크)를 직접 클릭하면 다음과 같이 동작합니다.

http(s):// 형식 → 시스템 기본 브라우저로 열림
C:\..., \\server\... Windows 경로 → 파일 탐색기로 열림

보안 동작

암호 위젯은 다음과 같은 다층 보안 구조로 동작합니다.

암호화 저장

저장된 비밀번호는 AES-256-GCM으로 암호화된 뒤 SQLite DB에 기록됩니다. 평문은 디스크에 남지 않습니다.

OS 자격증명에 키 보관

암호화 키는 Windows에서는 자격 증명 관리자(keytar → Windows Credential Manager)에 보관됩니다. 앱 자체에는 평문 키가 들어 있지 않습니다.

메모리 노출 최소화

평문 비밀번호는 화면에서 항상 점(●●●)으로 표시되며, 사용자가 명시적으로 복사를 요청할 때만 클립보드에 잠시 노출됩니다.

30초 자동 클립보드 비움

복사 후 30초가 지나면 클립보드 내용이 복사 시점의 값과 같은지 확인한 뒤 자동으로 비워집니다.

클립보드 자동 비움 동작

[복사 버튼 클릭]
    ↓
navigator.clipboard.writeText(text)
    ↓
30초 후
    ↓
현재 클립보드 == 복사한 값?
    ├ 같으면 → 클립보드를 빈 문자열로 덮어씀
    └ 사용자가 다른 것을 복사했으면 → 그대로 둠

이 방식은 중요 정보가 잊혀진 채 클립보드에 남는 시간을 줄이기 위한 것입니다. 다만 이미 다른 앱(클립보드 매니저 등)이 가로채 저장한 경우에는 보호되지 않습니다.

검색

검색바에 입력한 키워드는 다음 필드에 부분 일치로 매칭됩니다.

사이트 이름(siteName)
사용자명(username)
URL(url)

대소문자 구분 없이 즉시 필터링되며, 빈 검색어는 전체 목록을 보여줍니다.

위젯 설정

설정 창에서 다음 항목을 조정할 수 있습니다.

항목	설명
배경 색상 + 투명도	배경 RGB와 알파(0~100%)를 별도로 조정
글자 색상	라벨/값/검색 입력란의 텍스트 색
타이틀 글자/버튼 색상	헤더의 제목과 +/⚙ 버튼 색상
외곽선 색상	카드 테두리 + 헤더/검색 구분선
모서리 둥글기	위젯 전체 라운딩
창 투명도	위젯 창 자체의 투명도
창 고정	드래그 비활성화 (헤더가 더 이상 이동 핸들로 동작하지 않음)

배경 색상의 밝기에 따라 글자/외곽선 색상이 자동 보정됩니다(어두운 배경 → 밝은 글자, 밝은 배경 → 어두운 글자).

다른 비밀번호 매니저와의 차이

항목	Sudapapa 암호 위젯	LastPass / 1Password 등
데이터 위치	사용자 PC만	클라우드 동기화
마스터 키	OS 자격 증명 관리자	자체 마스터 비밀번호
자동 입력	✗ (클립보드 복사)	✓ 브라우저 확장 자동 입력
다중 기기 동기화	✗	✓
비용	무료(앱 라이선스에 포함)	유료 구독

암호 위젯은 로컬 + 가벼운 빠른 복사에 특화되어 있어, 본격적인 비밀번호 관리는 전용 솔루션과 병행하거나 암호 관리 페이지를 활용하는 것을 권장합니다.

백업과 복원

비밀번호 데이터는 암호화된 형태로 SQLite 파일에 저장되며, 복호화에 필요한 키는 OS 자격 증명 관리자에 별도로 보관됩니다.

자주 묻는 질문

Q. 위젯에 마스터 비밀번호 잠금이 있나요? A. 별도의 잠금 화면은 없습니다. 위젯의 보호는 OS 사용자 계정 잠금과 OS 자격 증명 관리자 권한에 위임됩니다. 자리를 비울 때는 반드시 PC를 잠가 주세요.

Q. 비밀번호 강도 표시나 자동 생성을 쓰고 싶어요. A. 위젯에는 강도 게이지가 없습니다. 암호 관리 페이지에서 강도 표시와 자동 생성 기능을 사용할 수 있습니다.

Q. 복사한 비밀번호가 30초 후 자동으로 사라지지 않아요. A. 다른 앱(클립보드 매니저, 가상 키보드 등)이 클립보드를 가로채면 위젯이 비울 수 없는 경우가 있습니다. 클립보드 매니저 사용 시 보안 정책을 함께 확인해 주세요.

Q. 비밀번호를 화면에 표시할 수 있나요? A. 위젯은 보안을 위해 항상 마스킹(●●●)된 상태로만 표시합니다. 실제 값을 봐야 한다면 편집 폼을 열어 입력란에서 확인하거나, 암호 관리 페이지를 사용하세요.