Esegui l'integrazione con Assured OSS per la sicurezza del codice

Il livello premium di Assured Open Source Software (Assured OSS) ti consente di migliorare il codice la sicurezza tramite i pacchetti OSS che Google utilizza per il proprio sviluppatore per i flussi di lavoro. Quando utilizzi Assured OSS, i tuoi sviluppatori possono sfruttare la competenza e l'esperienza in materia di sicurezza che Google applica alla protezione delle proprie dipendenze open source.

Quando integri Assured OSS con Security Command Center, puoi:

  • Scegli tra migliaia di pacchetti Java e Python selezionati e più popolari, inclusi progetti comuni di machine learning e intelligenza artificiale come TensorFlow, Pandas e Scikit-learn.
  • Configura un proxy sicuro per scaricare tutti i pacchetti Java, Python e JavaScript con attestazioni di Assured OSS, rendendo Google un fornitore noto e affidabile.
  • Utilizza le SBOM e le VEX in Assured OSS fornite in formati standard di settore come SPDX e CycloneDX per scoprire di più sui tuoi componenti.
  • Aumenta la fiducia nell'integrità dei pacchetti in uso tramite la provenienza di Google firmata in modo da rilevare eventuali manomissioni.
  • Riduci i rischi per la sicurezza perché Google sta attivamente analizzando, trovando e correggendo nuovi le vulnerabilità in pacchetti selezionati.

Prima di iniziare

Completa queste attività prima di completare quelle rimanenti in questa pagina.

Attiva il livello Security Command Center Enterprise

Verifica che Security Command Center Enterprise viene attivata al livello organizzazione e di aver completato i primi sei passaggi della guida alla configurazione.

Configurare le autorizzazioni a livello di organizzazione

Devi configurare le autorizzazioni a livello di organizzazione e di progetto.

  1. Make sure that you have the following role or roles on the organization: Security Center Admin, Organization Admin

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the organization.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role colunn to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Vai a IAM
    2. Seleziona l'organizzazione.
    3. Fai clic su Concedi l'accesso.

    4. Nel campo Nuove entità, inserisci il tuo identificatore utente. In genere si tratta dell'indirizzo email di un Account Google.

    5. Nell'elenco Seleziona un ruolo, seleziona un ruolo.
    6. Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni altro ruolo.
    7. Fai clic su Salva.

Configurare le autorizzazioni a livello di progetto

  1. Make sure that you have the following role or roles on the project: Service Usage Admin, Service Account Admin, Project IAM Admin

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role colunn to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Vai a IAM
    2. Seleziona il progetto.
    3. Fai clic su Concedi l'accesso.

    4. Nel campo Nuove entità, inserisci il tuo identificatore utente. In genere si tratta dell'indirizzo email di un Account Google.

    5. Nell'elenco Seleziona un ruolo, seleziona un ruolo.
    6. Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni altro ruolo.
    7. Fai clic su Salva.

Configura Google Cloud CLI

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Configura Assured OSS

Console

  1. Nella console Google Cloud, vai alla pagina Panoramica dei rischi di Security Command Center.

    Vai a Panoramica dei rischi

  2. Accertati di visualizzare l'organizzazione per la quale hai attivato Livello Security Command Center Enterprise attivo.

  3. Fai clic su Visualizza la guida alla configurazione.

  4. Fai clic su Configura la sicurezza del codice.

  5. Seleziona un nuovo account di servizio o gli account di servizio esistenti che a cui vuoi aggiungere le autorizzazioni di Assured Open Source Software.

  6. Seleziona il progetto Google Cloud in cui vuoi individuare le risorse OSS certificate.

  7. Fai clic su Configura Assured OSS.

    La procedura di configurazione completa automaticamente quanto segue:

    • Se questa opzione è selezionata, crea il nuovo account di servizio assuredoss@PROJECT_ID.gservicesaccount.com.
    • Assegna il ruolo Utente Assured OSS all'account di servizio designato a con Assured OSS.
    • Assegna il ruolo Amministratore Assured OSS all'account utente che ha effettuato l'accesso in modo che che l'account possa configurare il servizio.
    • Abilita l'API Assured Open Source Software e, se non è già abilitata, l'API Artifact Registry.
    • Configura il servizio proxy Assured OSS in un Artifact Registry nel progetto selezionato. Viene eseguito il provisioning di un repository per ogni linguaggio (Java, Python e JavaScript). Questi repository possono eseguire automaticamente il pull di pacchetti il portfolio selezionato. Se un pacchetto non è disponibile nel portfolio selezionato, i repository reindirizzano la richiesta ai repository canonici. Il servizio di proxy supporta solo la regione degli Stati Uniti.
    • Concede a te e all'account di servizio le autorizzazioni per accedere ai metadati dei pacchetti e alle notifiche dei progetti di proprietà di Google.

  8. Crea un account di servizio chiave per ciascun account di servizio Assured OSS designato scarica la chiave in formato JSON.

  9. Nella riga di comando della tua macchina locale, esegui il seguente comando sul file della chiave scaricato per ottenere la stringa codificata in base64:

    base64 KEY_FILENAME.json

    Sostituisci KEY_FILENAME.json con il nome della chiave del service account che hai scaricato.

    Quando configuri un repository remoto per la configurazione di un repository remoto, è necessaria la stringa con codifica base64 Assured OSS,

  10. Per scaricare i pacchetti, usa gli endpoint Esegui il provisioning di Assured OSS per ogni lingua. Prendi nota di questi endpoint per utilizzarli in un secondo momento.

    • Java: 
      https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
    • Python: 
      https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
    • JavaScript: 
      https://us-npm.pkg.dev/PROJECT_ID/assuredoss-javascript

    Sostituisci PROJECT_ID con l'ID del progetto che che hai selezionato quando hai configurato Assured OSS.

  11. Fai clic su Avanti. Configura Assured OSS con il gestore di repository di artefatti della tua organizzazione, come JFrog. Artifactory o Sonatype Nexus.

gcloud

  1. Autentica in Google Cloud con un account utente a cui vuoi per abilitare Assured OSS:

    gcloud auth revoke
gcloud auth application-default revoke
gcloud auth login

  2. Cerca il progetto in cui vuoi individuare Risorse Assured OSS:

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

    Sostituisci PROJECT_NAME con il nome del progetto.

  3. Imposta il progetto in cui vuoi individuare le risorse di Assured OSS:

    gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con l'identificatore del progetto.

  4. Concedi ruoli all'account utente per configurare 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

    Dove email@domain.com è l'indirizzo email di il tuo account utente.

  5. Abilita Assured OSS nel progetto. L'abilitazione di Assured OSS attiva anche l'API Artifact Registry.

    gcloud services enable assuredoss.googleapis.com

  6. Per creare un nuovo account di servizio per Assured OSS invece di usando account di servizio esistenti, completa le seguenti operazioni:

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

    Sostituisci SERVICE_ACCOUNT_NAME con il nome dell'account di servizio (ad esempio assuredoss).

  7. Configura gli account di servizio per Assured OSS:

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

    Sostituisci quanto segue:

    • SERVICE_ACCOUNT_NAME: il nome del (ad esempio assuredoss).
    • PROJECT_ID: l'identificatore del progetto.

  8. Configura il servizio proxy Assured OSS in un Artifact Registry creando repository Assured OSS. Devi e creare repository per tutte le lingue. Il servizio proxy OSS di Assured che esegue il provisioning dei repository supporta solo la regione degli Stati Uniti.

    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/us/repositories\?repositoryId\=assuredoss-java   -d '{"format": "MAVEN", "mode": "AOSS_REPOSITORY"}'

gcurlj POST https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/us/repositories\?repositoryId\=assuredoss-javascript   -d '{"format": "NPM", "mode": "AOSS_REPOSITORY"}'

gcurlj POST https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/us/repositories\?repositoryId\=assuredoss-python   -d '{"format": "PYTHON", "mode": "AOSS_REPOSITORY"}'

    Sostituisci PROJECT_ID con l'ID del progetto che che hai selezionato quando hai configurato Assured OSS.

    Questi repository possono eseguire automaticamente il pull di pacchetti portfolio. Se un pacchetto non è disponibile nel portafoglio selezionato, i repository reindirizzano la richiesta ai repository canonici.

  9. Crea una chiave dell'account di servizio per ogni account di servizio Assured OSS e scarica la chiave in formato JSON.

  10. Nella riga di comando, esegui il seguente comando sul file della chiave scaricato per ottenere la stringa codificata in base64:

    base64 KEY_FILENAME.json

    Sostituisci KEY_FILENAME.json con il nome del chiave dell'account di servizio scaricata.

    La stringa con codifica Base64 è necessaria quando configuri un repository remoto per OSS Assured.

  11. Per scaricare i pacchetti, utilizza gli endpoint di cui è stato eseguito il provisioning da Assured OSS per ogni lingua. Prendi nota di questi endpoint:

    • Java: 
      https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
    • Python: 
      https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
    • JavaScript: 
      https://us-npm.pkg.dev/PROJECT_ID/assuredoss-javascript

    Sostituisci PROJECT_ID con l'ID del progetto selezionato quando hai configurato Assured OSS.

  12. Configura Assured OSS per scaricare i pacchetti con il gestore di repository di artefatti della tua organizzazione come JFrog Artifactory o Sonatype Nexus.

  13. (Facoltativo) Visualizza i pacchetti Java, Python e JavaScript disponibili:

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

    Sostituisci KEY_FILENAME.json con il nome della chiave del service account che hai scaricato.

    export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILENAME.json

    Sostituisci KEY_FILENAME.json con il nome del chiave dell'account di servizio scaricata.

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

    Sostituisci PROJECT_ID con l'ID del progetto selezionato quando hai configurato Assured OSS.

Passaggi successivi