Our app requires a Jira and Jira Servicemanagement administrator to take action at some point in the setup process. Therefore, we strongly recommend involving booth administrators from the start to ensure a seamless implementation of the Assets Owner for Jira app in your company or team.
Step 1: Install Jira App
[Insert Pic of store page]
Install [link to store page]
Permission necessary: Jira Admin
Step 2: Get all the necessary information
Before you can configure the app, you'll need an API token from your Jira Servicemanagement administrator (hereafter referred to as "JS administrator"). This token allows the app to securely access data from your Jira instance. To get started, the JS administrator should follow these steps:
Access Jira Settings: While logged in as the JS administrator, click the settings wheel icon in the top-right corner of the Jira header.
Open Account Settings: From the dropdown menu, select 'Atlassian account settings'. This opens the account settings in a new browser window or tab.
If you're logged in with multiple Atlassian accounts, you'll see a window asking you to select an account. Choose the Jira Service Management administrator account to proceed.
In your Atlassian account settings, you'll see a navigation bar at the top. Click on the Security tab to access your security settings. (See the image below for reference.)
On the Security page, scroll down to the 'API tokens' section. You'll find a link labeled 'Create and manage API tokens'. Click this link to proceed.
Click the 'Create API token' button. In the popup, give the token a descriptive name (e.g., 'Assets Owner for Jira'), then click Create. Copy the generated token (you'll see a 'API token copied to clipboard' message). Finally, click Done.
Important: After copying the API token, it's highly recommended to paste it into a temporary document (like Notepad on Windows or TextEdit on macOS). This is crucial because the token is only displayed once. After you close the window, you won't be able to get it again!
Note: If you do lose your token, you can easily revoke it and generate a new one by following these same steps.
Step 3: Configure App
To access the Configuration Page, go to Apps > Manage your apps.
After navigating to 'Manage your apps', you'll see a sidebar on the left side of the screen. Scroll down this sidebar until you find the 'Assets Owner for Jira' label. Underneath that label, click on the 'Configuration' Page.
The Configuration Page allows you to set up the 'Assets Owner for Jira' app. As shown in the screenshot below, you'll need to provide two pieces of information:
Email: Enter the email address of the Jira Servicemanagement Administrator account.
API Token: This unique token authorizes the app to access Jira's API. Don't worry if you don't already know how to get this token – we'll walk you through how to generate it in the next step.
