Integrating Invicti Enterprise with CircleCI

CircleCI is a continuous integration and delivery system that is used by software teams to allow them to build, test and deploy applications easier and quicker on multiple platforms. With an emphasis on speed and configurability, CircleCI is built to help users test their applications whenever they make changes to it, release it or deploy it.

This topic explains how to configure Invicti Enterprise to send a detected vulnerability to CircleCI.

For further information, see What Systems Does Invicti Integrate With?.

CircleCI Fields

This table lists and explains the CircleCI fields in the New CircleCI Integration window.

How to Generate and Use Invicti Enterprise’s CircleCI Integration Orbs

Invicti Enterprise uses GitHub for integration with CircleCI.

1. Navigate to your GitHub project to integrate CircleCI.
2. Create a .circleci folder then create a config.yml in it: “.circleci/config.yml”.
3. Copy sample yaml code from the Invicti orb on CircleCI page and paste it into your config.yml. Note that in config.yml, the job name must be 'invicti/scan'.

4. Log in to Invicti.
5. From the main menu, click Integrations, then New Integration.
6. From the Continuous Integration Systems section, click CircleCI.
7. In the Scan Type field, select the scan type.
8. In the Website field, enter the website.
9. If required, from the Scan Profile dropdown, select a scan profile. (This option is displayed only if you have selected Incremental or Full (With selected profile) from the Scan Type.)
10. In the Parameters field, click Copy to Clipboard to copy the displayed code.

11. In CircleCI, replace the related values so that the final result will be as illustrated. Also, CircleCI will read it each time and run a new build when it changes.

12. Navigate to your CircleCI projects: https://app.circleci.com/projects/.

13.  Click Set Up Project.

14. Click Start Building.

15. Click Add Manually.

16. Click Start Building.
17. Next, configure these settings in the project environment settings. Navigate to your CircleCI Project Settings:

• NETSPARKER_ENTERPRISE_USER_ID
• NETSPARKER_ENTERPRISE_API_TOKEN

18. Then, add these variables with values into Invicti Enterprise:

• In Invicti Enterprise, from the main menu, select YourName, then API Settings.
• Use the information from the previous step to complete the User ID and Token fields.

19. In CircleCI, navigate to Organization Settings. In Orb Security Settings, make sure Allow Uncertified Orbs is set to Yes.

20. If everything is set up correctly, the pipeline will succeed and a new scan will start in Invicti Enterprise.