Las Dependabot alerts indican que el código depende de un paquete que no es seguro. A menudo, el software se crea mediante paquetes de código abierto de una gran variedad de orígenes. Las relaciones complejas entre estas dependencias y la facilidad con la que los actores malintencionados pueden insertar malware en código ascendente, significa que es posible que no sepa usar dependencias que tienen errores de seguridad, también conocidos como vulnerabilidades.
Si el código depende de un paquete con una vulnerabilidad de seguridad, esto puede causar una serie de problemas al proyecto o a las personas que lo usan. El uso de un paquete vulnerable lo convierte en un destino flexible para usuarios malintencionados que buscan vulnerar la seguridad de su sistema. Por ejemplo, pueden buscar obtener acceso al código y a los datos de los clientes o colaboradores. Debes actualizar a una versión segura del paquete lo antes posible.
Para obtener información general sobre las diferentes características que ofrece Dependabot e instrucciones sobre cómo empezar, consulta «Guía de inicio rápido de Dependabot».
Detección de dependencias no seguras
Dependabot lleva a cabo un examen de la rama de valor predeterminado de su repositorio para detectar las dependencias no seguras y envía Dependabot alerts cuando:
-
Se sincronizan nuevos datos de aviso en tu instancia de GitHub Enterprise Server cada hora desde GitHub.com. Para obtener más información, vea «Exploración de los avisos de seguridad en GitHub Advisory Database».
Nota: Solo los avisos revisados por GitHub desencadenarán Dependabot alerts.
-
Cambia el gráfico de dependencias de un repositorio. Por ejemplo, cuando un colaborador inserta una confirmación para cambiar los paquetes o las versiones de las que depende . Para obtener más información, vea «Acerca del gráfico de dependencias».
Nota: Dependabot no examina los repositorios archivados.
Además, GitHub puede revisar cualquier dependencia que se agregue, actualice o quite en una solicitud de incorporación de cambios que se haga en la rama predeterminada de un repositorio, así como marcar cualquier cambio que pudiera disminuir la seguridad del proyecto. Esto le permite detectar y tratar dependencias vulnerables antes de que lleguen a su código base, no después. Para obtener más información, vea «Revisar los cambios de las dependencias en una solicitud de cambios».
Como las Dependabot alerts dependen del gráfico de dependencias, los ecosistemas admitidos por Dependabot alerts son los mismos que los admitidos por el gráfico de dependencias. Para ver una lista de estos ecosistemas, consulta "Acerca del gráfico de dependencias".
Nota: Es importante mantener actualizados el manifiesto y los archivos de bloqueo. Si el gráfico de dependencias no refleja con exactitud tus versiones y dependencias actuales, es posible que pases por alto las alertas de las dependencias no seguras que usas. También podrías obtener alertas de las dependencias que ya no utilizas.
Dependabot solo creará Dependabot alerts para los datos de GitHub Actions que usan el control de versiones semántico. No recibirás alertas para una acción vulnerable que use el control de versiones SHA. Si usas GitHub Actions con el control de versiones SHA, se recomienda habilitar Dependabot version updates para el repositorio u organización para mantener las acciones que usas actualizadas a las versiones más recientes.
Configuración de Dependabot alerts
Los propietarios de empresa deben habilitar Dependabot alerts para tu instancia de GitHub Enterprise Server antes de poder usar esta característica. Para obtener más información, vea «Habilitación de Dependabot para la empresa».
Cuando GitHub Enterprise Server identifica una dependencia vulnerable, generamos una alerta Dependabot y la mostramos en la pestaña Seguridad del repositorio y en el gráfico de dependencias del repositorio. La alerta incluye un enlace al archivo afectado en el proyecto e información acerca de la versión arreglada.
GitHub Enterprise Server también puede notificar a los mantenedores de repositorios afectados que hay nuevas alertas según sus preferencias de notificación. Para más información, consulta "Configuración de notificaciones para alertas de Dependabot."
En los repositorios donde Dependabot security updates están habilitadas, la alerta también puede contener un vínculo a una solicitud de incorporación de cambios para actualizar el manifiesto o el archivo de bloqueo a la versión mínima que resuelve la vulnerabilidad. Para obtener más información, vea «Sobre las actualizaciones de seguridad de Dependabot».
Nota: Las características de seguridad de GitHub Enterprise Server no notifican la captura de todas las vulnerabilidades. Mantenemos GitHub Advisory Database activamente y generamos alertas con la información más actualizada. Aun así, no podemos detectarlo todo ni informarle sobre vulnerabilidades conocidas dentro de un plazo garantizado. Estas características no sustituyen la revisión humana de posibles vulnerabilidades u otras incidencias en cada dependencia, y se recomienda consultar con un servicio de seguridad o realizar una revisión exhaustiva de las dependencias cuando sea necesario.
Acceder a las Dependabot alerts
Puede ver todas las alertas que afectan a un proyecto determinado en el gráfico de dependencias del repositorio. Para obtener más información, vea «Visualización y actualización de alertas de Dependabot».
De forma predeterminada, se informa a los usuarios con permisos de escritura, mantenimiento o administración en los repositorios afectados acerca de las nuevas Dependabot alerts.
Para recibir notificaciones sobre Dependabot alerts en los repositorios, tendrá que observarlos y suscribirse para recibir notificaciones de "Toda la actividad", o bien configurar valores personalizados para incluir "Alertas de seguridad". Para obtener más información, vea «Configuración de notificaciones». Puedes elegir el método de entrega de las notificaciones, así como la frecuencia en las que se te envían. Para más información, consulta "Configuración de notificaciones para alertas de Dependabot".
También puedes ver todas las Dependabot alerts que se corresponden con un aviso concreto en GitHub Advisory Database. Para obtener más información, vea «Exploración de los avisos de seguridad en GitHub Advisory Database».