Estas páginas muestran las URL de Cloud. Inicie sesión en Dedicated y muestran las de su servidor.

Seguridad de Pub

Dartastic Pub puntúa cada paquete que usted publica y aplica la política de seguridad de su organización a cada paquete que sirve, incluidos los públicos. Esta página explica las puntuaciones, las políticas, qué significa un rechazo y qué hacer al respecto.

DESARROLLOARQUITECTURA DE DARTASTICUSUARIOStokensticketstoken de Pubpushintercambio de CIlas apps llegan a los usuarios: tiendas de apps, la web, servidoressímboloscrashespilas de llamadascódigo fuentetelemetríaEquipo del desarrolladorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcrear tokens · control de acceso por rolesPlano de controlorganizaciones · roles · tokensDartastic Pubpaquetes · código fuenteObservatorysesiones · trazas · logsSymbolizercrashes → líneas de códigoDartastic AIrespuestas a partir de ambosGestor de ticketsGitHub · Jira · LinearApps móviles y de escritorioteléfonos · tabletas · equiposenvía con un token OTLPApps weben navegadoresenvía con un token Browser OTLPServidores Dartbackends · serviciosenvía con un token OTLP

La pestaña Scores

La pestaña Scores de cada paquete en su Dartastic Pub muestra dos números. Después de publicar una versión, Dartastic Pub analiza la última versión estable y la última versión preliminar del paquete en un worker aislado sin acceso a internet.

  • Pub points: el informe de 160 puntos de pana, el mismo que muestra pub.dev. Una línea cambia: la línea de licencia se aprueba con una licencia real de cualquier tipo, porque una licencia comercial es lo correcto para código privado. Una licencia ausente, vacía o de plantilla sigue sin aprobarla, y la pestaña indica que la línea se cambió.
  • Security Score: de 0 a 100 con una calificación, para lo que pana no revisa. Cada comprobación muestra qué revisó, qué encontró y cómo corregirlo.

Cuando un análisis no puede terminar (se quedó sin memoria o sin tiempo, o no se pudo resolver una dependencia), la pestaña lo indica y explica por qué, en lugar de mostrar una puntuación baja.

Las comprobaciones del Security Score

ComprobaciónPuntosQué revisa
Known advisories30Avisos de seguridad conocidos en esta versión y en cada paquete al que se resolvió.
Secrets in the archive20Tokens, claves y archivos de credenciales olvidados en el archivo. Quien puede leer el paquete ve qué tipo se encontró; solo sus administradores ven dónde.
Review verdict10El veredicto de una revisión de seguridad sobre esta versión.
Binaries and build hooks15Binarios nativos y build hooks en el archivo, cada uno registrado con su sha256. Obtienen estos puntos una vez revisados y permitidos. FFI por sí solo no los resta.
Publisher and provenance15Quién publica el paquete, y si eso cambió.
Same uploader as the last release5Si la persona que subió esta versión también subió la anterior.
Release age5Si la versión tiene al menos 7 días.
  • Una comprobación sin datos con qué trabajar queda fuera: la puntuación se escala sobre las comprobaciones que se ejecutaron, y la pestaña lista las que no. Nunca cuenta como aprobada.
  • Calificaciones: A desde 90, B desde 80, C desde 70, D desde 60, F por debajo de 60. A y B se muestran en azul, C en amarillo, D y F en rojo.
  • Una versión en cuarentena o denegada obtiene 0. Un administrador puede fijar cualquiera de las dos puntuaciones a mano; la pestaña lo indica, y la puntuación calculada queda registrada.
  • Una puntuación informa de lo que se comprobó. No promete que un paquete sea seguro.

La política de seguridad de su organización

Cada organización tiene una política, Standard salvo que un administrador la cambie. Decide cuánto esperan las versiones públicas nuevas y qué pasa con una versión marcada en revisión.

PolíticaVersiones públicas nuevasUna versión marcada en revisión
MonitorVisibilidad total, sin interrupcionesSe sirven de inmediatoSe sirve y se contabiliza
StandardProtección equilibrada para equipos en producciónEsperan 3 díasSe sirve, y se marca en la página del paquete
StrictControl máximo para entornos reguladosEsperan 7 días, y esperan a una persona mientras haya una revisión abiertaNo se sirve

Los paquetes propios de su organización nunca esperan y nunca se retienen para revisión. Ninguna política sirve una versión en cuarentena o denegada.

Las versiones públicas nuevas esperan

Una versión pública más reciente que el límite de su política queda fuera de las versiones que sirve su Dartastic Pub, así que dart pub get resuelve a la versión más reciente con antigüedad suficiente. Nada falla. Un administrador puede aprobar una versión antes de tiempo, o rechazarla.

Si un lockfile ya fija una versión que todavía espera, dart pub get la rechaza e indica la fecha en que queda disponible.

Revisión y veredictos

Algunas señales envían una versión a revisión: un nombre a un error tipográfico de un paquete popular, un paquete público cuyo publicador cambió, un paquete inactivo durante mucho tiempo que de repente publica, o un uploader nuevo en un paquete suyo. Con Strict, la versión espera mientras su revisión esté abierta.

Una revisión termina en un veredicto. allow sirve la versión. warn la sirve, marcada en su página, salvo con Strict. quarantine y deny la detienen para todas las organizaciones.

Controles de calidad

Un administrador de la organización puede definir un control de calidad: un mínimo de pub points, un Security Score mínimo y comprobaciones que deben aprobarse. Una versión por debajo del control queda fuera de las versiones que recibe su organización, así que dart pub get no puede elegirla.

Un paquete público no tiene pub points aquí, así que un mínimo de pub points no lo retiene. Una comprobación obligatoria debe haberse aprobado, así que una que no se ejecutó no supera el control.

Su CI puede preguntar si una versión aprobó, con el mismo token de Pub con el que lee. El status de la respuesta es allow, warn, block o pending. Siga consultando mientras sea pending, que significa que el análisis no ha terminado:

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 dejar pasar una versión por el control, un administrador de la organización la exime, con un motivo. Eso levanta el control solo para esa versión.

Cuando dart pub get rechaza una versión

Un rechazo dice por qué y qué hacer. Qué significa cada uno:

El mensajeQué significa
Your organization's security policy holds <package> <version> until <date>.Su política retiene esta versión pública hasta la fecha indicada. Espere, dependa de una versión anterior o pida a un administrador de la organización que la apruebe antes de tiempo.
Your organization's security policy holds every version of <package>.Todas las versiones de este paquete público son más recientes de lo que su política permite. La primera queda disponible en la fecha indicada.
An organization admin rejected <package> <version>.Un administrador de la organización rechazó esta versión. Dependa de otra, o pídale que levante el rechazo.
<package> <version> is quarantined while it is reviewed.La versión está en revisión y no se sirve a nadie hasta que la revisión termine. Dependa de otra versión.
<package> <version> was denied.Una revisión determinó que esta versión es mala. Dependa de otra versión.
A security review flagged <package> <version>, …Una revisión marcó esta versión, y su política (Strict) no sirve versiones marcadas. Dependa de otra versión, o pida una exención a un administrador de la organización.
<package> <version> is waiting on a security review, …La versión tiene una revisión abierta, y su política (Strict) espera a que se cierre. Dependa de otra versión, o pida a un administrador de la organización que la exima.
<package> <version> does not meet your organization's quality gate.La versión queda por debajo del control de calidad de su organización; el mensaje indica por qué. Dependa de otra versión, o pida a un administrador de la organización que la exima.

La página de seguridad

Los administradores de la organización gestionan todo esto en la página de seguridad, https://pub.dartastic.io/security-admin, con la sesión iniciada en su Dartastic Pub. Cada acción allí queda auditada con quién la realizó y cuándo. Allí un administrador puede:

  • Aprobar antes de tiempo, o rechazar, una versión que la política retiene
  • Poner en cuarentena, sacar de cuarentena o denegar una versión de los paquetes propios de la organización
  • Fijar una puntuación a mano en los paquetes propios de la organización
  • Agregar o quitar una exención, con un motivo
  • Elegir la política de la organización y su control de calidad
  • Ver cada versión con un veredicto o un aviso de seguridad conocido que la organización descargó, quién la descargó, con qué frecuencia y cuándo, y cuáles de sus paquetes dependen de ella