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.
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ón | Puntos | Qué revisa |
|---|---|---|
| Known advisories | 30 | Avisos de seguridad conocidos en esta versión y en cada paquete al que se resolvió. |
| Secrets in the archive | 20 | Tokens, 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 verdict | 10 | El veredicto de una revisión de seguridad sobre esta versión. |
| Binaries and build hooks | 15 | Binarios 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 provenance | 15 | Quién publica el paquete, y si eso cambió. |
| Same uploader as the last release | 5 | Si la persona que subió esta versión también subió la anterior. |
| Release age | 5 | Si 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ítica | Versiones públicas nuevas | Una versión marcada en revisión |
|---|---|---|
| MonitorVisibilidad total, sin interrupciones | Se sirven de inmediato | Se sirve y se contabiliza |
| StandardProtección equilibrada para equipos en producción | Esperan 3 días | Se sirve, y se marca en la página del paquete |
| StrictControl máximo para entornos regulados | Esperan 7 días, y esperan a una persona mientras haya una revisión abierta | No 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:
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 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 mensaje | Qué 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