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

Il livello premium Assured Open Source Software (Assured OSS) ti consente di migliorare la sicurezza del tuo codice utilizzando i pacchetti OSS che Google utilizza per i propri flussi di lavoro per sviluppatori. Quando utilizzi Assured OSS, i tuoi sviluppatori possono sfruttare l'esperienza e le competenze di Google in materia di sicurezza per proteggere le 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, tra cui 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 da Assured OSS, rendendo Google un fornitore noto e affidabile.
  • Utilizza gli SBOM e i VEX in Assured OSS forniti nei formati standard del settore come SPDX e CycloneDX per scoprire di più sui tuoi ingredienti.
  • Aumenta la sicurezza dell'integrità dei pacchetti che utilizzi tramite una provenienza firmata a prova di manomissione da parte di Google.
  • Ridurre il rischio per la sicurezza poiché Google esegue attivamente la scansione, la ricerca e la correzione di nuove vulnerabilità nei pacchetti selezionati.

Prima di iniziare

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

Attiva il livello Security Command Center Enterprise

Verifica che il livello Security Command Center Enterprise sia attivato a livello di 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 column 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 ruolo aggiuntivo.
    7. Fai clic su Salva.

    Configura 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 column 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 ruolo aggiuntivo.
      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 guida alla configurazione di Security Command Center.

        Vai alla Guida alla configurazione

      2. Verifica di visualizzare l'organizzazione su cui hai attivato il livello Security Command Center Enterprise.

      3. Espandi il riquadro Esamina il riepilogo delle funzionalità di sicurezza.

      4. Fai clic su Sicurezza del codice > Configurazione.

      5. Nel riquadro Configura la sicurezza del codice, fai clic su Configurazione AOSS.

      6. Seleziona un nuovo account di servizio o quelli esistenti a cui vuoi aggiungere le autorizzazioni di Assured Open Source Software.

      7. Seleziona il progetto Google Cloud in cui vuoi individuare le risorse Assured OSS.

      8. Fai clic su Configura Assured OSS.

        La procedura di configurazione completa automaticamente le seguenti operazioni:

        • Se selezionata, crea il nuovo account di servizio assuredoss@PROJECT_ID.gservicesaccount.com.
        • Assegna il ruolo Utente Assured OSS all'account di servizio designato da utilizzare con Assured OSS.
        • Assegna il ruolo Amministratore Assured OSS all'account utente con cui è stato eseguito l'accesso in modo 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 di proxy Assured OSS in un'istanza Artifact Registry nel progetto che hai selezionato. Viene eseguito il provisioning di un repository per ogni linguaggio (Java, Python e JavaScript). Questi repository possono estrarre automaticamente i pacchetti dal portfolio selezionato. Se un pacchetto non è disponibile nel portfolio selezionato, i repository reindirizzano la richiesta ai repository canonici. Il servizio proxy supporta solo la regione Stati Uniti.
        • Concede a te e al account di servizio le autorizzazioni per accedere a metadati dei pacchetti e notifiche dai progetti di proprietà di Google.

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

      10. Nella riga di comando della tua macchina locale, esegui il seguente comando sul file della chiave scaricato per ottenere la stringa con codifica Base64:

        base64 KEY_FILENAME.json

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

        La stringa con codifica Base64 ti serve quando configuri un repository remoto per Assured OSS.

      11. Per scaricare i pacchetti, utilizza gli endpoint di cui Assured OSS esegue il provisioning 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 hai selezionato durante la configurazione di Assured OSS.

      12. Fai clic su Avanti. Configura Assured OSS con il gestore del repository di artefatti della tua organizzazione, ad esempio JFrog Artifactory o Sonatype Nexus.

      gcloud

      1. Autenticati su Google Cloud con un account utente che vuoi utilizzare per attivare Assured OSS:

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

      2. Cerca il progetto in cui vuoi individuare le 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 Assured OSS:

        gcloud config set project PROJECT_ID

        Sostituisci PROJECT_ID con l'identificatore del progetto.

      4. Concedi i 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 del tuo account utente.

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

        gcloud services enable assuredoss.googleapis.com

      6. Per creare un nuovo account di servizio per Assured OSS anziché utilizzare service account esistenti, completa i seguenti passaggi:

        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 i service account 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 account di servizio (ad esempio, assuredoss).
        • PROJECT_ID: l'identificatore del progetto.

      8. Configura il servizio di proxy Assured OSS in un'istanza Artifact Registry creando repository Assured OSS. Devi creare repository per tutte le lingue. Il servizio proxy Assured OSS 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 hai selezionato durante la configurazione di Assured OSS.

        Questi repository possono estrarre automaticamente i pacchetti dal portfolio selezionato. Se un pacchetto non è disponibile come parte del portfolio 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 questo comando sul file della chiave scaricato per ottenere la stringa con codifica Base64:

        base64 KEY_FILENAME.json

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

        La stringa con codifica Base64 ti serve quando configuri un repository remoto per Assured OSS.

      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 che hai selezionato durante la configurazione di 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 account di servizio che hai scaricato.

        export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILENAME.json

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

        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 che hai selezionato durante la configurazione di Assured OSS.

      Passaggi successivi