Estas páginas mostram as URLs do Cloud. Faça login no Dedicated e elas passam a mostrar as do seu servidor.

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.

BUILDARQUITETURA DARTASTICUSUÁRIOStokensissuestoken do Pubpushtroca na CIos apps chegam aos usuários: lojas de apps, a web, servidoressímboloscrashesstack tracescódigo-fontetelemetriaComputador do desenvolvedorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcriação de tokens · controle de acesso por papéisPlano de controleorganizações · papéis · tokensDartastic Pubpackages · código-fonteObservatorysessões · traces · logsSymbolizercrashes → linhas do código-fonteDartastic AIrespostas a partir dos doisIssue trackerGitHub · Jira · LinearApps mobile e desktopcelulares · tablets · desktopsenvia com um token OTLPApps webem navegadoresenvia com um token Browser OTLPServidores Dartbackends · serviçosenvia com um token OTLP

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çãoPontosO que ela examina
Known advisories30Avisos de segurança conhecidos nesta versão e em todo package para o qual ela foi resolvida.
Secrets in the archive20Tokens, 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 verdict10O veredito de uma revisão de segurança sobre esta versão.
Binaries and build hooks15Biná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 provenance15Quem publica o package, e se isso mudou.
Same uploader as the last release5Se a pessoa que fez o upload desta versão também fez o upload da anterior.
Release age5Se 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íticaNovas versões públicasUma versão sinalizada na revisão
MonitorVisibilidade total, sem interrupçõesServidas na horaServida e contabilizada
StandardProteção equilibrada para equipes em produçãoEsperam 3 diasServida, e sinalizada na página do package
StrictControle máximo para ambientes reguladosEsperam 7 dias, e esperam por uma pessoa enquanto houver uma revisão abertaNã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:

shell
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
  https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0
json
{
  "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 mensagemO 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