SafePassage 문서

README (한국어)

SafePassage 는 로컬 KeePass 데이터베이스(.kdbx)를 볼트에 연결하여, 마스터 암호나 비밀 정보를 평문으로 저장하지 않으면서 노트 안에 마스킹된 자격 증명 칩과 구조화된 표를 직접 렌더링해 주는 안전하고 가벼운 Obsidian 플러그인입니다.

목차:

• 사전 요구사항
• 설치
  • 방법 1 — Obsidian 커뮤니티 플러그인 브라우저에서 설치
  • 방법 2 — Git 저장소를 복제하여 소스에서 직접 빌드
• 사용 방법
  • 데이터베이스 프로필 설정하기
  • 마스킹된 인라인 칩
  • UUID로 항목 참조하기
  • 자동완성
  • 자격 증명 표
  • 새 자격 증명 삽입하기
  • 클립보드 동작
  • 데이터베이스 잠그기
• 아키텍처
  • WebAssembly Argon2 엔진
  • 볼트 기준 상대 경로 파일 접근
  • 메모리 내 세션 키링
  • 세션 만료와 잠금
  • 보호된 필드 값
  • 클립보드 정화
  • 인라인 칩과 표 렌더링
  • UUID 항목 참조
  • 항목 자동완성
• 문제 해결 & FAQ
  • “Database file not found in vault: …” 오류
  • 칩에 “Missing Profile” 또는 “Missing Entry” 가 표시됨
  • 이전에 해당 프로필을 잠금 해제했는데도 칩이 계속 잠겨 있음
  • 새 비밀 정보 저장이 실패함
  • 클립보드가 자동으로 지워지지 않음
  • 큰 데이터베이스를 잠금 해제할 때 플러그인이 잠깐 멈춤
  • 소스에서 빌드했는데 플러그인이 나타나지 않음