(3.x) 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
- In Confluence, select Manage apps from the Confluence Administration menu in order to go to the Atlassian Marketplace for Confluence
- Select Find new Apps and search for S/Notify Email Encryption
- Click the Free trial button for a free evaluation (of course, you may click Buy now, if you have already evaluated S/Notify)
- 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
- 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
- Copy this jar file to <YourConfluenceInstallationDirectory>/confluence/WEB-INF/lib
- 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.
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
- In Confluence, select Manage apps from the Confluence Administration menu
- Find S/Notify in the list, expand its entry, then click Get started
- 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
- Log in with an administrative user who has a public S/MIME certificate or public PGP key available
- Go to the user's profile
- At section S/Notify, click Email Security
- Upload a public S/MIME certificate or public PGP key suitable for this user's email address
- Navigate to General Configuration > Mail Servers and click on Send test email to quickly send an email to yourself
- The email should immediately be sent to you encrypted
To test a notification email generated by Confluence
- Prepare as described above, except that you do not need an administrative user
- To simplify testing, in the Preferences section of the user profile, set My Changes to Notify me
- Create a Confluence task
- Modify the Confluence task
- 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 (3.x) 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 (3.x) Updating and Upgrading.