Skip to content

Admin Guide

App Configuration

Administrators can adjust the app settings in the corresponding management section.

Jira

In Jira, navigate to the User management section and select API Token Authentication
The System-Wide Settings tab contains all settings applying to all users using the app.
Admins can create their own tokens in the API Tokens tab before that

image2020-2-4_14-15-43.png

Confluence

In Confluence, scroll down to the Users & Security section in the administration configuration panel and select API Token Authentication
image2019-11-22_9-52-24.png

System-Wide Settings

The app contains a few System-Wide Settings settings, available for administrators only. 
Settings here apply to all users accessing the REST API with Basic Authentication and any of the tokens they've created for their user in Jira or Confluence.
Please find more details about the two options currently available below the screenshot.

image2020-2-4_14-19-13.png

Token Validity Time

Administrator can define a maximum validity time of a token, if required.
Options are:

  • Never

  • 6 month

  • 1 year

  • 2 years

Users may override this according to the boundaries allowed.
Examples:

  • System Wide Setting is 6 month - users can select 6 month only, nothing else

  • System Wide Setting is 1 year - users can select 1 year or 6 month, nothing else

  • System Wide Setting is 2 years - users can select 2 years, 1 year or 6 month, nothing else

  • System Wide Setting is Never - users can select any validity time from the select list

IP Address Restrictions

Admins may restrict REST API requests by IP- addresses or ranges. This restriction will apply to both token- and password authentication,
should the latter not have been disabled (see next section). 

Just enter one or more addresses or address ranges with the + button or delete existing ones and save your settings.
info If no addresses were provided, requests from every IP address will be allowed.

If you need to find out why you can't access the REST API after applying IP restrictions, please read our troubleshooting guide.


Disable Basic Auth with passwords

You may want to disable password authentication for REST endpoints completely. Should the token provided not match any user's tokens,
a 403 status code will be returned. With Basic Auth and user passwords enabled, Jira will try to authenticate the user by password, provided that it is correct.

Allow only admins to create and/ or work with tokens

With that option enabled, any non sysadmin users won't be able to create tokens for their user account anymore, regardless if via REST or the Web interface.
Users won't be able to use tokens created prior that with any REST endpoints anymore.
The API Token Authentication link will be removed from their top right user settings picker (see (1.1.1) User Guide) and if they would browse the page manually, 
they see a info box instead:

image2020-2-4_15-52-38.png

Trying to create a token from a page still open will result in a 403 Forbidden:

image2020-2-4_15-53-48.png

Pitfalls

When playing and testing with wrong passwords or tokens, be aware that this can lead to too many failed logins recorded.
Go to your user manager and reset the failed login count for the user you are testing with.

Audit Logging

Since version 1.1.0, creating and deleting tokens (both deleting a single token or all for a user as an admin)
will cause an audit log record being created in Jira (https://your-jira/auditing/view) or Confluence (https://your-confluence/admin/auditlogging.action).
This become especially important, when an admin creates a token on behalf of some other user or just in general, to trace API Token usage.


image2020-2-5_10-57-23.png