OAuth 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 OAuth” and click on Free Trial for the miniOrange OAuth/OpenID Connect(OIDC) Jira SSO App for eg. miniOrange OAuth/OpenID Connect(OIDC) 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 OAuth SSO for your Atlassian application.
  3. Select the app (for eg. https://marketplace.atlassian.com/apps/1217688/oauth-openid-connect-oidc-for-jira-sso?hosting=server&tab=overview ) from the search result.
  4. Click on the 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 Atlassian.
  2. Navigate to the “Manage Apps” page of your instance (the “Install” section in older versions).
  3. Locate your installed miniOrange OAuth/OpenID Connect(OIDC) Jira 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!