Wiki
Clone wikiKeysight Plugins For Atlassian Products / JIRA Plugins / Keysight Admin Tools for JIRA Plugin
Introduction
These are a set of utilities to assist administrators support their instance.
Features at a Glance
Feature | Description |
---|---|
Active Users List | Lists out the users who have JIRA Core, JIRA Software or JIRA Service Desk licenses and when they last logged in. |
External Directory Sync Rest Interface | A rest interface that triggers all of the external directories to start synchronizing. |
Features in Detail
Active Users List
Description
This provides two tables of users who have a license to JIRA Core, JIRA Software or JIRA Service Desk. The first table is for users who have never logged in, the second table is for users who have logged in at least once. The information presented in the two tables differ only in that the first table does not have the Last Login or Logged in X Days Ago columns since they have never logged in by definition.
Property | Description |
---|---|
Count | The line count |
Login Name | The user's login name |
User Name | The users full name |
JIRA Core License | Indicates if the user has a JIRA Core License |
JIRA Software License | Indicates if the user has a JIRA Software License |
JIRA Service Desk License | Indicates if the user has a JIRA Service Desk License |
Last Login | The date the user last logged in |
Logged in X Days Ago | The number of days since the user last logged in. |
Usage
In the add-ons view, select the Active Users List menu item in the left sidebar.
Purpose
For JIRA instances with limited user licenses, it's common for managers to sign up their entire team to avoid any delays in getting them access. When user licenses start to run low, this tool can be used to identify users who were granted a license but are not actively using it. They can probably have their license revoked to avoid or delay having to purchase the next level of license.
External Directory Sync Rest Interface
Description
This is a rest interface to trigger the synchronization of all of the external directories. It will not restart a sync is one is already underway for that directory.
URL: <jira-url>/rest/jira-support/1.0/directory/sync
Input Parameters: none
Note, this interface does not check for any credentials. Therefore a simple get call to the url will trigger the sync. From a security perspective, this would allow somebody to learn the names of the external directories as defined within JIRA. As it will only start a sync that JIRA is doing anyway on a regular basis there did not seem to be much value in trying to protect this operation and not protecting it made it easier to integrate with a self registration system and not have to worry about password synchronization.
Usage
Use a web browser, curl, or something like get go query the url at <jira-url>/rest/jira-support/1.0/directory/sync
Purpose
In order to avoid a manual process for granting users a license in JIRA, we put together a website where users could enter their Active Directory credentials and be added to the AD group with permissions. We use this rest interface to trigger a sync when a user was added to one of the special groups.
Updated