Access
- PLANTA link → Web Interfaces → Configuration → Web Interfaces → Manage API- token button → Manage API Tokens
- PLANTA link → Web Interfaces → Manage API Tokens
Information
- In this module, new tokens are generated or existing tokens are assigned to the web interfaces.
Procedure: generate a new token
- Open the Manage API Tokens module. As a result, an empty record is already displayed for a new token.
- Add a name or description in the Note field and save. The ID for the new token is generated automatically.
- If the module is opened directly from the configuration of a web interface and a new token is generated, it is automatically assigned to the opened web interface.
- A token can be set to invalid by
- manually deactivating the Valid checkbox or
- specifying an expiration date in the up to field on which the Valid checkbox is automatically deactivated (controlled by an event).
Procedure: assign a token to a new web interface
- Open the Manage API Tokens module.
- Right-click on a token and select Insert → API token assignment from the context menu.
- Save. The assigned web interface is immediately visible below the token record.
Details
- It is possible to assign a token to several web interfaces.
- There can be several tokens for different groups of web interfaces.
- It is, e.g., possible to generate a token and to use it for all Jira end points or all PLANTA pulse end points to establish a convenient connection to an external system.
- It is now possible to set the API tokens for pulse/Jira) via environment variables.
- planta__server__api_token__pulse = ac52d48bc316424f8f541b3855552d7e
- planta__server__api_token__jira = 187658bcc7c14817b4679fd58581c3ec
- The API token must correspond to the format of a UUID. When the erver starts, the token is displayed. If a token has already been assigned, nothing happens.