Jenkins Integration

First time using Jenkins? Please refer to the following documentation.
Introduction
This integration uses the security scans workflow as a docker image for all the execution and communication with Conviso Platform.
By the end of this tutorial you will know how to:
- Run an AST scan
- Run an SAST scan
- Run an SCA scan
Requirements
In order to integrate with Jenkins, your environment should fulfill the followings requirements:
- Jenkins version 2.222.3 or higher;
- Docker installed;
- Jenkins user must have access to the Docker daemon;
- External access (can be restricted to specific Conviso addresses);
If you need help about docker installation you can read all the process in the links below:
Install Docker Post-Install Linux Steps
Usage
The steps below will show what does your Jenkinsfile should have to perform our actions. These stages also can be inserted inside your current Jenkinsfile.
AST
The following code snippet will trigger an AST scan and send the results to Conviso Platform.
pipeline {
agent {
docker {
image 'convisoappsec/convisoast:latest'
args '-v /var/run/docker.sock:/var/run/docker.sock'
}
}
environment {
CONVISO_API_KEY = credentials('CONVISO_API_KEY')
}
stages {
stage('Conviso_AST') {
steps {
sh 'conviso ast run'
}
}
}
}
SAST
The following code snippet will trigger a SAST scan and send the results to Conviso Platform.
pipeline {
agent {
docker {
image 'convisoappsec/convisoast:latest'
args '-v /var/run/docker.sock:/var/run/docker.sock'
}
}
environment {
CONVISO_API_KEY = credentials('CONVISO_API_KEY')
}
stages {
stage('Conviso_SAST') {
steps {
sh 'conviso sast run'
}
}
}
}
SCA
The following code snippet will trigger an SCA scan and send the results to Conviso Platform:
pipeline {
agent {
docker {
image 'convisoappsec/convisoast:latest'
args '-v /var/run/docker.sock:/var/run/docker.sock'
}
}
environment {
CONVISO_API_KEY = credentials('CONVISO_API_KEY')
}
stages {
stage('Conviso_SCA') {
steps {
sh 'conviso sca run'
}
}
}
}
Contribute to the Docs
Found something outdated or missing? Help us improve the documentation with a quick suggestion or edit.
How to contribute