Analizar paquetes de Java manualmente

En esta guía de inicio rápido se muestra cómo extraer una imagen de contenedor, analizarla manualmente con On-Demand Scanning y recuperar las vulnerabilidades identificadas en paquetes del sistema y de Maven. Para seguir esta guía de inicio rápido, usarás Cloud Shell y una imagen de Alpine de ejemplo.

Antes de empezar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the On-Demand Scanning API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the On-Demand Scanning API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

    Descargar y analizar una imagen

    1. Abre Cloud Shell en tu proyecto.

      Abrir Cloud Shell

      Se abrirá una terminal con todas las herramientas necesarias para seguir esta guía.

    2. Usa Docker para extraer la imagen de contenedor:

      docker pull jenkins:2.60.3-alpine

    3. Ejecuta el análisis:

      gcloud artifacts docker images scan jenkins:2.60.3-alpine --additional-package-types=MAVEN

      Esto activa el proceso de análisis y devuelve el nombre del análisis cuando finaliza:

      ✓ Scanning container image 
  ✓ Locally extracting packages and versions from local container image
  ✓ Remotely initiating analysis of packages and versions
  ✓ Waiting for analysis operation to complete [projects/my-project/locations/us/operations/1a6fd941-b997-4e5f-ba4f-6351f30e7dad]
Done.

done: true
metadata:
  '@type': type.googleapis.com/google.cloud.ondemandscanning.v1.AnalyzePackagesMetadata
  createTime: '2021-01-26T13:43:53.112123Z'
  resourceUri: jenkins:2.60.3-alpine
name: projects/my-project/locations/us/operations/1a6fd941-b99f-4eaf-ba4f-6e5af30e7dad
response:
  '@type': type.googleapis.com/google.cloud.ondemandscanning.v1.AnalyzePackagesResponse
  scan: projects/my-project/locations/us/scans/893c91ce-7fe6-4f1a-a69a-d6ca1b465160

    4. Usa el nombre del análisis, el valor de scan de la salida, para obtener los resultados del análisis:

      gcloud artifacts docker images list-vulnerabilities \
projects/my-project/locations/us/scans/893c91ce-7fe6-4f1a-a69a-d6ca1b465160

      El resultado contiene una lista de vulnerabilidades de paquetes de Maven y Linux. Las vulnerabilidades de los paquetes de Maven se pueden identificar mediante el campo packageType:MAVEN.

    Limpieza

    Para evitar que se apliquen cargos en tu cuenta de Google Cloud por los recursos utilizados en esta página, sigue estos pasos.

    Si has creado un proyecto para esta guía, ahora puedes eliminarlo.

    • Abre la página Configuración (en IAM y administración) en la Google Cloud consola.

      Abre la página Configuración

    • Haz clic en Seleccionar un proyecto.

    • Selecciona el proyecto que quieras eliminar y haz clic en Abrir.

    • Haz clic en Apagar.

    • Introduce el ID del proyecto y haz clic en Cerrar.

    Siguientes pasos