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: VicOne xZETA, VicOne xNEXUS, and Elastiq. Each row shows the integration’s name and enabled state. Integrations that require additional configuration (endpoint URLs, API tokens, etc.) include a Configure button that opens a settings dialog; 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 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 a short token prefix (e.g. abc123…).
| Action | Description |
|---|---|
| Regenerate token | Issues a new token for this integration. The previous token is immediately revoked — update any services using it before regenerating. The new token is not displayed; it is copied to your clipboard and a toast confirms it. |
| Remove | Opens a Remove integration? confirmation, then permanently revokes the token. Any API requests using this token will stop working immediately. This action cannot be undone. |