Installation - S/Notify for Bitbucket

Please note that we've decided to move our support portal to help.savignano.net to to further improve the services for our customers.

The updated version of this page can be found at https://help.savignano.net/snotify-email-encryption/installation-s-notify-for-bitbucket


Initial Install

Prerequisites

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

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

  1. In Bitbucket, select Manage apps from the Bitbucket Administration menu in order to go to the Atlassian Marketplace for Bitbucket
  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/bitbucket/releases/ 
    (previous versions can be found in the subfolder archive)
    • net.savignano.s-notify.bitbucket.mailer-x.x.x.jar
  2. Copy this jar file to <YourBitbucketInstallationDirectory>/app/WEB-INF/lib 

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

 Show me how ...

Either make the library component readable for all:

sudo chmod +r <YourBitbucketInstallationDirectory>/app/WEB-INF/lib/net.savignano.s-notify.bitbucket.mailer-x.x.x.jar

Or make the Bitbucket user owner of the library component:

sudo chown bitbucket <YourBitbucketInstallationDirectory>/app/WEB-INF/lib/net.savignano.s-notify.bitbucket.mailer-x.x.x.jar

On multi-node installations of Bitbucket, this step needs to be done on each node.


Step 3: Restart Bitbucket to activate S/Notify 

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

Atlassian: Start and stop Bitbucket

Step 4: Verify the installation

  1. In Bitbucket, select Manage apps from the Bitbucket 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 Bitbucket users to take a look at 

  • User Settings – for users to view and optionally upload their own PGP key or S/MIME certificate
  • Project Settings NOT SUPPORTED YET – 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 account settings (Manage account)
  3. From the options on the left, select Email Security
  4. Upload a public S/MIME certificate or public PGP key suitable for this user's email address
  5. From the Administration panel, select Mail Server (under category System), scroll down to Send a test email, and send an email to yourself
  6. The email should immediately be sent to you encrypted

To test a notification email generated by Bitbucket

  1. Prepare as described above, except that you do not need an administrative user
  2. To simplify testing, in the Notification settings of the user account, set both Send notifications for both, pull requests and watched repositories, to Immediately
  3. Start watching a repository if not doing already: Projects > click on a project > click on a repository (or create one) > click on Watching and select All branches and All pull request activity
  4. Log in as another user who has access to that repository
  5. Go to the repository, create a branch, edit a file and then select Create pull request for this change
  6. A notification email about the modification should be sent to the first user after a while, 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 Bitbucket or both, please refer to Updating and Upgrading.




The S/Notify Email Encryption apps are brought to you by savignano software solutions, a small yet savvy IT solutions company in Germany. Click here for legal information.