SonarQube - Usage
Requirements
- Velocity
- Privileges to add integration
- Obtain or create a user access key
- SonarQube
- Privileges to create webhooks
- Obtain or create authentication token
- Velocity certificate authentication
- Trusted Certificate: The certificate must be validated as trusted. This means validated by a public or organizational Certificate Authority (CA) or else imported into the truststore of the SonarQube server’s Java Runtime Environment (JRE).
- Common Name: The DevOps Velocity host name used in the webhook must meet the requirements of the DevOps Velocity certificate common name (CN), whether you are using a single-name, wildcard, or multi-name. It is best to craft your certificate so that its common name matches your DevOps Velocity host name. However, if there is a mismatch and the certificate cannot be changed, then the host name can be changed instead. This can be done at the network or local level, such as a hosts file entry on the SonarQube server that maps the common name to the actual host name, such that the common name can be used from that server.
Integration Type
The endpoint URL needed for the webhook is described below.
| Name | Path | Method |
|---|---|---|
| SonarQube Callback | http://urbancodevelocity_hostname/reporting-consumer/pluginEndpoint/integration_id/sonarqube/callback | Post |
Setup
Creating the DevOps Velocity Integration
Each external data source should have its own integration, with multiple integrations per plugin type. SonarQube integrations are created from the SonarQube plugin type and can be added three different ways:
- The user interface provided on the settings/integration page (as of Velocity 1.2.6)
- POST request to https://:/reporting-consumer/integration
- Uploading a Value Stream Map JSON file
The parameters for adding a SonarQube integration are summarized in the table below. The usual preference is to create an integration through the UI; however, sometimes it is necessary to use the API. An example POST request is provided below as part of a curl command to add an integration. It is important to pay attention to the response, since it will contain the integration ID to construct the endpoint URL. The endpoint URL is needed for the second step of creating a webhook in SonarQube.
| Name | Type | Description | Required |
|---|---|---|---|
| Velocity Hostname | String | The Velocity hostname including the port if applicable. For example, “velocityHost:9000”. | API only |
| Velocity Access Key | Secure | The access key used to authenticate to DevOps Velocity. You can use a previously generated key or generate a new key. | Yes |
| Integration Name | String | A name used to reference the integration. | Yes |
| SonarQube Auth Token | Secure | The SonarQube authentication token. You can use a previously generated token or generate a new token in SonarQube. | Yes |
| SonarQube URL | String | The base URL of the SonarQube server including the port number. For example: “http://sonarQubeHost:9000”. | Yes |
curl -k --request POST \
--url
https://<*velocityHostname:port*>/reporting-consumer/integration \
--header 'content-type: application/json' \
--data '{
"type": "sonarqubePlugin",
"tenant_id": "5ade13625558f2c6688d15ce",
"name": "<*integrationName*>",
"properties": {
"url":
"<*sonarqubeUrl*>",
"authToken": "<*sonarqubeAuthToken*>",
"velocityAccessKey":
"<*VelocityAccessKey*>"
}``
}``'
2.) Creating the SonarQube Webhook
The SonarQube webhook must target the Velocity integration’s endpoint URL which has two variables: the“hostName:port” for Velocity, as well as the integration ID. This means that the DevOps Velocity integration mustalways be setup first and that the integration ID is known before we can provide the webhook URL. Once the endpoint URL is constructed, it is simply a matter of creating a webhook in SonarQube with that URL. For information on creating the webhook, see the SonarQube Webhooks documentation. In general, you will need administrative permissions and can add two types of webhooks within SonarQube:
- Project scoped webhooks
- Globally scoped webhooks
What you have available will depend on your version of SonarQube but it is good to be aware that a global webhook will send data for all projects, while a project scoped webhook will only send data for the specific project to which it belongs. Also, in general, SonarQube limits its number of webhooks at both the project and global levels. Refer to your SonarQube documentation for details of webhook management.
| Back to … | Latest Version | SonarQube | |||||
|---|---|---|---|---|---|---|---|
| All Plugins | Velocity Plugins | 1.0.50 | Readme | Overview | Scripts | Certificate | Downloads |