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

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

## Overview

The [Secret](https://appfire.atlassian.net/wiki/spaces/SECC/pages/477727234) macro secures the creation, transmission, storage and retrieval of sensitive information while you collaborate with your team members on Confluence. 

When you work with a Secret macro, the encryption and decryption process is done locally on your web browser, making the whole process of handling sensitive information extra secure. 

## Requirements

To access encrypted information from the secret macro, you must meet the following conditions:

- access to the space where the Secret macro belongs to
- you are the secret owner
- you are one of the users that has permission in the macro

> ℹ️ <span style="color: #172b4d">To gain access to a secret</span>
> ℹ️ 
> ℹ️ - <span style="color: #172b4d">with only group owners, you need to be a part of the Confluence group. Contact the administrator to be a member of the Confluence group</span>
> ℹ️ - <span style="color: #172b4d">with an individual user owner, contact the user owner to get access</span>

## Accessing a secret

On the Secret macro block

- choose the **Decrypt** button

![image](media://8fe79826-bad2-4e09-9178-8c876fe66dc3)

If you ***don't have sufficient permission***, the following error message is displayed.

![image](media://8262123a-6951-4271-9cba-66a1dbd03d94)

If ***you have permission***,  the macro block is displayed expanded with the successfully decrypted information masked in asterisks.

![image](media://ce3335ed-7f32-4d09-85bd-d624faf9a6f9)

- choose **Copy**
  - to copy the sensitive information into your computer clipboard and paste it elsewhere
- choose** Reveal**
  - to see the decrypted information

![image](media://785591f6-f7b8-482f-8d46-002b278c85ab)

- choose the **X** button in the macro to hide the sensitive information

> ℹ️ If the **X** is not chosen, the secret is hidden automatically after 15 seconds.

## Sharing a secret

Sharing a secret doesn't automatically grant your team members access to the secret macro. You need to edit the macro access control settings to set appropriat access permission.

There are two options to share a secret with your team members

### Option 1 - Share the Confluence page

On the page containing the secret macro

- select the **Share** button
- enter name, group, team or email of the team members

![image](media://54e25037-7238-4588-8137-2e57f22ebbd8)

- choose **Send **to send an email notification from Confluence

> ℹ️ Alternatively, copy the URL of the page from the web browser address bar and share this link with your team members.

### Option 2 - Share a direct link to a Secret

In the Confluence left hand side menu

- choose **Secret List**

![image](media://65c344b8-f4ea-484f-8b2c-041bb92cdd67)

- choose the title of the secret you would like to share

> ℹ️ A page is displayed containing details of the Secret.

![image](media://d51f7f99-395d-4c74-a2c0-a5bdf416e383)

- choose **Copy link** to copy the link to your computer clipboard
- share the link as required with your team members