SafePassage documentation

README (한국어)

SafePassage is a secure, lightweight Obsidian plugin that links your local KeePass databases (.kdbx) to your vault, rendering masked credential chips and structured tables directly inside your notes — without ever storing your master passwords or secrets in plain text.

Contents:

• Prerequisites
• Installation
  • Method 1 — Install from Obsidian’s Community Plugins browser
  • Method 2 — Clone the Git repository and build from source
• Usage
  • Setting up a database profile
  • Masked inline chips
  • Credential tables
  • Inserting new credentials
  • Clipboard behavior
  • Locking a database
• Architecture
  • WebAssembly Argon2 engine
  • Vault-relative file access
  • In-memory session keyring
  • Session expiry and locking
  • Protected field values
  • Clipboard sanitation
  • Inline chip and table rendering
• Troubleshooting & FAQ
  • “Database file not found in vault: …”
  • A chip shows “Missing Profile” or “Missing Entry”
  • A chip stays locked even though I unlocked that profile before
  • Writing a new secret fails
  • Clipboard is not clearing automatically
  • The plugin freezes briefly when unlocking a large database
  • The plugin does not appear after building from source