Español

Copado Integration - Quality Gates Framework

Phil Lepanto
  • Updated

DigitSec recommends that you prepare for this integration by opening three separate browser windows and following these steps to connecting DigitSec and Copado. Keep this page open for instructions, while you switch between DigitSec and Salesforce/Copado.

Source Format pipelines using the Quality Gate framework supercharge Copado's commit-based scanning. To work properly, each sandbox/org in your pipeline should have a corresponding connected workspace set up in DigitSec. When making a commit to a User Story, DigitSec will scan the source sandbox/org with the newly committed code. Scans will not be initiated if there is not a connected Workspace on DigitSec corresponding to the Source Sandbox/Org.

  • DigitSec Docs Site (current page)
  • Salesforce/Copado (login)
  • DigitSec (login)
  1. Install the DigitSec Package (Prod, Dev)
    https://login.salesforce.com/packaging/installPackage.apexp?p0=04tfj000000Kk0H
  2. Install the DigitSec Package (Sandbox)
    https://test.salesforce.com/packaging/installPackage.apexp?p0=04tfj000000Kk0H

Part 1: Install the DigitSec Extension Bundle

  1. Open the App Launcher. In Copado Release Manager, click the grid icon (App Launcher) in the top-left corner. Search for "Exte" and select Copado Extensions from the options.
    2b234d10814af3ed89916f9c2db7500e89df3579.png
    Screenshot 1 - App Launcher search for "Extensions"
     
  2. Select DigitSecExtensionBundle. On the Copado Extensions page, click the Select Extension dropdown. Scroll to the bottom of the list and verifiy DigitSecExtensionBundle is an option. If it does not appear, please try reinstalling the package as indicated in Step 1 above.
    619fa80b28fa6dc28fffddcc676f2a40635ce42f.png
    Screenshot 2 - Selecting DigitSecExtensionsBundle
     

Part 2: Add "DigitSec Security Scan" to the Extension Tool Picklist

  1. Navigate to Extension Tool field. Go to Setup --> Object Manager, locate the Extension Configuration object, then click Fields & Relationships --> Extension Tool.
  2. Check whether "DigitSec Security Scan" is already listed. If the option appears in the Values list, skip to Step 8. If it is not listed, continue with the next step.
    0a2ffd0f648833a2947b2224b75d4e8512739c3e.png
    Screenshot 3 - Extension Tool Values (DigitSec Security Scan visible in Values options).
     
  3. Open the Copado Test Tool Value Set. Click View Copado Test Tool Value Set. On the next screen, click New.
    5f6dba0ade1d3d10888436d47479b8455fa180bc.png
    Screenshot 4 - Adding DigitSec Security Scan to Picklist Value Options
     
  4. Add the new value. In the text area, type DigitSec Security Scan (one value per line). Click Save.

Part 3: Add "DigitSec Security Scan" to the Quality Gate Rule Tool Picklist

  1. Navigate to the Quality Gate Rule Tool field. Go to Setup --> Object Manager --> Quality Gate Rule --> Fields & Relationships -- > Tool (API name: copado__Tool__c).
    27302eb22c9c0645cef0385fb81f26dc47e24669.png
    Screenshot 5 - Quality Gate Rule: Tool picklist values
     
  2. Add the value if missing. If DigitSec Security Scan is not in the list, click View Copado Test Tool Value Set and add it following the same process as indicated in Steps 6-7.
  3. Verify the Copado TEst Tool Picklist Value Set. Go to Setup --> Picklist Value Sets --> Copado Test Tool and confirm that DigitSec Security Scan is listed as an active value.
    74a82cece1f930cec56c38bf9ac98c6c46d0a66f.png
    Screenshot 6 - Picklist Value Sets: Copado Test Tool

Part 4: Generate Extension Records

  1. Return to Copado Extensions. From the App Launcher, open Copado Extensions. In the Select Extension dropdown, choose DigitSecExtensionBundle. You will see three records listed with red X status icons.
    c3a490c106c0fb4776925ad54262f2109e105cda.png
    Screenshot 7 - Copado Extensions indicating 'not generated'
     
  2. Click Generate Extension Records. Click the Generate Extension Records button at the bottom of the page.