Skip to content

aensley/sonar-teams-notifier

Repository files navigation

Sonar Teams Notifier

License Build Status Maintainability Test Coverage Checkstyle Downloads

This SonarQube plugin notifies WebEx Teams of Scan Results.

Usage

Administration

Only one setting is required once the plugin is installed, and that's to enable the plugin.

Admin Screenshot

Scanning

Basic Usage

To enable WebEx Teams notifications for scan results, supply the Incoming Webhook URL to the sonar-scanner command using the custom sonar.teams.hook property. This is the only property required to enable notifications.

Example
mvn sonar:sonar \
  -Dsonar.teams.hook=https://api.ciscospark.com/v1/webhooks/incoming/1234

Advanced Usage

All custom properties pertaining to this plugin are specified under sonar.teams, e.g. sonar.teams.hook.

Property name Required Description
hook YES The WebEx Teams Incoming Webhook URL.
fail_only no Specify any truthy value (e.g. 1 or true) to send notifications only when there is a failure.
commit_url no When specified, the commit in the notification links to the commit that triggered the build/scan.
change_author_email no When specified, the commit author is mentioned when there are any failures.
change_author_name no Sets the commit author's display name when mentioned.
Example
mvn sonar:sonar \
  -Dsonar.teams.hook=https://api.ciscospark.com/v1/webhooks/incoming/1234 \
  -Dsonar.teams.fail_only=1 \
  -Dsonar.teams.commit_url=https://github.com/owner/repo/commit/1234567 \
  -Dsonar.teams.change_author_email=author@email.com \
  -Dsonar.teams.change_author_name="Author Name"

Documentation

Browse the Javadocs at https://aensley.github.io/sonar-teams-notifier/