Scaricare i pacchetti Assured OSS utilizzando un repository remoto

La configurazione di un repository remoto in JFrog Artifactory o Sonatype Nexus consente di eseguire il proxy e memorizzare nella cache in modo sicuro i pacchetti Assured OSS all'interno dei tuoi flussi di lavoro di sviluppo. Per gli strumenti disponibili, consulta Opzioni del repository Assured OSS.

Queste istruzioni si applicano solo al livello Assured OSS Premium; per gli altri livelli, consulta Scaricare i pacchetti Assured OSS utilizzando un repository remoto.

Prima di iniziare

  1. Integra Assured OSS con Security Command Center.

  2. Convalida la connettività a Security Command Center per i service account richiesti.

Configura un repository remoto utilizzando JFrog Artifactory

  1. Accedi a JFrog Artifactory Repository Manager. Assicurati di disporre dei privilegi necessari per creare un nuovo repository remoto.
  2. Seleziona l'opzione per creare un nuovo repository remoto nel gestore dei repository.
  3. Seleziona il tipo di repository appropriato (ad esempio, seleziona Maven per Java, PyPi per Python, npm per JavaScript o Go per Go).

  4. (Facoltativo) Testa la connessione al repository seguendo questi passaggi:

    1. Nel campo Chiave repository, inserisci un nome o un identificatore univoco per il repository remoto.

    2. Nel campo URL, inserisci uno dei seguenti valori:

      • Java: 
        https://us-maven.pkg.dev
      • Python: 
        https://us-python.pkg.dev
      • JavaScript (NPM): 
        https://us-npm.pkg.dev
      • Go: 
        https://us-go.pkg.dev

      Non inserire il nome di dominio completo perché questa azione potrebbe restituire un codice di stato HTTP 404 o HTTP 405.

    3. Lascia vuoti i campi rimanenti.

    4. Fai clic su Test. La connessione viene stabilita quando viene visualizzato il seguente output:

      Successfully connected to server

  5. Per creare un nuovo repository remoto, inserisci le seguenti informazioni:

    1. Nel campo Chiave repository, inserisci un nome o un identificatore univoco per il repository remoto. Ad esempio, assured-oss-java-repo.

    2. Nel campo URL, inserisci uno dei seguenti valori:

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

      Sostituisci PROJECT_ID con l'ID del progetto che hai selezionato durante la configurazione di Assured OSS.

    3. Nel campo Nome utente, inserisci _json_key_base64.

    4. Nel campo Password, fornisci la stringa con codifica base64 del file della chiave JSON dell'account di servizio. Utilizza l'intera stringa con codifica Base64 in una sola riga come password. Per ottenere la stringa con codifica base64, esegui il comando cat key-filename.json | base64 -w 0.

    5. Solo per Python, nel campo URL del registro, inserisci quanto segue: 

      https://us-python.pkg.dev/PROJECT_ID/assuredoss-python

  6. Per Go solo, nella scheda Impostazioni avanzate, seleziona Ignora richieste HEAD.

  7. Fai clic su Crea repository remoto.

    Per i pacchetti Python, aggiungi all'URL ottenuto /simple. Utilizza l'URL come index-url nel comando pip install per scaricare i pacchetti Python richiesti. Ad esempio, se l'URL ottenuto del repository è https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo, allora il index-url corrispondente è https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple.

Dopo aver configurato il nuovo repository remoto, configura gli strumenti di build (ad esempio Apache Maven, Gradle Build Tool o pip) in modo che utilizzino questo nuovo repository remoto.

Problemi noti

Il test della connessione utilizzando il pulsante Test può restituire un errore anche se la connessione è configurata correttamente. Ti consigliamo di creare il repository remoto indipendentemente dal comportamento del pulsante di test. Per un altro modo di confermare una connessione, consulta Convalida la connessione.

Configura un repository remoto utilizzando Sonatype Nexus

  1. Accedi a Sonatype Nexus Repository Manager. Assicurati di disporre dei privilegi richiesti per creare un nuovo repository remoto.
  2. Seleziona l'opzione per creare un nuovo repository.
  3. Seleziona il tipo di repository appropriato (ad esempio, seleziona Maven per Java, PyPi per Python, npm per JavaScript o Go per Go).

  4. Inserisci i seguenti dettagli per il nuovo repository:

    1. Nel campo Nome, inserisci un nome o un identificatore univoco per il repository remoto.

    2. Nel campo Spazio di archiviazione remoto, scegli una delle seguenti opzioni:

      • Java: 

        https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java

      • Python: 

        https://us-python.pkg.dev/PROJECT_ID/assuredoss-python

      • JavaScript (NPM): 

        https://us-npm.pkg.dev/PROJECT_ID/assuredoss-javascript

      • Go: 

        https://us-go.pkg.dev/PROJECT_ID/assuredoss-go

      Sostituisci PROJECT_ID con l'ID del progetto che hai selezionato durante la configurazione di Assured OSS.

  5. In HTTP, seleziona Autenticazione.

  6. Specifica quanto segue:

    1. Nel campo Tipo di autenticazione, inserisci Username.
    2. Nel campo Nome utente, inserisci _json_key_base64.
    3. Nel campo Password, fornisci la stringa con codifica base64 del file della chiave JSON dell'account di servizio. Utilizza l'intera stringa con codifica Base64 in una sola riga come password. Per ottenere la stringa con codifica base64, esegui il comando cat key-filename.json | base64.

  7. Fai clic su Crea repository.

Dopo aver configurato il nuovo repository remoto, indica agli strumenti di build (ad esempio, Apache Maven, Gradle Build Tool o pip) di utilizzare questo nuovo repository remoto.

Passaggi successivi