Configure personal access tokens

Personal Access Tokens (PAT) are used to authenticate harvesters to Semarchy xDG.

Overview

Access tokens are configured by users. They identify the user performing the harvesting and they inherit from that user’s privileges.

Personal Access Tokens used for harvesting must be created by users having at least Editor privileges in Semarchy xDG, and sufficent privileges to push these assets in a target domain, when configured. With insuffient privileges, a harvester will fail to push assets and metrics to Semarchy xDG.

Create an access token

To create a personal access token:

  1. Open the user menu in the upper-right corner of the application bar, and then select My Tokens.
    The Personal Access Tokens editor opens, listing the connected user’s tokens.

  2. Click add token Create new Personal Access Token in the editor toolbar.
    The Generate New Token dialog opens.

  3. In the Name, enter the token name.

  4. Enter a Description for your token.

  5. Select a Duration for your token. After this duration, this token expires. Select No expiry if you want your token to have no expiration date.

    For security reasons, it is not recommended to create access tokens with no expiration.

  6. Click Create.
    The personal access token is created, and its value is copied to the clipboard.

  7. Save the token value or paste it directly into a recipe file.

The token value is only available in the clipboard at creation time. You will not be able to recover it later. Make sure to keep this token value in a safe location.

Revoke an access token

To create a personal access token:

  1. Open the user menu in the upper-right corner of the application bar, and then select My Tokens.
    The Personal Access Tokens editor opens, listing the connected user’s tokens.

  2. Click delete Revoke Token on a personal access token line to delete this token. This operation cannet be undone.