docs(insomnia): plugin sandbox, permissions, and troubleshooting pages (draft) - #6597
Draft
jackkav wants to merge 6 commits into
Draft
docs(insomnia): plugin sandbox, permissions, and troubleshooting pages (draft)#6597jackkav wants to merge 6 commits into
jackkav wants to merge 6 commits into
Conversation
✅ Deploy Preview for kongdeveloper ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
4 tasks
…ooting pages from the plugins landing page
'Trusted' is an internal-only label (never surfaced in the UI) for built-in plugins the user can't install or change, so it doesn't warrant a security-flavoured name in public docs. Rename the execution mode to 'Internal' and describe built-in plugins neutrally. Also drop the retired templateTagSandboxEnabled flag from the migration prose and the caveats, now that pluginSandboxEnabled is the single flag.
- permissions: resolve the pre-publish module-list TODO with the canonical set (path, crypto, events, ajv, uuid); drop the OAuth-token credential warning callout - sandbox-and-trust: remove the retired template-tag experiment note, the internal-only 'Internal' execution mode row (+ its built-in caveat), and the 'What changed' release-notes table - troubleshooting: trim the fixed-bug caching backstory to the actionable reload instruction
Covers both a duplicate user folder and a name reserved by Insomnia (the bundle-plugin impersonation rejection added in #10376), with a single rename fix, matching the updated 'ambiguous or spoofed trust grant' error.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Insomnia plugin sandbox docs (draft)
Adds three reference pages under
app/insomnia/plugins/documenting the sandboxed plugin model, registers them in the Insomnia nav (app/_indices/insomnia.yaml), and links them from the plugins landing page (app/_landing_pages/insomnia/plugins.yaml). Opened as a draft to iterate on.New pages
sandbox-and-trust.md) — in-process vs the QuickJS sandbox, thepluginSandboxEnabledsetting, the execution modes shown as badges in Preferences > Plugins (Sandboxed / Elevated / In-process), the per-plugin Full host access (elevated) opt-in, and a migration guide for existing plugins.permissions.md) — theinsomnia.permissionsmanifest (modules+capabilities), the default-deny baseline, and the capability + module reference (canonical module set:path,crypto,events,ajv,uuid).troubleshooting.md) — the "my plugin disappeared → disabled row with a reason" behavior, reload-recovers-after-fix, plugin name-conflict resolution, and the currentcontext.app.dialog()DOM limitation (Kong/insomnia#10292).These complement the existing
plugin-reference,context-object-reference, andhooks-and-actionspages (no overlap).Scope notes
pluginSandboxEnabledflag; the earliertemplateTagSandboxEnabledexperiment is retired and migrated automatically) and #10376 (bundle-plugin name-impersonation rejection).Frontmatter, callout syntax, and nav registration follow the existing plugin pages.
🤖 Drafted by Claude Code