Atlassian - Confluence and Jira

What is Atlassian (all-in-one integration)?

Atlassian is a software company that develops products for software development, project management, and team collaboration. Its most well-known tools include Confluence, a documentation and knowledge management platform, and Jira, a project management and issue-tracking tool commonly used in software development and IT operations.

How is this integration useful?

Integrating Entitle with Atlassian all-in-one enhances access management and security within these platforms. It allows teams to automate permissions, enforce least privilege access, and streamline access requests, ensuring better compliance and operational efficiency.

With this integration, Entitle can manage the following resource types in Atlassian:

  • Confluence spaces
  • Atlassian groups
  • Jira projects - company-managed (classic) and team-managed (next-gen).

Prerequisites

  • You must have an Admin account in Entitle.
  • Depending on the resource types you wish to manage in Entitle, you will need the following permissions:
    • Atlassian groups: Require site administration permissions.
      Note: In newer Atlassian accounts you can do this by being a member of the site-admins group).
    • Confluence spaces require Admin permission for the space.
    • Jira projects:
      • Company-managed projects require Administer Jira global permission.
      • Team-managed projects require Administer Jira global permission or Administer Projects project permission.

        ℹ️

        Note

        For more information on how to assign the above-mentioned permissions, see Assign required permissions.

  • Access to your Atlassian URL, API token, and user.

Create a personal access token

ℹ️

Note

Entitle currently supports integrating with Atlassian with a personal access token rather than with a global API token.

  1. Log in to Atlassian.

  2. Using the settings icon on the top-right corner, navigate to the Personal settings page.

  3. Navigate to the Security tab and locate the API tokens section.

  4. Click Create and manage API tokens.

  5. Click Create API token. Give your token a name and choose an expiration date.

  6. Click Create.

  7. Copy your API token for the configuration later on. Note: The API token cannot be recovered once you exit the current screen.

  8. Click Done.

Assign required permissions

Assign permissions to Atlassian groups

💡

Reminder

Atlassian groups require Site administration permissions (in newer Atlassian accounts you can do this by being a member of the site-admins group).

Click on the 𓃑 icon → Administration.

Assign permissions to Confluence spaces

💡

Reminder

Confluence spaces require Admin permissions for the space.

By default, the groups confluence-admins or site-admins provide this permission on every space. In case it doesn’t, or you do not want it to, you can add this permission granularly per space:

  1. Navigate to the Confluence space > click Space settingsSpace permissions → Under the Individual Users section click Edit Permissions.

  2. Under Individual Users search for your user and add it.

  3. Give your user Space Admin permission.

  4. Click Save all.

Assign permissions to Jira projects

💡

Reminders

  • Company-managed Jira projects require Administer Jira global permission.
  • Team-managed Jira projects require Administer Jira global permission or Administer Projects project permission.
  1. By default, the groups jira-admins or site-admins provide the necessary permissions for company-managed projects.

  2. To give your user the Administer Projects project permission in Team-managed projects:

    1. On your Jira interface, click Projects > View all projects > ellipsis (…) → Project settings.

    2. On the left bar click Access.

    3. Click Add people → Add an administrator.

Create the Atlassian integration in Entitle

  1. Sign in to Entitle.

  2. Navigate to the Integrations page.

  3. Click Add Integration.

  4. In the Application field, enter Atlassian.

  5. In the Save on dropdown, select Save on cloud or your hosted agent.

  6. In the Connection field, under api_token:

Example Connection JSON:

{
  "api_token": {
    "url": "<https://<YOUR_SUBDOMAIN>.atlassian.net>",
    "key": "<API_TOKEN>",
    "user": "<USER@YOURCOMPANY.COM>"
  }
}
  1. Click Save. The Entitle integration with Atlassian saves.