API Tokens
API Tokens Management
The API Tokens feature in EasyDCIM allows generating secure access keys for API v3. Tokens can be created for both administrators and clients, enabling external applications and services to interact with the system without the need to share login credentials. Full API v3 documentation is available here: EasyDCIM API v3 Documentation.
Each token can be assigned a custom name and specific abilities, such as impersonating another user if required. Administrators can monitor token usage, check when a token was last used, and revoke access at any time.
Creating an API Token
To create a new token:
- Navigate to either the Administrators or the Clients section in the main menu.
- Select the desired user and open their Summary View.
- Switch to the API Tokens tab.
- Click on Create API Token.
- In the popup window, provide a descriptive Name for the token (e.g., CRM Integration, Tech Access).
- (Optional) Enable Impersonate Users if the token should be allowed to log in as another user (available only for administrators).
- Click Save Changes to confirm.
The newly created token will be displayed only once immediately after creation. Make sure to copy and store it in a secure location, as there is no possibility to view the token again later.
Security Recommendations
- Assign meaningful names to tokens to easily identify their purpose.
- Revoke tokens that are no longer in use.
- Use impersonation carefully, as it grants higher privileges (admins only).
- Regularly audit tokens to ensure only trusted integrations remain active.
