문제 해결 & FAQ

문제 해결 & FAQ#

“Database file not found in vault: …” 오류#

프로필의 데이터베이스 파일 경로 는 현재 볼트의 루트를 기준으로 해석됩니다. 다음을 확인하세요:

  • 경로에 볼트 자체의 폴더 이름이나 맨 앞의 / 가 포함되어 있지 않은지.

  • .kdbx 파일이 실제로 볼트에 추가(또는 동기화)되어 있는지 — SafePassage는 디스크의 임의 경로가 아니라 Obsidian의 Vault API를 통해서만 파일을 읽을 수 있습니다.

선택 사항인 키 파일 경로에서 발생하는 “Key file not found in vault: …” 오류도 마찬가지입니다.

칩에 “Missing Profile” 또는 “Missing Entry” 가 표시됨#

  • Missing Profile 은 {{sp:<profile>/<entry>#<field>}} 토큰의 <profile> 부분이 설정된 어떤 프로필과도 일치하지 않는다는 뜻입니다 — 먼저 프로필 ID와 비교하고(새로 삽입되는 토큰은 ID를 사용합니다), 일치하는 것이 없으면 프로필 이름과도 비교합니다(ID를 사용하기 전에 삽입된 토큰을 위한 대체 수단입니다). 설정 → SafePassage 에서 프로필의 현재 이름을 확인하거나, ID가 확실하지 않다면 비밀 정보 삽입 을 통해 토큰을 다시 삽입하세요.

  • Missing Entry 는 프로필은 찾아서 잠금 해제했지만, 지정한 그룹/제목 경로에 해당하는 항목이 없다는 뜻입니다. 항목 경로는 대소문자를 구분하며 KeePass의 그룹 구조와 정확히 일치해야 합니다(예: SSH-Prod/[Prod] bastion).

  • Missing Field 는 항목은 찾았지만 정확히 그 이름의 필드가 없다는 뜻입니다(필드 이름 역시 대소문자를 구분합니다. 예: UserName 과 Username 은 다릅니다).

이전에 해당 프로필을 잠금 해제했는데도 칩이 계속 잠겨 있음#

프로필의 세션 만료 시간 이 지나면 정상적으로 나타나는 현상입니다 — 데이터베이스가 메모리에서 제거되어 다시 잠금 해제해야 합니다. 데이터베이스가 너무 자주 잠기는 것을 원하지 않는다면, 프로필 설정에서 만료 시간을 늘리거나(또는 계속 유지 로 설정) 하세요. 사용 방법 를 참고하세요.

프로필에서 마스터 키링으로 관리 가 켜져 있고 전역 마스터 키링 사용 설정도 켜져 있다면, SafePassage는 다시 묻는 대신 캐싱된 암호로 조용히 재잠금 해제를 시도합니다 — 이마저 동작하지 않는다면, 캐싱된 암호 자체가 이전 세션과 함께 만료되었을 수 있습니다.

새 비밀 정보 저장이 실패함#

  • “Cannot add or modify data on a read-only profile.” — 대상 프로필의 설정에서 읽기 전용 이 켜져 있습니다. 해당 데이터베이스에 써야 한다면 이 옵션을 끄거나, 비밀 정보 삽입 대화상자에서 쓰기 가능한 다른 프로필을 선택하세요.

  • “The database is locked.” — 먼저 해당 프로필을 잠금 해제한 뒤(해당 프로필의 아무 칩이나 클릭하거나 특정 프로필 잠금 해제 명령을 사용) 다시 시도하세요.

  • “Entry Path, Username, and Password are required.” — 저장하기 전에 이 세 필드를 반드시 입력해야 합니다. 그 외 필드(메모, 사용자 지정 필드)는 선택 사항입니다.

클립보드가 자동으로 지워지지 않음#

전역 보안 및 클립보드 설정 아래의 클립보드 자동 삭제 시간(초) 을 확인하세요. 0 으로 설정하면 자동 삭제가 완전히 비활성화됩니다. 0이 아닌 값으로 설정했는데도 클립보드가 지워지지 않는다면, 클립보드의 내용이 SafePassage가 복사한 값과 더 이상 일치하지 않을 때(예: 그 사이 다른 것을 복사한 경우) 삭제가 건너뛰어진다는 점을 참고하세요.

큰 데이터베이스를 잠금 해제할 때 플러그인이 잠깐 멈춤#

KDBX4 데이터베이스의 Argon2 키 유도는 의도적으로 느리게 설계되어 있습니다(그래야 마스터 암호에 대한 무차별 대입 공격 비용이 커집니다). SafePassage는 Obsidian의 UI 스레드가 멈추는 것을 막기 위해 이를 WebAssembly Argon2 구현으로 실행합니다 — 아키텍처 를 참고하세요. 그럼에도 잠금 해제가 눈에 띄게 느리다면, 이는 대개 SafePassage 자체의 문제라기보다 KeePass 데이터베이스에 설정된 Argon2 메모리/반복 파라미터(사용 중인 KeePass 클라이언트의 데이터베이스 보안 설정에서 조정 가능) 때문일 가능성이 큽니다.

소스에서 빌드했는데 플러그인이 나타나지 않음#

저장소 체크아웃 안에서 빌드만 한 것이 아니라 main.js, manifest.json, styles.css 를 실제로 <your-vault>/.obsidian/plugins/safe-passage/ 로 복사했는지 확인한 뒤, Obsidian을 재시작하고 설정 → 커뮤니티 플러그인 에서 SafePassage 를 활성화하세요. 설치 을 참고하세요.