Share this page

# Authenticate to Jira using the command line

This topic describes how to authenticate to Jira Software using dmcli, the OpenText Dimensions CM command line.

After registering credentials, you can use Jira issues as requests in OpenText Dimensions CM for current and future connection sessions until the Jira token is revoked, the password expires, or the user is locked.

In this topic:

## Simple authentication

The easiest way to authenticate to Jira is to use a URL.

To use simple authentication:

1. Log in to the dmcli command-line client with your OpenText Dimensions CM credentials.
2. Run a command that uses an external request, for example, deliver changes in response to a Jira issue.
3. When the command fails to authenticate to Jira, copy the URL in the command output.
4. Paste the URL into a browser.
5. Step through the Jira authentication process.

Back to top

## Register Jira Cloud credentials

You can associate Jira Cloud user credentials with an OpenText Dimensions CM user.

To register Jira Cloud credentials:

1. In your Atlassian account, navigate to Account Settings > Security > API token > Create and manage API tokens.
2. Create and save an API token.
3. Log in to the OpenText Dimensions CM desktop or dmcli command-line client using your CM credentials.

4. To register the Jira Cloud credentials, run the following `AUTH` command:

   Copy code

       AUTH /USER="<Jira username>" /PASSWORD="<Jira API token>" /IDM_TOOL="<Jira instance ID>"

   where:

   - PASSWORD is the Jira API token.

   - IDM_TOOL is the ID of the Jira request provider. Enter "." to register credentials against the provider associated with the current product.

     Tip: If the Jira username is an email address, use double @@ symbols, for example, jira@@user_name.com.

Back to top

## Register Jira Server credentials

If your OpenText Dimensions CM and Jira Server login credentials are different, or you want to use a different Jira account for your CM user, you can register your Jira Server credentials using dmcli.

To register Jira Server credentials:

1. Log in to the desktop client or dmcli command-line client with your OpenText Dimensions CM credentials.

2. To register the Jira Server credentials, run the following `AUTH` command:

   Copy code

       AUTH /USER="<Jira username>" /PASSWORD="<Jira password>" /IDM_TOOL="<Jira instance ID>"

   where IDM_TOOL is the ID of the Jira request provider . Enter "." to register credentials against the provider associated with the current product.

Back to top

## Unregister Jira credentials

To unregister Jira Cloud and Server credentials, run this dmcli command:

Copy code

    AUTH /DELETE /IDM_TOOL="<Jira instance ID>"

or

Copy code

    AUTH /DELETE /IDM_TOOL=.

Back to top

See also:

- Configure Jira provider

https://admhelp.microfocus.com Dimensions CM 8942
Tips to improve your search results... OpenText™ Dimensions CM Help Center OpenText™ Dimensions CM Help 25.2 All View Local Help Center View Online Help Center Version: