Realiza la integración con Assured OSS para la seguridad del código

El nivel premium de Assured Open Source Software (Assured OSS) te permite mejorar la seguridad de tu código con los paquetes de OSS que Google usa para sus propios flujos de trabajo de desarrollador. Cuando usas Assured OSS, tus desarrolladores pueden aprovechar la experiencia y los conocimientos de seguridad que Google aplica para proteger sus propias dependencias de código abierto.

Cuando integras Assured OSS en Security Command Center, puedes hacer lo siguiente:

  • Elige entre miles de paquetes de Java, Python, Go y JavaScript (NPM) seleccionados y más populares, incluidos los proyectos comunes de aprendizaje automático e inteligencia artificial, como TensorFlow, Pandas y Scikit-learn.
  • Configura un proxy seguro para descargar todos los paquetes de Java, Python, Go y JavaScript con certificaciones de Assured OSS, lo que convierte a Google en un proveedor conocido y de confianza.
  • Usa las SBOM y la VEX en Assured OSS que se proporcionan en formatos estándar de la industria, como SPDX y CycloneDX, para obtener más información sobre tus ingredientes.
  • Aumenta la confianza en la integridad de los paquetes que usas a través de una procedencia firmada y evidente de Google.
  • Reduce el riesgo de seguridad, ya que Google analiza, detecta y corrige de forma activa las vulnerabilidades nuevas en los paquetes seleccionados.

Regiones admitidas

El nivel premium de Assured OSS admite las siguientes regiones y multirregiones deGoogle Cloud para los repositorios remotos (o proxy) de Artifact Registry:

  • asia-southeast2
  • australia-southeast1
  • australia-southeast2
  • europe-north1
  • europe-north2
  • europe-west1
  • europe-west2
  • europe-west3
  • europe-west4
  • northamerica-northeast1
  • northamerica-northeast2
  • europe
  • us

La compatibilidad con los metadatos de seguridad se limita a la multirregión us.

Antes de comenzar

Completa estas tareas antes de completar las tareas restantes de esta página.

Activa el nivel Enterprise o Premium de Security Command Center

Verifica que el nivel Premium de Security Command Center o el nivel Enterprise de Security Command Center estén activados a nivel de la organización.

Configura permisos a nivel de la organización

Debes configurar los permisos a nivel de la organización y del proyecto.

    Asegúrate de tener los siguientes roles en la organización: Administrador de Security Center, Administrador de la organización

    Verifica los roles

    1. En la consola de Google Cloud , dirígete a la página IAM.

      Ir a IAM
    2. Selecciona la organización.
    3. En la columna Principal, busca todas las filas que te identifiquen a ti o a un grupo en el que se te incluya. Para saber en qué grupos estás incluido, comunícate con tu administrador.

    4. Para todas las filas en las que se te especifique o se te incluya, verifica la columna Rol para ver si la lista de roles incluye los roles necesarios.

    Otorga los roles

    1. En la consola de Google Cloud , dirígete a la página IAM.

      Ir a IAM
    2. Selecciona la organización.
    3. Haz clic en Otorgar acceso.
    4. En el campo Principales nuevas, ingresa tu identificador de usuario. Este suele ser el identificador de un usuario que pertenece a un grupo de identidades de personal. Para obtener más información, consulta Representa a los usuarios del grupo de personal en políticas de IAM o comunícate con el administrador.

    5. Haz clic en Selecciona un rol y, luego, busca el rol.
    6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
    7. Haz clic en Guardar.

Configura permisos a nivel del proyecto

    Asegúrate de tener los siguientes roles en el proyecto: Administrador de Service Usage, Administrador de cuentas de servicio y Administrador de IAM del proyecto

    Verifica los roles

    1. En la consola de Google Cloud , dirígete a la página IAM.

      Ir a IAM
    2. Selecciona el proyecto.
    3. En la columna Principal, busca todas las filas que te identifiquen a ti o a un grupo en el que se te incluya. Para saber en qué grupos estás incluido, comunícate con tu administrador.

    4. Para todas las filas en las que se te especifique o se te incluya, verifica la columna Rol para ver si la lista de roles incluye los roles necesarios.

    Otorga los roles

    1. En la consola de Google Cloud , dirígete a la página IAM.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Otorgar acceso.
    4. En el campo Principales nuevas, ingresa tu identificador de usuario. Este suele ser el identificador de un usuario que pertenece a un grupo de identidades de personal. Para obtener más información, consulta Representa a los usuarios del grupo de personal en políticas de IAM o comunícate con el administrador.

    5. Haz clic en Selecciona un rol y, luego, busca el rol.
    6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
    7. Haz clic en Guardar.

Configura Google Cloud CLI

Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando:

gcloud init

Configurar Assured OSS

Console

Estos pasos solo se aplican al nivel Security Command Center Enterprise.

  1. En la consola de Google Cloud , ve a la Guía de configuración de Security Command Center.

    Ir a la Guía de configuración

  2. Verifica que estés viendo la organización en la que activaste el nivel Security Command Center Enterprise.

  3. Expande el panel Consulta el resumen de las funciones de seguridad.

  4. Haz clic en Seguridad del código > Configurar.

  5. En el panel Configura la seguridad del código, haz clic en Configuración de AOSS.

  6. Selecciona una cuenta de servicio nueva o selecciona las cuentas de servicio existentes a las que quieres agregar los permisos de Assured Open Source Software.

  7. Selecciona el proyecto y la región de Google Cloud en los que deseas ubicar los recursos de Assured OSS.

  8. Haz clic en Configurar Assured OSS.

    El proceso de configuración completa automáticamente lo siguiente:

    • Si se selecciona, se crea la cuenta de servicio nueva assuredoss@PROJECT_ID.gservicesaccount.com.
    • Asigna el rol de usuario de Assured OSS a la cuenta de servicio designada para usarla con Assured OSS.
    • Asigna el rol de administrador de Assured OSS a la cuenta de usuario conectada para que pueda configurar el servicio.
    • Habilita la API de Assured Open Source Software y, si aún no está habilitada, la API de Artifact Registry.
    • Configura el servicio de proxy de Assured OSS en una instancia de Artifact Registry en el proyecto que seleccionaste. Se aprovisiona un repositorio para cada lenguaje (Java, Python, Go y JavaScript [NPM]). Estos repositorios pueden extraer paquetes automáticamente de la cartera seleccionada. Si un paquete no está disponible como parte de la cartera seleccionada, los repositorios redireccionan la solicitud a los repositorios canónicos. Para obtener más información, consulta Opciones de repositorios de Assured OSS.
    • Te otorga a ti y a la cuenta de servicio permisos para acceder a los metadatos del paquete y a las notificaciones de los proyectos que son propiedad de Google.
  9. Crea una clave de cuenta de servicio para cada cuenta de servicio de Assured OSS designada y descarga la clave en formato JSON.

  10. En la línea de comandos de tu máquina local, ejecuta el siguiente comando en el archivo de claves descargado para obtener la cadena codificada en Base64:

    base64 KEY_FILENAME.json
    

    Reemplaza KEY_FILENAME.json por el nombre de la clave de la cuenta de servicio que descargaste.

    Necesitas la cadena codificada en Base64 cuando configuras un repositorio remoto para Assured OSS.

  11. Para descargar los paquetes, usa los extremos que Assured OSS aprovisiona para cada lenguaje. Toma nota de estos extremos para usarlos más adelante.

    • Java:
      https://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java
    • Python:
      https://LOCATION-python.pkg.dev/PROJECT_ID/assuredoss-python
    • JavaScript (NPM):
      https://LOCATION-npm.pkg.dev/PROJECT_ID/assuredoss-javascript
    • Go:
      https://LOCATION-go.pkg.dev/PROJECT_ID/assuredoss-go

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto que seleccionaste cuando configuraste Assured OSS.

    • LOCATION: una región admitida

  12. Haz clic en Siguiente. Configura Assured OSS con el administrador de repositorios de artefactos de tu organización, como JFrog Artifactory o Sonatype Nexus.

gcloud

Estos pasos se aplican a Security Command Center Premium y Enterprise.

  1. Autentícate en Google Cloud con una cuenta de usuario que quieras usar para habilitar Assured OSS:

    gcloud auth revoke
    gcloud auth application-default revoke
    gcloud auth login
    
  2. Busca el proyecto en el que deseas ubicar los recursos de Assured OSS:

    gcloud alpha projects search --query="displayName=PROJECT_NAME"
    

    Reemplaza PROJECT_NAME por el nombre del proyecto.

  3. Establece el proyecto en el que deseas ubicar los recursos de Assured OSS:

    gcloud config set project PROJECT_ID
    

    Reemplaza PROJECT_ID por el identificador del proyecto.

  4. Otorga roles a la cuenta de usuario para configurar Assured OSS:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=user:email@domain.com \
      --role=roles/assuredoss.admin
    
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=user:email@domain.com \
      --role=roles/serviceusage.serviceUsageAdmin
    
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=user:email@domain.com \
      --role=roles/iam.serviceAccountAdmin
    

    Donde email@domain.com es la dirección de correo electrónico de tu cuenta de usuario.

  5. Habilita Assured OSS en el proyecto. Cuando habilitas Assured OSS, también se habilita la API de Artifact Registry.

    gcloud services enable assuredoss.googleapis.com
    
  6. Para crear una cuenta de servicio nueva para Assured OSS en lugar de usar cuentas de servicio existentes, completa lo siguiente:

    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
      --description="Service account for using Assured OSS"
      --display-name="Assured OSS service account"
    

    Reemplaza SERVICE_ACCOUNT_NAME por el nombre de la cuenta de servicio (por ejemplo, assuredoss).

  7. Configura las cuentas de servicio para Assured OSS:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID. \
      --role roles/assuredoss.user
    

    Reemplaza lo siguiente:

    • SERVICE_ACCOUNT_NAME: Es el nombre de la cuenta de servicio (por ejemplo, assuredoss).
    • PROJECT_ID: Es el identificador del proyecto.
  8. Para acceder al repositorio de metadatos de seguridad después de configurar Assured OSS Premium con gcloud, envía un correo electrónico a customer-support-aoss@google.com con las cuentas de servicio que habilitaste para Assured OSS.
  9. Configura el servicio de proxy de Assured OSS en una instancia de Artifact Registry creando repositorios de Assured OSS. Debes crear repositorios para todos los idiomas. Especifica la región en la que el servicio de proxy de Assured OSS debe aprovisionar los repositorios.

    alias gcurlj='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -X'
    
    gcurlj POST https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories\?repositoryId\=assuredoss-java   -d '{"format": "MAVEN", "mode": "AOSS_REPOSITORY"}'
    
    gcurlj POST https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories\?repositoryId\=assuredoss-javascript   -d '{"format": "NPM", "mode": "AOSS_REPOSITORY"}'
    
    gcurlj POST https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories\?repositoryId\=assuredoss-python   -d '{"format": "PYTHON", "mode": "AOSS_REPOSITORY"}'
    
    gcurlj POST https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories\?repositoryId\=assuredoss-go   -d '{"format": "GO", "mode": "AOSS_REPOSITORY"}'
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto que seleccionaste cuando configuraste Assured OSS.

    • LOCATION: una región admitida

    Estos repositorios pueden extraer paquetes automáticamente de la cartera seleccionada. Si un paquete no está disponible como parte de la cartera seleccionada, los repositorios redireccionan la solicitud a los repositorios canónicos.

  10. Crea una clave de cuenta de servicio para cada cuenta de servicio de Assured OSS y descarga la clave en formato JSON.

  11. En la línea de comandos, ejecuta el siguiente comando en el archivo de claves descargado para obtener la cadena codificada en base64:

    base64 KEY_FILENAME.json
    

    Reemplaza KEY_FILENAME.json por el nombre de la clave de la cuenta de servicio que descargaste.

    Necesitas la cadena codificada en Base64 cuando configuras un repositorio remoto para Assured OSS.

  12. Para descargar los paquetes, usa los extremos aprovisionados por Assured OSS para cada lenguaje. Toma nota de estos extremos:

    • Java:
      https://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java
    • Python:
      https://LOCATION-python.pkg.dev/PROJECT_ID/assuredoss-python
    • JavaScript (NPM):
      https://LOCATION-npm.pkg.dev/PROJECT_ID/assuredoss-javascript
    • Go:
      https://LOCATION-go.pkg.dev/PROJECT_ID/assuredoss-go

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto que seleccionaste cuando configuraste Assured OSS.

    • LOCATION: una región admitida

  13. Configura Assured OSS para descargar paquetes con el administrador de repositorios de artefactos de tu organización, como JFrog Artifactory o Sonatype Nexus.

  14. De manera opcional, consulta los paquetes de Java, Python, Go y JavaScript disponibles:

    gcloud auth revoke
    gcloud auth application-default revoke
    gcloud auth login --cred-file=KEY_FILENAME.json
    

    Reemplaza KEY_FILENAME.json por el nombre de la clave de la cuenta de servicio que descargaste.

    export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILENAME.json
    

    Reemplaza KEY_FILENAME.json por el nombre de la clave de la cuenta de servicio que descargaste.

    gcurlj GET "https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/assuredoss-java/packages"
    gcurlj GET "https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/assuredoss-python/packages"
    gcurlj GET "https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/assuredoss-javascript/packages"
    gcurlj GET "https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/assuredoss-go/packages"
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto que seleccionaste cuando configuraste Assured OSS.

    • LOCATION: una región admitida

¿Qué sigue?