Skip to end of banner
Go to start of banner

Creating and editing secrets

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

By mid-October 2023, an improved version of Security & Encryption for Confluence Cloud will be released. Users will enjoy enhanced security

Overview

Storing sensitive information on Confluence Cloud is simple with the Secret macro. The macro encrypts sensitive information before it gets transmitted over the network and before it gets saved in Confluence. This way, you can securely store and share sensitive information while collaborating with your team members on Confluence.

Secret macros belong to the space. This means they are automatically accessible by anyone who can access the space and is part of the macros access control configuration. More details are available on this page


Creating a secret

Either

  • search and select Secret from the macro browser

  • or use the keyboard shortcut ( "/" for the new editor or "{" for the old editor)

The Insert Secret Macro window is displayed.

  • enter the Title

This is the text that will appear to anyone who is viewing the secret block.

Try to give it a clearly distinguishable title, for example, "Acme Corp Twitter account" or "PSK: vpn.acme.com".

  • enter a Description

A description is recommended so that users can easily get more information about the secret. You can add something meaningful, for example, "Acme Corp's official Twitter account" or "The pre-shared key for global VPN".

  • enter the sensitive information that you would like to encrypt and store in the Secret field

This field accepts single or multi-line text characters and emojis.

  • choose the Access tab to set access restrictions

The Allow access to the following users and groups option will be selected by default.

To make the Secret accessible to specific users and groups

  • type in a user or user group name

The "Deny access" control is now deprecated, and is no longer available in the latest version of this app. For more details, refer to this KB article.

  • add other users or groups as owners under User Owners or Group Owners

One of the User Owners or Group Owners must have a value, if not the Secret macro configuration cannot be saved

Secret Owners and Secret Users

By default you are the Owner of the secret because you are its creator

  • Owners can access and change the contents of a Secret, whereas Users are limited to read-only access

  • Owners can also add/remove access to Secrets

As an Owner, type in the field to search for a Confluence user or click to select from a menu.

  • both users and groups who are Owners of the macro have similar access and edit abilities

  • a member of a secret Group Owner will be automatically made a User Owner when they edit the secret that the group owns

If the Users and User Groups fields blank are left blank, then only you (the owner of the secret) will be able to view it.

After choosing Insert, you'll have something that looks like below in the Confluence editor.

  • Publish the page to see the results


Editing a secret

A Secret macro can only be edited by a user who is the owner of the macro.

In the page editor

  • choose the Secret macro you would like to edit

When the Secret macro block is highlighted

  • choose the pencil icon to edit the macro

  • make the needed changes to any field

  • choose Save

  • Publish/Update the page

  • No labels