...
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Step 1: Install Jira App
[Insert Pic of store page]
...
Install https://marketplace.atlassian.com/apps/1235753?tab=overview&hosting=cloud
Permission necessary: Jira Admin
...
Email: Enter the email address of the Jira Servicemanagement Administrator account.
API Token: This unique token authorizes the app to access Jira's API. (If you haven't generated an API token yet, or if you've lost it, please refer to Step 2 for instructions on how to obtain it.)
...
You have the option to change the Encryption String. This string is like a secret code used to protect your sensitive information (email, API token, and visibility settings). It's highly recommended to personalize this string to enhance security.
Note: For a detailed explanation of how your data is stored and secured, click here.
...
The diagram below illustrates how 'Assets Owner for Jira' safeguards your sensitive information in our database:
Initial Encryption: Your data (email, API token, Encryption String and visibility settings) is encrypted using the unique Encryption String you set in the Configuration Page. This adds a first layer of protection.
Secondary Encryption: The already encrypted data undergoes a second round of encryption using a secret, undisclosed string. This adds an extra layer of security.
Secure Storage: Finally, the double-encrypted data is safely stored in our database, ensuring maximum confidentiality and protection against unauthorized access.
...
Note: Remember to save your configuration by clicking the 'Save Configuration' button before moving on.
Step 4: Configure Visibility Settings
Optional but Highly Recommended: While this step is optional, it's crucial for tailoring the app to your specific needs. Take a moment to configure these settings to ensure the app works exactly how you want it to.
...
Which groups are allowed/restricted to access “My Assets”
The first thing you'll see is a multi-select box where you can choose specific groups from your Atlassian instance. Use the 'Allow/Restrict' toggle to determine whether the selected groups should have access to the 'My Assets' menu or not.
Allow: The selected groups will be able to see the 'My Assets' menu.
Restrict: The selected groups will be prevented from seeing the 'My Assets' menu.
(See the image below for a visual representation.)
...
Which Asset-Schemas should be hidden from “My Assets”
The second multi-select box allows you to choose which Asset Schemas, from your Jira Servicemanagement instance, you want to exclude from the 'My Assets' menu. Any schema you select here will not be displayed in the 'My Assets' menu. This helps you filter out irrelevant schemas and keep the menu focused on the most important asset types.
(See the image below for a visual representation.)
...
Which Object-Types should be hidden from “My Assets”
Finally, you can fine-tune the 'My Assets' menu by selecting which Object Types to exclude for each Asset Schema.
Important: If you've already excluded an Asset Schema in the previous step, its corresponding Object Type selection will be grayed out, indicating that it's inactive. This visual cue helps you keep track of your choices.
(See the image below for a visual representation.)
...
Congratulations! You've successfully configured 'Assets Owner for Jira'. Click the 'Save Configuration' button, and you're all set! Your app is now tailored to your specific needs.
Important: After changing the group permissions (Allow/Restrict), you need to RELOAD your Jira instance for the changes to take effect. Other configuration changes will apply immediately without requiring a reload.
Step 5: Use the App
You're all set to explore your assets! Click on your profile picture in the top right corner of your Jira instance. A dropdown menu will appear, and you should see the 'My Assets' option waiting for you. Click on it to discover all the assets that are connected to you.
Important: The 'My Assets' menu visibility is determined by your configuration settings. Individual users will only see the menu if they have the necessary permissions. Double-check your configuration to ensure the menu appears for the intended users.
...
After clicking 'My Assets', you'll see a window listing your assets. This window displays all the assets that are connected to your Atlassian user account in any way. Remember that the assets shown here are filtered based on your visibility settings, so you'll only see what you're authorized to access.
...
To learn more about the 'My Assets' window and its features, such as filtering, sorting, and exporting, please visit the Jira App Documentation page.