Get Started

Get Started

 

When you launch the Flexible User License app for the first time after installation, the Get Started page appears. This page provides step-by-step guidance with links to essential setup tasks required before using the app. Each step directs you to the corresponding configuration screen. If a step has already been completed, you can skip it and proceed to the next.




Getting Started Steps

Complete the following steps before using the Flexible User License app.

 

1. Login to your Jira Cloud site.

2. Go to Apps > Flexible User License in the left-side bar.

3. If you installed the Flexible User License app and launched it for the first time, you will see the following Get Started page. Complete the necessary settings at each step.

 

Step 1: Check IP Allowlist and Configure Cloud Server IP (Premium Plan Only)

Check or add the IP allowlist. If your IP allowlist is already configured, click Skip IP Allowlist Check to proceed to the next step.

  • Check IP Allowlist: Go to Jira Admin > Security > IP allowlists and add the IP address of the server where the Flexible User License app is installed.

  • Skip IP Allowlist Check: If IP allowlist verification is not required, skip this step and continue to the next step on the Get Started page: Create and Copy API Key.

  • Learn more about checking the IP allowlist: Opens the Atlassian support guide for managing IP allowlists.

  • Learn more about configuring the Cloud Server IP: Opens the Open Source Consulting Apps Support page. If you need assistance with the server IP used by Flexible User License, please contact us via the support page.

 


Step 2: Create and Copy API Key

To use the Flexible User License, create an API key from the Atlassian Admin settings page and copy it to apply in the app. Keep the copied API key secure, and contact your organization administrator for more information about API key creation.

image-20250702-044252.png
  • Create API Key: Go to Atlassian Admin > Settings > API keys, and create a new API key.

  • Learn more about creating an API key: Opens the Atlassian support guide on how to generate API keys.

  • Enter API Key: Paste the generated API key into the required field, then click Save.

image-20250702-062316.png

Important: To use this app, you must select the API key without scopes option when creating your API key. The app will not work if this option is not selected.

image-20250729-064530.png

 

For more information about API keys, refer to the Atlassian support guide.

 


Step 3: Create and Copy API Token

To use the Flexible User License, create an API token from Atlassian Account Security and copy it to apply in the app. Keep the copied API token secure.

image-20250702-063436.png
  • Create API Token: Go to Atlassian Account > Security > API tokens, and Create API token.

  • Learn more about creating an API token: Opens the Atlassian support guide on how to generate API tokens.

  • Enter API Token: Paste the generated API token into the required field.

  • Email: Enter the administrator’s email address and click Save.

Important: To use this app, you must select the Create API token button when creating your API token. The app will not work if this option is not selected.

image-20250729-064930.png

 

For more information about API Token, refer to the Atlassian support guide.

 


Step 4: Verify Your Domain (Optional)

Domain verification proves ownership of all user accounts within the domain and enhances user account management. It also allows you to grant product access to users with different domains.

image-20250702-064559.png
  • Verify Your Domain: Click Verify your domains from the organization you are working on.

  • Learn more about domain verification: Opens the Atlassian support guide on how to verify a domain.

For more information about domain verification, refer to Verify a domain to manage accounts.

The Guide Page will not appear once the Configuration settings are completed.

Once you complete the Verify Your Domain step, the Done button becomes active. Click Done to finish the Get Started process.

image-20250707-232451.png

 


Quick Start for Existing Users

If you’ve already configured your API information, you’ll see this welcome screen when launching the upgraded Flexible User License app for the first time.
Click Get started to begin using the app right away—no additional setup is required.

1560ddd4-cd5d-4880-af46-6f25d7b1e4c5.png