Segurança do Pub
O Dartastic Pub dá pontuação a todo package que você publica e aplica a política de segurança da sua organização a todo package que serve, inclusive os públicos. Esta página explica as pontuações, as políticas, o que uma recusa significa e o que fazer a respeito.
A aba Scores
A aba Scores de cada package no seu Dartastic Pub mostra dois números. Depois que uma versão é publicada, o Dartastic Pub analisa a última versão estável e a última versão de pré-lançamento do package em um worker isolado, sem acesso à internet.
- Pub points: o relatório de 160 pontos do pana, o mesmo que o pub.dev mostra. Uma linha é diferente: a linha de licença passa com uma licença real de qualquer tipo, porque uma licença comercial é a certa para código privado. Uma licença ausente, vazia ou de modelo continua reprovada, e a aba informa que a linha foi alterada.
- Security Score: de 0 a 100, com uma nota, para o que o pana não verifica. Cada verificação mostra o que examinou, o que encontrou e como corrigir.
Quando uma análise não consegue terminar (ficou sem memória ou sem tempo, ou uma dependência não pôde ser resolvida), a aba informa isso e o motivo, em vez de mostrar uma pontuação baixa.
As verificações do Security Score
| Verificação | Pontos | O que ela examina |
|---|---|---|
| Known advisories | 30 | Avisos de segurança conhecidos nesta versão e em todo package para o qual ela foi resolvida. |
| Secrets in the archive | 20 | Tokens, chaves e arquivos de credenciais esquecidos no arquivo. Quem pode ler o package vê que tipo foi encontrado; só os administradores dele veem onde. |
| Review verdict | 10 | O veredito de uma revisão de segurança sobre esta versão. |
| Binaries and build hooks | 15 | Binários nativos e build hooks no arquivo, cada um registrado com o sha256. Eles ganham estes pontos depois de revisados e permitidos. FFI sozinho não custa pontos. |
| Publisher and provenance | 15 | Quem publica o package, e se isso mudou. |
| Same uploader as the last release | 5 | Se a pessoa que fez o upload desta versão também fez o upload da anterior. |
| Release age | 5 | Se a versão tem pelo menos 7 dias. |
- Uma verificação sem dados para avaliar fica de fora: a pontuação é ajustada à escala das verificações que rodaram, e a aba lista as que não rodaram. Ela nunca conta como aprovada.
- Notas: A a partir de 90, B a partir de 80, C a partir de 70, D a partir de 60, F abaixo de 60. A e B aparecem em azul, C em amarelo, D e F em vermelho.
- Uma versão em quarentena ou negada recebe 0. Um administrador pode definir qualquer uma das pontuações manualmente; a aba então informa isso, e a pontuação calculada fica registrada.
- Uma pontuação informa o que foi verificado. Ela não promete que um package é seguro.
A política de segurança da sua organização
Cada organização tem uma política, Standard a menos que um administrador a mude. Ela decide quanto tempo novas versões públicas esperam e o que acontece com uma versão sinalizada na revisão.
| Política | Novas versões públicas | Uma versão sinalizada na revisão |
|---|---|---|
| MonitorVisibilidade total, sem interrupções | Servidas na hora | Servida e contabilizada |
| StandardProteção equilibrada para equipes em produção | Esperam 3 dias | Servida, e sinalizada na página do package |
| StrictControle máximo para ambientes regulados | Esperam 7 dias, e esperam por uma pessoa enquanto houver uma revisão aberta | Não servida |
Os packages da própria organização nunca esperam e nunca ficam retidos para revisão. Nenhuma política serve uma versão em quarentena ou negada.
Novas versões públicas esperam
Uma versão pública mais nova que o limite da sua política fica de fora das versões que o seu Dartastic Pub serve, então o dart pub get resolve para a versão mais nova que já tem idade suficiente. Nada falha. Um administrador pode aprovar uma versão antes, ou rejeitá-la.
Se um lockfile já fixa uma versão que ainda está esperando, o dart pub get a recusa e informa a data em que ela fica disponível.
Revisão e vereditos
Alguns sinais mandam uma versão para revisão: um nome a um erro de digitação de um package popular, um package público cujo publicador mudou, um package parado há muito tempo que de repente lança uma versão, ou um novo uploader em um package seu. Na política Strict, a versão espera enquanto a revisão está aberta.
Uma revisão termina em um veredito. allow serve a versão. warn a serve, sinalizada na página dela, exceto na Strict. quarantine e deny a barram para todas as organizações.
Quality gates
Um administrador da organização pode definir um quality gate: pub points mínimos, um Security Score mínimo e verificações que precisam passar. Uma versão abaixo do gate fica de fora das versões servidas à sua organização, então o dart pub get não pode escolhê-la.
Um package público não tem pub points aqui, então um mínimo de pub points não o retém. Uma verificação obrigatória precisa ter passado, então uma que não rodou reprova a versão.
Sua CI pode perguntar se uma versão passou, com o mesmo token do Pub que usa para ler. O status da resposta é allow, warn, block ou pending. Continue consultando enquanto for pending, o que significa que a análise ainda não terminou:
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0{
"package": "acme_models",
"version": "1.3.0",
"status": "block",
"securityScore": 73,
"pubPoints": 140,
"reasons": ["Security Score 73 is below 80."],
"gate": { "action": "block", "minSecurityScore": 80, "minPubPoints": 120, … }
}Para deixar uma versão passar pelo gate, um administrador da organização a isenta, com um motivo. Isso libera o gate apenas para essa versão.
Quando o dart pub get recusa uma versão
Uma recusa diz o motivo e o que fazer. O que cada uma significa:
| A mensagem | O que significa |
|---|---|
Your organization's security policy holds <package> <version> until <date>. | Sua política retém esta versão pública até a data mostrada. Espere, dependa de uma versão mais antiga ou peça a um administrador da organização que a aprove antes. |
Your organization's security policy holds every version of <package>. | Todas as versões deste package público são mais novas do que sua política permite. A primeira fica disponível na data mostrada. |
An organization admin rejected <package> <version>. | Um administrador da organização rejeitou esta versão. Dependa de outra, ou peça a ele que libere esta. |
<package> <version> is quarantined while it is reviewed. | A versão está em revisão e não é servida a ninguém até a revisão terminar. Dependa de outra versão. |
<package> <version> was denied. | Uma revisão concluiu que esta versão é ruim. Dependa de outra versão. |
A security review flagged <package> <version>, … | Uma revisão sinalizou esta versão, e sua política (Strict) não serve versões sinalizadas. Dependa de outra versão ou peça uma isenção a um administrador da organização. |
<package> <version> is waiting on a security review, … | A versão tem uma revisão aberta, e sua política (Strict) espera que ela seja encerrada. Dependa de outra versão ou peça a um administrador da organização que a isente. |
<package> <version> does not meet your organization's quality gate. | A versão fica abaixo do quality gate da sua organização; a mensagem lista os motivos. Dependa de outra versão ou peça a um administrador da organização que a isente. |
A página de segurança
Os administradores da organização gerenciam tudo isso na página de segurança, https://pub.dartastic.io/security-admin, com login no seu Dartastic Pub. Toda ação ali é auditada com quem a executou e quando. Ali um administrador pode:
- Aprovar antes, ou rejeitar, uma versão que a política retém
- Colocar em quarentena, tirar da quarentena ou negar uma versão dos packages da própria organização
- Definir uma pontuação manualmente nos packages da própria organização
- Adicionar ou remover uma isenção, com um motivo
- Escolher a política da organização e o quality gate dela
- Ver cada versão com um veredito ou um aviso de segurança conhecido que a organização baixou, quem a baixou, com que frequência e quando, e quais dos packages da organização dependem dela