Importar projetos pela API

Acabamos de lançar um novo endpoint de API que permite importar repositórios, projetos, funções e aplicativos para monitorá-los em busca de vulnerabilidades.

É muito simples de usar. Você faz uma requisição informando a integração de onde quer importar (por exemplo, GitHub) e o repositório, projeto, função ou aplicativo que deseja incluir (por exemplo, um repositório específico do GitHub), e nós cuidamos do resto. Se quiser, você pode especificar os arquivos que devemos analisar em busca de vulnerabilidades, como package.json ou Gemfile.lock. Caso contrário, analisaremos todos os arquivos de dependências que encontrarmos (a profundidade da análise varia conforme a integração).

Essa chamada à API é assíncrona, pois a importação pode levar algum tempo. Ela retorna uma resposta 201 com um cabeçalho de localização que especifica o endpoint a consultar para acompanhar o status da tarefa de importação.

Muitos clientes nos pediram uma forma de importar projetos para o Snyk programaticamente. Por isso, estamos muito animados para ver como vão usar a API de importação para integrar melhor o Snyk aos sistemas que já utilizam. Depois de testar a API de importação, conte para nós o que achou, para que possamos entender como melhorá-la no futuro!

Alguns clientes automatizaram a criação de repositórios e vão usar essa API para garantir que todos os novos repositórios sejam monitorados automaticamente em busca de vulnerabilidades de segurança ou violações das políticas de licença.

Um pedido frequente é importar automaticamente novos repositórios e aplicativos sem servidor à medida que são criados. Para ajudar você a começar, preparamos um pequeno exemplo de código que usa a API de repositórios do GitHub para listar todos os repositórios modificados desde determinado momento e importá-los para o Snyk.

O código está disponível como um módulo npm. Com um único comando, você pode importar os repositórios novos ou modificados no último dia:

$ npm install -g snyk-github-import
$ snyk-github-import --orgId=c0caaa2f-6c04-4be3-876b-c72553a5551f --integrationId=ab4633ac-e6bb-4d27-854a-328c0f33c3e8  --githubToken=212312cq1bfb1bcfb13042ff5a13d01ab12f12f4

Por exemplo, configurando uma tarefa Cron, você pode usar esse script para importar repositórios automaticamente de forma recorrente. Também é possível usá-lo para configurar programaticamente novas organizações com todas as bases de código que você quer monitorar. Acesse nossa documentação da API para saber mais. O acesso à API do Snyk está disponível somente nos planos pagos.