Migration of Security & Encryption Confluence from server to cloud is currently not supported but we can help...

Migrating Confluence Server pages containing Security and Encryption macros will not work. The migrated macros would display as "unknown macro", but it should not affect any other content. Currently, ServiceRocket does not have any migration path for this app, due to security implications and the common security-related use cases for this app. Nevertheless, we're tracking the interest and feasibility of providing a migration path for Security and Encryption from Server to Cloud here. If this were to change and a migration path is available in the future, we will update the tracker page.

This page outlines the steps to manually transfer some of your configurations and app data from our Server product to Cloud.

At the end of this guide, you will have:

  • Understand the Feature differences between Security & Encryption for Confluence server and cloud.
  • Have an idea & be able to gather all the app data that you would like to bring to Cloud
  • Understand the options that you have to bring these data to Cloud

Prework

Before you start, consider the following:

  • Review the feature differences documentation
    • Security and Encryption for Confluence Cloud provides a new user experience of storing and decrypting passwords. We recommend you understand the Feature differences.
  • Review the rest of the administrator guides
    • Security and Encryption for Confluence Cloud offer some new features and settings that were not available in the Server Connector. We recommend you review the settings as per the Administrator Guide.
  • Review the user guides
    • It might be helpful to send your users some resources to get familiar with the New Connector. Take a look at our User Guide.

Manual migration guide

Step 1: Find all Secure macros on your site

Option 1 : Use the Macro Usage details page to alert users on all impacted pages which currently contain Secure macros.
  1. Go to Administration > Macro Usage.
    1. Alternatively, admins can access the Macro Usage admin page via the shortcut <base-url>/admin/pluginusage.action.
    2. Or with CQL, they can search by space (or any other parameters required). For example:  macroName=secure AND spacekey=<spacekey>
  2. Look under Security and Encryption.

     
  3. Click on the link for secure. This will give you a list of pages that contain Secure macros.
Option 2: Use the SQL below (please test thoroughly first). This SQL will provide a list of impacted users and the relevant page titles which currently contain Secure macros. 

 (warning) This is a postgre-sql query syntax, please adjust usage according to your Database syntax. Also limit the outcome to a smaller scope if needed (using limit may help) to avoid performance issues.

select s.spacekey, s.spacename, c.title as "Page Title", um.username
from content c, spaces s, user_mapping um left join cwd_user cu on um.username = cu.user_name
where c.spaceid = s.spaceid and c.contenttype = 'PAGE' and c.prevver is null and c.content_status = 'current'
and c.creator = um.user_key
and c.title in
(SELECT c.title
FROM CONTENT c
JOIN BODYCONTENT bc
    ON c.contentid = bc.contentid
JOIN SPACES s
    ON c.spaceid = s.spaceid
WHERE c.prevver IS NULL
    AND c.contenttype IN ('PAGE', 'BLOGPOST')
    AND bc.body LIKE '%ac:name="secure"%')
order by s.spacekey, c.title

Step 2: Moving the content manually

  1. In Confluence Server, find the page that contains the Secure macro(s).|

  2. Edit the page. Select the Secure macro and Edit Click on the Secure macro.

     

    Remember that only the Secure macro creator and authorized users can edit the macro. 
  3. Take note of all the content inside, including the Details of the macro, as well as the Users or Groups that should / should not be able to access

  4. In Confluence Cloud, create a new Secret macro. Either select from the macro browser, or use the keyboard shortcut ( "/" for new editor or "{" for old editor).

  5. In the Insert Secret Macro window, paste the title, description and content you have copied from step 3. 

    Remember that you will need special permissions to be able to create Secret macros. Learn more here.
  6. Continue with the Access tab and re-configure this app to have the same access details as you have noted from step 3. Then click Insert or Save to continue.

  7. Repeat the copy-and-paste steps for all your Secure macros.
  8. When you're done, remember to Publish the page.



To go back to the migration hub, click here.