Wiki

Clone wiki

Keysight Plugins For Atlassian Products / JIRA Plugins / Keysight Admin Tools for JIRA Plugin

Introduction

KeysightRedThickLine.png

These are a set of utilities to assist administrators support their instance.

Features at a Glance

KeysightRedThickLine.png

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

KeysightRedThickLine.png

KeysightRedLine.png

KeysightLogo.png Active Users List

KeysightRedLine.png

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.

KeysightRedLine.png

KeysightLogo.png External Directory Sync Rest Interface

KeysightRedLine.png

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.


Home

Updated