You can synchronize findings with your Shortcut storyboard by connecting Snyk API & Web to Shortcut. This synchronization can be done automatically or manually, finding by finding.
Synchronization is one-way, and changes made to Shortcut items will not be propagated to their respective findings on Snyk API & Web. Manual changes to Snyk API & Web findings are also not synced to Shortcut - only changes caused by a scan are.
Setting Up the Integration
Step 1: Generate a Shortcut Token
In Shortcut, go to Your Account > Settings > API Tokens.
Name and generate a new token.
Copy and save the token somewhere secure. Note that when you generate a new token, the value will only be displayed once, so write it down.
Step 2: Authentication and Configuration
Once you have the token, use it to authenticate with Snyk API & Web.
Log in to your account and choose Integrations from the side menu.
Scroll to the Shortcut option.
Insert your token and click Save.
Next, go to your target's Settings and access the Integrations tab to set up the configuration.
Fill out the required fields from the Shortcut configuration form. It includes:
Project
Story type
Priority mapping
Severity mapping
This information is required for Snyk API & Web to start synchronizing findings.
Check the box “Automatically sync all findings”. Otherwise, Snyk API & Web will not start synchronizing them.
If you do not wish to synchronize all the findings or if you prefer to hand-pick some of them, instead of selecting this checkbox you can manually configure the synchronization for certain findings. For that:
Go to that target and choose a finding you want to synchronize with your Shortcut project and board.
Check the “Sync finding” box to get updates from Snyk API & Web to Shortcut.
