기능

• 완전한 오프라인 동작.
• 키 파생을 위한 Argon2id와 libsodium을 사용한 인증된 암호화를 통한 안전한 암호화.
• 안전한 비밀번호 생성기.
• 외부 라이브러리 없이 구축된 사용자 정의 TUI.

---

설치

AppImage

releases 에서 AppImage를 다운로드하고 실행하세요:

chmod +x klip-x86_64.appimage 
./klip-x86_64.appimage

소스에서 빌드

의존성:

• libsodium

설치:

git clone https://github.com/vid4l-07/Klip.git
cd klip
mkdir build
cd build
cmake ..
make
sudo make install

---

사용법

전역

키	동작
q	종료

탭 바

키	동작
l / Right	오른쪽으로 이동
h / Left	왼쪽으로 이동
Enter	선택한 db 열기
o	새 db 열기/생성
x	선택한 db 닫기

데이터베이스

키	동작
Esc	탭 바로 포커스
j / Down	아래로 이동
k / Up	위로 이동
Enter	선택/복사
n	새 자격 증명
f	사이트별 필터
e	자격 증명 편집
d	자격 증명 삭제
g	안전한 비밀번호 생성

클립보드에 복사

자격 증명이 선택된 경우:

• User에서 Enter를 누르면 사용자 이름이 복사됩니다.
• Pass에서 Enter를 누르면 비밀번호가 복사됩니다.

파일 열기

Open을 선택하면 텍스트 팝업이 나타납니다. 팝업 내에서 Tab을 눌러 최근에 열었던 데이터베이스를 탐색할 수 있습니다.

데이터베이스의 절대 경로 또는 상대 경로를 입력할 수 있습니다. 파일이 존재하지 않는 경우, 지정된 경로가 유효하면 생성됩니다.

최근 파일 경로는 $HOME/.config/klip/recents에 저장됩니다.

---

보안

모든 암호화 로직은 src/Security.cpp에 위치합니다.

키 파생

• 데이터베이스를 생성할 때 마스터 비밀번호가 요청됩니다.
• libsodium의 crypto_pwhash를 사용하여 비밀번호와 고유한 무작위 솔트로부터 암호화 키가 파생되며, Argon2id를 기반으로 INTERACTIVE 모드에서 동작합니다 (무차별 대입 공격에 대비한 조정 가능한 비용 매개변수).

암호화

• 데이터베이스는 파생된 키와 무작위 nonce를 사용하여 crypto_secretbox_easy로 암호화됩니다.
• 이 알고리즘은 MAC을 통한 변조 감지를 제공합니다.

저장 형식

• 암호화된 파일은 다음 형식의 바이너리로 저장됩니다:

[salt][nonce][ciphertext]

복호화 과정

• 사용자가 제공한 비밀번호와 저장된 솔트를 사용하여 키가 파생됩니다.
• 데이터는 crypto_secretbox_open_easy를 사용하여 복호화됩니다.
• 비밀번호가 잘못되었거나 파일이 수정된 경우, MAC 검증이 실패하고 작업이 거부됩니다.

---

기여

기여는 언제나 환영합니다. 버그를 발견하거나 새로운 기능에 도움을 주고 싶다면:

• 저장소에 이슈를 열어주세요.
• 풀 리퀘스트를 열어주세요.