SSH Key Management¶
Manage SSH keys from a dedicated window.
Open: Shift+Cmd+K, Window → SSH Key Management, or Manage SSH Keys… in Settings > General
Overview¶
| Feature | Description |
|---|---|
| Import | Add private keys from any location, including ~/.ssh/ |
| Generate | Create new ED25519 keys |
| Validate | Check key security and format |
| Filter | Find keys by type or status |
Window Layout¶
Main table: Your keys with toolbar, filter, and search (Search Keys).
Inspector (right): Selected key details, security info, and actions. Show or hide it with Alt+Cmd+I.
Importing Keys¶
Drag and Drop¶
Drag SSH key files from Finder into the key list, or click Import (Cmd+I). StormTunnel stores imported private keys in your macOS Keychain. Onboarding also offers to import keys from ~/.ssh/.
Supported Files¶
- Private keys:
.pem,.key, or no extension (e.g.,id_rsa,id_ed25519) - Keys in the legacy format may need conversion; StormTunnel explains how.
Generating Keys¶
- Click Generate in the toolbar (or Generate Key… when the list is empty)
- Enter a descriptive name
- Review the filename preview
- Click Generate
StormTunnel generates ED25519 keys.
Naming Rules¶
- Allowed: Letters, numbers, spaces, hyphens, underscores
- Max length: 50 characters
- Must be unique
Filtering Keys¶
Use the dropdown filter:
| Filter | Shows |
|---|---|
| All Keys | Everything |
| Valid Only | Keys that passed validation |
| Needs Attention | Keys with security issues |
| Encrypted | Password-protected keys |
Use the search bar to find keys by name.
Key Details¶
Select a key to see:
- Name, type (ED25519, RSA, etc.), and import date
- Security level, validation status, and encryption status
- Public key and fingerprint (after validation)
Security Levels¶
| Level | Meaning |
|---|---|
| High | Strong encryption, modern algorithm |
| Medium | Acceptable, older algorithm |
| Low | Weak, consider replacing |
Key Types¶
| Type | Status |
|---|---|
| ED25519 | Recommended for all new keys |
| RSA | Legacy, widely compatible |
| ECDSA | Supported for import only |
Actions¶
Right-click a key (or use the inspector) for:
- Validate -- Check security and format
- Show in Finder -- Open the key's file location, when it has one
- Copy Public Key -- Copy to clipboard for server setup
- Delete… -- Remove the key from StormTunnel
Right-click the fingerprint in the inspector to Copy Fingerprint.