Mirroring GitHub.com and GitHub Enterprise organizations and repos in Snyk

You can use four commands in the available utils to import the entirety of GitHub and GitHub Enterprise repos into Snyk. You must configure both the GitHub token and Snyk token as environment variables to proceed.

General steps to import GitHub and GitHub Enterprise repos

Refer to individual documentation pages for detailed information. The general steps are as follows:

  1. export GITHUB_TOKEN=*** and export SNYK_TOKEN=***

  2. Generate organization data, for example, snyk-api-import orgs:data --source=github --groupId=<snyk_group_id> Full instructions: Creating organizations in Snyk

  3. Create organizations in Snyk: snyk-api-import orgs:create --file=orgs.json By following the full instructions on Creating organizations in Snyk you will create a snyk-created-orgs.json file with Snyk organization ids and integration ids that are needed for import.

  4. Generate import data: snyk-api-import import:data --orgsData=snyk-created-orgs.json --source=github --integrationType=github Full instructions: Creating imports targets data for import

  5. Run import: DEBUG=*snyk* snyk-api-import importFull instructions: Kicking off an import

Re-importing new repos and Orgs only while mirroring

Once initial import is complete you can periodically check for new repos and make sure they are added into Snyk by following these steps, which are similar to the preceding steps to import repos.

  1. export GITHUB_TOKEN=*** and export SNYK_TOKEN=***

  2. Generate organization data in Snyk and skip any that do not have any repos by using --skipEmptyOrg snyk-api-import orgs:data --source=github --groupId=<snyk_group_id> --skipEmptyOrg Full instructions: Creating organizations in Snyk

  3. Create organizations in Snyk and this time skip any that have been created already with --noDuplicateNames parameter snyk-api-import orgs:create --file=orgs.json --noDuplicateNames By following the full instructions on Creating organizations in Snyk you will create a snyk-created-orgs.json file with Snyk organization ids and integration ids that are needed for import.

  4. Generate import data: snyk-api-import import:data --orgsData=snyk-created-orgs.json --source=github --integrationType=github Full instructions: Creating import targets data for import

  5. Optional - Generate the previously imported log to skip all previously imported repos in a Group: snyk-api-import-macos list:imported --integrationType=<integration-type> --groupId=<snyk_group_id> Full instructions: Kicking off an import

  6. Run import DEBUG=*snyk* snyk-api-import importFull instructions: Kicking off an import

Last updated

More information

Snyk privacy policy

© 2023 Snyk Limited | All product and company names and logos are trademarks of their respective owners.