Fluxo de trabalho
Jira e Linear
Envie tarefas de remediação para o rastreador que os seus desenvolvedores usam. Quando uma verificação posterior confirma a correção, a issue é fechada; quando alguém fecha a issue, a tarefa é fechada.
Conectar o Jira Cloud
- 1
Crie um token de API
Na sua conta Atlassian, abra Tokens de API e crie um. Ele age em seu nome, então use uma conta que possa criar issues no projeto. - 2
Conecte na Scanverra
Em Integrações, na seção Rastreadores de issues, clique em Conectar Jira e informe o site (acme.atlassian.net), o e-mail da conta, o token e a chave do projeto (por exemploSEC). - 3
A Scanverra confere
O token e o projeto são testados antes de qualquer coisa ser salva. O token é criptografado e nunca mais exibido.
Conectar o Linear
- 1
Crie uma chave de API pessoal
No Linear, abra Security and access e crie uma chave de API pessoal. - 2
Conecte na Scanverra
Em Integrações, clique em Conectar Linear e informe a chave e a chave do time (por exemploENG).
Opções
| Campo | Descrição |
|---|---|
Abrir uma issue quando uma descoberta for atribuídaligado ou desligadoOpcional | Desligado por padrão. Ligado, atribuir uma descoberta a alguém também cria a issue. |
Para descobertas de pelo menoscritical, high, medium, lowOpcional | Só descobertas dessa gravidade ou acima recebem uma issue automática. Qualquer uma ainda pode ser enviada manualmente. |
Fechar a issue quando a tarefa for corrigidaligado ou desligadoOpcional | Ligado por padrão. A issue vai para um estado concluído com um comentário explicando o motivo. |
Como a sincronização funciona
A sincronização roda uma vez por dia e sempre que um administrador do time clica em Sincronizar agora na página Integrações.
Uma verificação confirma a correção
A tarefa é fechada na Scanverra e, na próxima sincronização, a issue vai para concluída com um comentário.
Alguém fecha a issue
Na próxima sincronização, a tarefa é fechada na Scanverra. No Remediation Hub ela segue o seu workflow como qualquer outra mudança.
Enviar manualmente
Abra uma tarefa e use Enviar para o Jira ou Enviar para o Linear. Cada tarefa tem no máximo uma issue por rastreador.
O que a issue contém
O título, a gravidade, o alvo e a descrição da descoberta, mais um link de volta para a descoberta no relatório. Issues do Jira recebem os rótulos
scanverraeseverity-high(e assim por diante); issues do Linear, a prioridade correspondente.
Solução de problemas
"O rastreador recusou as credenciais"
O token foi revogado ou o e-mail não corresponde. Desconecte e conecte de novo com um token novo.
"Informe um site do Jira Cloud"
Só são aceitos sites do Jira Cloud que terminam em
.atlassian.net."Projeto ou time não encontrado"
Confira a chave do projeto no Jira (ela aparece nas chaves das issues, como SEC-12) ou a chave do time nas configurações do time no Linear.
"O rastreador está limitando as solicitações"
Chamadas demais em pouco tempo. A sincronização para naquele rastreador e tenta de novo na próxima vez.