Integrations & API Tokens
The Integrations page lets workspace administrators manage third-party service integrations and create custom API tokens for authenticating your own tools against the VSEC APIs.
Third-Party Integrations
The upper section of the Integrations page lists the pre-built integrations: xZETA, xNEXUS, and Elastiq. Each row shows the integration’s name and enabled state, and a Configure button that opens a settings dialog for endpoint URLs, API tokens and similar settings. Configure is disabled until the integration is enabled.
Scan Interval (xZETA SBOM Scanning)
Integrations that run on a recurring schedule — such as xZETA’s automated SBOM scanning — expose an Automated SBOM scan interval (minutes) field in their configuration dialog. This sets how often (in minutes) the integration re-scans, and defaults to 10 minutes.
Custom API Tokens
The Build your own integration card at the bottom of the page lets you generate long-lived workspace API tokens. Use these tokens to authenticate your own scripts, CI pipelines, or external tools against the VSEC workspace APIs.
Tokens are scoped to the workspace and act with the identity of the user who created them — API calls made with a token carry that user’s permissions in the workspace.
Generating a Token
- Click Generate API token on the Build your own integration card.
- Enter a descriptive Integration name (e.g.
My CI Pipeline). - Click Generate token.
Use the token as a bearer token in API requests:
Authorization: Bearer <token>The x-api-key header is accepted as an alternative:
x-api-key: <token>Managing Tokens
Each token appears in the list with its name and the first 8 characters of the token (e.g. abcd1234••••).
| Action | Description |
|---|---|
| Regenerate | Issues a new token for this integration. The previous token is immediately revoked, so update any services using it before regenerating. The new token is shown in a dialog so you can copy it; as with a new token, it is displayed only once. |
| Delete | Opens a Delete integration? confirmation, then permanently revokes the token. Any API requests using this token will stop working immediately. This action cannot be undone. |