// secret notes for confluence

Security &
Privacy.

A factual overview of how Secret Notes for Confluence handles sensitive note content, page storage, copy-safety, permissions, retention, and platform boundaries.

// summary

Runs on Atlassian, without an external backend.

Secret Notes for Confluence is built as an Atlassian Forge app. You drop a Secret Note element into a page and store a password, token, key, or certificate in it; the plaintext lives only in the Atlassian Forge Secret Store, never in the page.

HostingHosted on Atlassian Forge infrastructure. No Forge Remote and no external Verdaro Labs app server for secret handling.
Secret storageSecret plaintext is stored in the Atlassian Forge Secret Store. Non-secret metadata is stored separately in Forge KVS.
Nothing in the pageThe page body stores only an opaque reference id. The secret and its metadata are never written into the page, its version history, the search index, or exports.
No telemetryNo analytics, advertising trackers, third-party telemetry, or external error-reporting SDKs are used by the app.
// data processed

What data the app handles

Secret payload

The sensitive text entered by the user, such as passwords, tokens, certificates, private keys, or other confidential content. This is stored in the Forge Secret Store and never written into the page.

Note metadata

Note label, the bound page identifier, Atlassian site/cloud identifier, creator metadata, selected reveal audience (users/groups), guest setting, expiry/status information, counters, and metadata-only audit events.

// storage boundaries

Where plaintext is not written

The app is designed to avoid the common problem of secrets being pasted into the page body, where they leak into exports, version history, and search.

Not the page bodyThe page stores only an opaque reference id as the macro parameter, never the secret or its metadata.
Not version historyEvery historical version of the page contains only the opaque token, never the secret.
Not exportsPDF, Word, and space exports render a neutral placeholder; the secret is never serialized into an export.
Not the search indexConfluence indexes page storage; the token is meaningless and the plaintext was never there.
Not normal KVS metadataForge KVS stores note metadata, not the secret plaintext payload.
Not logs or audit eventsAudit events are metadata-only and do not contain the revealed secret value.
Not Verdaro Labs serversThe app does not send secret plaintext to an external Verdaro Labs backend.
// copy-safety

Copying a page does not copy the secret

Each secret is bound server-side to exactly one page. When a page is copied, the copied element carries the same opaque reference, but the app refuses to reveal it on the copy because the copy is a different page. A copied reference is a dead link, not a leak.

Moving a page (which keeps the same page identity) keeps the secret revealable for authorized users; copying does not.

// access control

Permission and reveal model

Authorization is enforced server-side in Forge resolvers using the Atlassian-signed account identity. The browser UI is not treated as a security boundary for reveal, revoke, visibility, or audit decisions.

  • The element only renders for users who can already view the page, so page permissions and restrictions form the first access floor.
  • Creators can reveal, replace, and revoke their own notes, and see the note's audit trail.
  • A note can be available to anyone who can view the page, restricted to selected users and/or groups, or limited to the creator only.
  • External/guest collaborators are blocked by default and can reveal only when the creator explicitly allows guests on a page-viewers note.
  • Anonymous users are blocked from reveal access.
// lifecycle

Expiry, deletion, and audit

Read onceRead-once notes require confirmation and are designed to self-destruct after the first reveal.
Time limitsNotes can expire after 1 hour, 24 hours, or 7 days. “No expiry” notes remain until revoked, with a 365-day Forge Secret Store TTL backstop.
Manual revokeCreators can revoke a note at any time to destroy the secret immediately — including when a Marketplace subscription has lapsed.
CleanupExpired and destroyed secrets are cleaned up best-effort during normal app operations.
Page deletionWhen a whole page is deleted, the app purges the secrets bound to that page; the hard TTL backstop covers any gap.
UninstallThe app includes an uninstall handler designed to purge tenant app data when the app is uninstalled, subject to Atlassian platform behavior and backups outside direct app control.
User anonymizationThe app handles Atlassian user anonymization by scrubbing stored user references in note metadata.
// important boundary

Clipboard and user handling

When a user reveals or copies a secret, that plaintext leaves the protected storage context and becomes visible to that user. If copied, it enters the operating-system clipboard.

Clipboard managers, browser extensions, operating-system sync features, or other tools outside the app may retain clipboard contents. Secret Notes warns users about this boundary, but cannot control software outside the Forge iframe.

// questions

Security or privacy question?

For app security, privacy, or Marketplace review questions, contact Verdaro Labs through the support channel.

Open support