Atlassian SAML Handbook

Installation

There are two methods to install the app and use it on your Atlassian applications for Single Sign-On (SSO). The two methods are explained below.

Note: You must have administrative rights to install an add-on.

1. Directly from the Atlassian Marketplace

You can install the plugin directly from the Atlassian application’s admin console.

  1. Log in to the application with an admin account.
  2. Navigate to the administration section. You may need to log in again.
  3. Choose Manage apps and on the left navigation menu bar and click on Find new apps (Find new add-ons on the older versions)
  4. Search for “miniOrange SAML” and click on Free Trial for the miniOrange SAML SSO App for eg. SAML Single Sign On (SSO), JIRA SSO.
  5. Click on Accept & Install
  6. Once the installation is complete, click on Get License. You will be redirected to MyAtlassian for generating a license.

2. Installing by file upload

1. Download app

  1. Navigate to the Atlassian Marketplace.
  2. Search for miniOrange SAML SSO for your Atlassian application.
  3. Select the app (for eg. JIRA SAML Single Sign On (SSO), JIRA SSO) from the search result.
  4. Click on Try it free button.
  5. You will be asked to select your application’s hosting type(Server or Datacenter) and then click on the start free trial link.
  6. Enter your organization name and click on the Generate License button.
  7. You will see the license key along with the link to download the add-on.

2. Install add-on

  1. Log in to the application with an admin account.
  2. Navigate to the administration section. You may need to log in again.
  3. Choose to Manage apps and on the left navigation menu bar.
  4. Click on the Upload app link and upload the jar file downloaded in the last step.

3. Apply license key

  1. Keep your generated license copied from MyAtlassian.
  2. Navigate to the “Manage Apps” page of your instance (the “Install” section in older versions).
  3. Locate your installed SAML Single Sign On (SSO) add-on in the list.
  4. Click the app entry and paste the license into the license box for your add-on. All done!