mabl API keys enable programmatic access to the information in your mabl workspace. You can create, pause/unpause, and delete API keys. Visit the Settings > API page to manage your API keys.
Different API keys are permissioned for different use cases. Keys only have the read/write permissions necessary for a specific use case.
Available key types are:
Deployment Trigger
- use to start tests with the Deployments API and to retrieve test results with the Execution Result APICommand Line Interface
- use with the mabl CLI overviewCI/CD Integration
- use with mabl's Jenkins, Bamboo, Microsoft Azure DevOps, GitHub Action and Octopus Deploy integrationsLink Agent
- use with the mabl Link agentIssue Tracker
- use with the mabl Jira pluginIntegration
- legacy API key type - cannot be created by user (deprecated)
Read on below to learn how to create these respective key types.
Deprecated `Integration` Key Type
The legacy Tntegration
key type is deprecated. Existing keys will continue to function, but new keys of this type cannot be created by users.
Create API Keys from the Settings > API page. Click the Create API Key
button to make a new key. If you do not see this button, ask a workspace owner to create the key.
Creating API Key Permissions
Only a workspace Owner level user can create API keys.
For example, if you had a curl
script for starting mabl tests using the Deployment Events API, use a Deployment Trigger
API Key (pictured below) that will have the permissions to start and monitor deployments.
After creating the key, click the copy or eye buttons to respectively copy or view this API key.
Security conscious users may want to remove an API key, but are unsure if it's in use. You can toggle the respective key's On / Off
to Off
button to instantly block any API access using that key. Toggling back to On
will instantly reenable API access for the key.
You can toggle of an API key and ensure no problems are encountered when removing or rotating API keys. If no problems are detected after pausing a key, you can remove it by clicking on the Delete
button (more on that in the next section).
When rotating an API key (e.g. for your Jenkins mabl plugin)
- Create a second key of the same type
- Update the consuming integration with the new key value
- Pause the existing key in use by the respective integration
- After confirming expected system operation, delete the old (paused) key.
Deleted API Key Cannot Be Recovered
Take care to ensure an API key is no longer in use before deleting the key. Once deleted, an API key cannot be restored, meaning any impacted scripts/services will be unable to access mabl.
To remove an API key, use the DELETE
button. This will permanently remove the API key. If any clients are using this key, they will no longer be able to access mabl services. Please be sure no further access is required for a key before deleting it. If you are unsure, pause the key instead (see prior section).
Updated 6 months ago