Atlassian Capabilities
Last updated: October 7, 2024
After this article...
You'll understand the capabilities our Atlassian integration provides, and how Lumos interacts with the Atlassian API.
View users
The mapping between Atlassian user statuses and Lumos user account statuses is below.
Reconciling Atlassian account status
When you're reviewing the Atlassian app in Lumos, you'll see a list of users and their Atlassian account status. The table below provides a mapping between the Atlassian user account status and Lumos user status.
Atlassian Managed Account Status | Lumos Account Status |
active | Active |
inactive | Suspended |
closed | Deprovisioned |
deleted (Atlassian no longer returns a user) | Deprovisioned |
Atlassian API endpoints: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-users/#api-group-users (we parse the User's account_status field to get their overall Atlassian account status)
View a user's entitlements
Lumos can retrieve the following user entitlements from Atlassian.
Product Access - The Atlassian products to which the user is assigned, by site. The naming convention of the field is
product.name (site name).Ex:
Confluence (Site A), Jira Service Management (Site B)
Atlassian API endpoints:
Product Access: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-users/#api-group-users (we parse the product_access list for each user to get their product assignments by site)
View last login
In Lumos, the Last Login value for an Atlassian user account represents the last time the user logged into Atlassian.
We can also track the last time a user logged into a specific Atlassian product/site, more info on that can be found below.
Atlassian API endpoint: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-users/#api-v1-orgs-orgid-users-get (we get the last_active for the user)
Suspend a user
AppStore | Offboarding | Access Reviews | License Management |
N/A | ✅ | ✅ | ✅ |
In Lumos, suspending an Atlassian user marks their Account Status as "Suspended".
In Atlassian, this action deactivates their user account. Suspended users cannot access your organization’s products, and they won’t be billed.
This action reclaims a license in Atlassian.
Atlassian API endpoints: https://developer.atlassian.com/cloud/admin/user-management/rest/api-group-lifecycle/#api-users-account-id-manage-lifecycle-disable-post
View managed application assignments and activity
Lumos surfaces a separate application for each Atlassian product that you manage, across all of your Atlassian sites, in the Apps tab and the users assigned to them in the Accounts tab for a given product.
You can filter to Atlassian-managed products in the Apps tab by filtering the Source column on Atlassian.
For each Atlassian-managed product, Lumos shows the following key fields about the assigned users.
Account Status
The status of the user's account in the product, as reported by Atlassian.
Atlassian Product Site Status | Lumos Account Status |
assigned | Active |
deleted (Atlassian no longer shows the user having access to the site product) | Deprovisioned |
Atlassian API docs: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-users/#api-group-users (we use the product_access field to get each user's product assignments by site)
Last Login
This represents the last time the user accessed the product via Atlassian.
Atlassian API docs: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-users/#api-group-users (we use the product_access.last_active field to get the last active date for each assigned product/site)