---
title: "Creating and editing secrets"
canonical: "https://support.appfire.com/space/SECC/477726008/Creating%20and%20editing%20secrets"
format: markdown
---
> Macro (aura-html)

> ℹ️ [DECember 2023]  We have released an improved version of Security and Encryption for Confluence Cloud with enhanced security. Check out the [next steps for administrators](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477727589).

## Overview

Storing sensitive information on Confluence Cloud is simple with the [Secret](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477727234) 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.

- [Creating a secret](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726008/Creating+and+editing+secrets#cresec)
- [Editing a secret](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726008/Creating+and+editing+secrets#edsec)
- [Secret Owners and Secret Users](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726008/Creating+and+editing+secrets#secownuser)

> ℹ️ 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
> ℹ️ 
> ℹ️ - [Using and sharing secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726002)

---

## > Macro (anchor)

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**

![image](media://56962b68-b0ba-425e-bb6b-1e844191a494)

> ℹ️ 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](http://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

![image](media://823447a0-9104-482f-857e-b1488daf3a0f)

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

- <span style="color: #172b4d">choose the </span>**Access **tab to <span style="color: #172b4d">set access restrictions</span>

> ℹ️ <span style="color: #172b4d">The </span><span style="color: #172b4d">**Allow access to the following users and groups**</span><span style="color: #172b4d"> option will be selected by default.</span>

<span style="color: #172b4d">To make the Secret accessible to specific</span> users and groups

- type<span style="color: #172b4d"> in a user or user group name</span>

![image](media://db95ca57-4778-41b4-af9e-646e1a6591bc)

> ⚠️ 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](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726509).

- 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

## > Macro (anchor)

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
- <span style="color: #172b4d">**Owners**</span><span style="color: #172b4d"> can also add/remove access to Secrets</span>

> ✅ <span style="color: #172b4d">As an </span><span style="color: #172b4d">**Owner**</span><span style="color: #172b4d">, type in the field to search for a Confluence user or click to select from a menu.</span>

- 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

![image](media://93eaa6d3-d098-4780-b07a-3e4f712edb8c)

> ℹ️ 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.

<span style="color: #172b4d">After choosing </span><span style="color: #172b4d">**Insert**</span><span style="color: #172b4d">, you'll have something that looks like below in the Confluence editor.</span>

![image](media://870036c2-2df4-4d60-8a3b-a526c7155db9)

- <span style="color: #172b4d">**Publish**</span><span style="color: #172b4d"> the page to see the results</span>

![image](media://55a93e79-99c0-4e01-b009-6f39bc5a5c67)

---

## > Macro (anchor)

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

## Related pages

- [Using and sharing secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477726002)
- [Searching and listing secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477725657)
- [Deleting secrets](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477725968)
- [Secret (macro)](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477727234)