Skip to main content
Skip table of contents

Installation - S/Notify for Confluence

Initial Install

Note that apps were called add-ons in earlier versions of Confluence. So when we refer to apps, this is synonymous with add-ons

Prerequisites

  • You need administration rights in your Confluence, so you can install apps from the marketplace
  • You need write access to the library folder of your Confluence installation, so you can add jars to it 

Step 1: Install the S/Notify UI from the Atlassian marketplace

  1. In Confluence, select Manage apps from the Confluence Administration menu in order to go to the Atlassian Marketplace for Confluence
  2. Select Find new Apps and search for S/Notify Email Encryption
  3. Click the Free trial button for a free evaluation (of course, you may click Buy now, if you have already evaluated S/Notify)
  4. Follow the instructions

The S/Notify UI component will then be downloaded, installed, and activated. However, emails will not be encrypted until the library component has been installed as explained in step 2 and 3. 

Step 2: Download and install the S/Notify library component 

  1. Download the S/Notify library component from https://download.savignano.net/snotify/confluence/releases/ 
    (previous versions can be found in the subfolder archive)
    • net.savignano.s-notify.confluence.mailer-x.x.x.jar
  2. Copy this jar file to <YourConfluenceInstallationDirectory>/confluence/WEB-INF/lib 
  3. If you are running Confluence in a version from 7.0 through 7.4, make sure to check our info on Confluence 7.0-7.4 compatibility

Make sure that the the library component is readable by the Confluence user. 

Show me how ...

Either make the library component readable for all:

sudo chmod +r <YourConfluenceInstallationDirectory>/confluence/WEB-INF/lib/net.savignano.s-notify.confluence.mailer-x.x.x.jar

Or make the Confluence user owner of the library component:

sudo chown confluence <YourConfluenceInstallationDirectory>/confluence/WEB-INF/lib/net.savignano.s-notify.confluence.mailer-x.x.x.jar

Data Center customers need to do this for each node.


Step 3: Restart Confluence to activate S/Notify 

It is necessary to restart Confluence after the installation in order to activate the library components.

Atlassian: How to start and stop Confluence

Step 4: Verify the installation

  1. In Confluence, select Manage apps from the Confluence Administration menu
  2. Find S/Notify in the list, expand its entry, then click Get started
  3. S/Notify will check if it is ready to encrypt emails and display an info about the result

How To Proceed

We recommend that you perform a Quick Test to verify that S/Notify is working correctly.

To configure S/Notify to suit your needs, go to

  • Encryption Settings – to configure how and when encryption should be used
  • User Key Management – to manage your users' public PGP keys and S/MIME certificates required to encrypt outgoing emails
  • Server Key Management – to manage the server's private PGP keys and S/MIME certificates required to  sign outgoing emails

You might want to invite your Confluence users to take a look at 

  • User Settings – for users to view and optionally upload their own PGP key or S/MIME certificate
  • Space Settings – for space administrators to view and optionally control encryption for emails referring to their spaces


Quick Test 

The easiest and quickest way to verify the installation is 

  1. Log in with an administrative user who has a public S/MIME certificate or public PGP key available
  2. Go to the user's profile
  3. At section S/Notify, click Email Security
  4. Upload a public S/MIME certificate or public PGP key suitable for this user's email address
  5. Navigate to General Configuration > Mail Servers and click on Send test email to quickly send an email to yourself
  6. The email should immediately be sent to you encrypted

To test a notification email generated by Confluence

  1. Prepare as described above, except that you do not need an administrative user
  2. To simplify testing, in the Preferences section of the user profile, set My Changes to Notify me
  3. Create a Confluence task
  4. Modify the Confluence task
  5. A notification email about the modification should be sent to you after a while (may take a few minutes), and it should be encrypted

If the tests do not work, we recommend that you check out the FAQ for possible solutions – or open a ticket at our help desk.

How To Update

For recommendations with regard to updating S/Notify or Confluence or both, please refer to Updating and Upgrading.





JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.