Initial Setup for Atlassian

Before connecting the adapter in Axonius, set up the following:

1. User Account
2. API Token
3. OAuth Credentials (relevant only if you're using OAuth 2.0 authentication)

Creating a User Account

🚧

Attention

You must have the Jira Administrator or Jira System Administrator global permission to manage users in Jira applications.

📘

Note for fetching Application Settings

If single-sign-on is enabled, it is recommended to derive the username and password from a user account maintained by the single-sign-on solution.

To create a new user:

1. On Atlassian Administration, navigate to Administration > User Management.

2. In the User browser, select Create User.

3. Enter the Username, Password, Full Name, and Email address.

   1. The password length should be at least 32 characters.
   2. The user account needs to have MFA disabled.

4. Select all Jira applications.

5. Select Create.

6. Set admin permissions:

   1. Go to Settings > Administrators.
   2. Click Add administrators.
   3. Enter the created Atlassian account email address and click Grant access.

7. To fetch data from Confluence if the created account is not set as an admin: edit that user and add it to groups that provide the following permissions:

   • Permission to access the Confluence site ('Can use' global permission)
   • 'View' permission for all spaces

Creating an API Token

1. Login to admin.atlassian.com with the Atlassian user account you created, and generate an API token, using the following URL: https://id.atlassian.com/manage/api-tokens#
2. Select Create API token.
3. Select a label that is short and easy to remember, and click Create.
4. Copy the generated API token.
5. In Axonius, in the Add Connection drawer, paste the copied token in the API Token field.

Creating an Organization API Key and Obtaining an Organization ID

💡

Note

This part is required only to fetch Secrets and Users' organizational information.

1. Login to a_dmin.atlassian.com_ with the Atlassian user account you created.
2. Select your organization (if you have more than one).
3. Select Settings > API keys.
4. Select Create API key on the top right.
5. Enter a name that you can easily remember to identify the API key.
6. Set the latest date possible for the key expiration date. Usually, the maximum is one year.
7. Select Create to save the API key.
8. Copy the generated Organization ID and API key.
9. Click Done. The key will appear in your list of API keys.
10. In Axonius, in the Add Connection drawer, paste the copied values into the Atlassian Admin API - API Key and Atlassian Admin API - Organization ID fields.

Obtaining OAuth Credentials

🚧

Note

This part is required only to connect the adapter with OAuth 2.0 authentication.

For detailed instructions, refer to the Atlassian OAuth 2.0 documentation. Below is a summary of the steps:

1. Register an OAuth 2.0 app in the Atlassian Developer Console. Use the Client Credentials grant type.
2. Configure the audience as api.atlassian.com.
3. Copy the Client ID and Client Secret into the User Name and API Token Axonius fields respectively.