Skip to main content

Snyk proof types and permissions

Hyperproof supports collecting proof from Snyk.

Note

Hyperproof connects to many third-party systems that frequently change, including the system interface. Contact your System Administrator or the third-party provider for assistance meeting the requirements to integrate with Hyperproof and collect the proof you need.

When you create a Hypersync between Hyperproof and Snyk, you can automatically collect the following proof types:

  • List of Users by Org (requires a group ID and an organization)

  • List of Issues by Project (requires a group ID, an organization, and a project)

  • Issue Summary by Project (requires a group ID, an organization, and a project)

Requirements

To connect to Snyk and collect proof your Snyk configuration must meet the following requirements.

Permissions

The minimum required permissions for the three proof types are:

  • Organization management/view organization

  • Project management/view project

  • Project management/view project history

  • Reports management/view organization reports

  • User management/view users

Authentication

It's recommended to create a service account in Snyk for users who need access to the Snyk Hypersync.

Service accounts can be created by navigating to your organization in Snyk. Choose one of the following permission types: organization collaborator or organization administrator (note that organization administrator provides users with more privileges). Refer to the official Snyk documentation for more information.

When creating the service account, you can only view the API Token once. Be sure to copy it as it is needed for authenticating to Hyperproof.

Additional tips

  • A service account must be created within a group or within an organization that is in a group (and groups can contain organizations)

  • Service accounts can't be created in an organization that isn't in a group.

  • If you can't see the Snyk Service Account menu, you may not have groups defined.

  • If you can't see custom roles, you may not have any defined.

  • If users do not want to use a service account, they can create an API token for their individual user under Account Settings > General > API Token.

Additional documentation

Note

You only need to connect Hyperproof to the app once, and then you can create as many Hypersyncs as you need. Additionally, you can create multiple Hypersyncs for a single control or label.