Managing access to DevOps Test Hub

Desktop clients and third-party integrations use offline user tokens to connect to IBM® DevOps Test Hub (Test Hub).

You can configure the desktop clients and third-party integrations to access Test Hub by using the offline user tokens created from the server.

Offline user tokens are used in the following cases:

To retrieve secrets configured on the server to be used in certain tests in IBM DevOps Test Integrations and APIs (Test Integrations and APIs).
To enable publishing of test results and reports from desktop products that include Test Integrations and APIs, IBM DevOps Test Performance (Test Performance), or IBM DevOps Test UI (Test UI) to Test Hub.
To enable the Resource Monitoring Service in Test Performance to monitor a data source during a run on Test Hub.
To enable agents to connect with Test Hub.
To enable HTTP proxies to connect with Test Hub.
To enable third-party integrations.

From Test Hub, you can create an offline user token, copy it, and then use that token to enable connections to be authenticated by Test Hub.

You can also delete all the tokens, when you no longer need access or you want to prevent access to the server.

Creating a token

Follow these steps:

Click the User icon from the menu bar, and then select Create Token.

The Create Offline User Token dialog is displayed.

Note: This token is not accessible after you copy it as the dialog box closes.
Copy the token and paste it into a private location for ongoing reference.

The dialog closes.

Paste the token into the UI of the desktop product or in the application where this token is required.

See the following table for a list of where you can use the tokens and where you can find more information.

Table 1. Using the offline user tokens to access Test Hub
Use the offline user token in the following places	More information
Test Integrations and APIs	See Test Integrations and APIs and Test Hub..
Test Performance	See Publishing test results to the server.. See Enablement of Resource Monitoring services for a schedule..
Test UI	See Publishing test results to the server..
Third-party integrations	See Integrations with other applications.

Deleting tokens

Follow these steps:
1. Click the User icon from the menu bar and select Delete Tokens.
  
  The Delete All Offline User Tokens dialog is displayed.
2. Inform the desktop client users that the tokens were deleted. Fix any test automation scripts that used tokens.