Configuring the plugin
Last updated
Last updated
Once the iCR build step has been added to the workflow, it needs to be configured with the information necessary to both authenticate the plugin’s access to the User’s repositories, and then to select the appropriate repository and branch for analysis. There are 10 items that need to be specified to fully configure the Jenkins plugin. These are shown in the iCR plugin window shown below:
They are:
iCR Server Address (URL) The iCR server is configured with a known IP address. Per the section Connecting to the Navigator, the URL for the server is the IP address followed by the port 3001. E.g. https://<iCR_IP_Address>:3001.
iCR User Name The Navigator requires the workflow to login into iCR using a specific iCR user name. This field is a string that specifies the User Name.
CI/CD Access Token In concert with the iCR User Name, that User needs to be authenticated before it can access iCR functionality. So that passwords are not exchanged between the plugin and iCR, an encrypted token is used. The CI/CD Access Token is created by the User within the iCR Navigator. You can see how that is done in the User Guide section titled The Navigator top banner.
Repository Host Name The name of the Version Control System (VCS) where the targeted repository is being managed. Currently, GitHub, GitLab and BitBucket are supported. In the case where local VCS servers such as GitHub Enterprise or GitLab Enterprise are deployed, those hosts are also displayed. In the example above we have used the cloud-based GitHub.
Personal Access Token / App Password The plugin is invoking iCR on behalf of a valid user and their repositories. In a fashion similar to how OAuth works, GitHub, GitLab or BitBucket allow an authorized app to access a User’s repositories using a secure Personal Access Token created by the specific service. How to get that token will be described in Creating a Personal Access Token. If the token/password is changed on the iCR server, it can be updated on the plugin by clicking on the Change Password button.
Repository Clone Link There are usually multiple possible repositories eligible for analysis via the plugin. The workflow creator needs to specify which of the User’s repositories is to be analyzed. How to find and copy that URL will be described in Copying Your Repository's URL.
Branch Name With a repository selected, the specific branch within that repository must be named. Simply enter the text string for the branch name here.
Intended Language to run iCR with Since multiple languages may be present in an repository, this field defines which source code language is to be analyzed.
Language Version (if applicable) With some languages that are analyzed by iCR, such as Python, the specific version of the language or related libraries needs to be specified in order for iCR to work correctly for the target source. The version is selected from the available options in the pull-down menu.
Notification email Address When the analysis triggered by this plugin completes, the User, upon whose behalf this analysis was performed, can receive an email notification letting them know it is complete. That User’s email can be entered here. An address MUST be provided to allow a way for iCR to notify the User in the event of either success of some kind of failure.
Note: Clicking on the icon for each entry will pop up a brief help text to guide you with the contents of that field.
