Dopo aver integrato Assured OSS con Security Command Center, i pacchetti software open source di Assured vengono ospitati in un repository Artifact Registry creato in un progetto controllato da te.
Questa pagina spiega come connetterti al repository Artifact Registry per Assured OSS per accedere e scaricare direttamente i pacchetti Java.
Questo documento si applica solo al livello a pagamento di Assured OSS. Per il livello gratuito, consulta Scaricare pacchetti Java utilizzando l'accesso diretto al repository per il livello gratuito.
Prima di iniziare
Convalida la connettività ad Assured OSS per gli account di servizio richiesti.
Installa la versione più recente di Google Cloud CLI.
Se hai già installato Google Cloud CLI, assicurati di avere la versione più recente eseguendo il comando:
gcloud components update
Configura l'autenticazione
Artifact Registry supporta i seguenti metodi di autenticazione:
- Autenticazione con un assistente per le credenziali
- Autenticazione con password
Le sezioni seguenti descrivono come configurare questi metodi di autenticazione.
Autenticazione con un helper delle credenziali
Artifact Registry fornisce un wagon Maven e un plug-in Gradle da utilizzare come helper per le credenziali. Questa opzione offre la massima flessibilità.
Per configurare le Credenziali predefinite dell'applicazione, consulta Configurare l'autenticazione.
Configura gli assistenti per le credenziali
Se utilizzi un assistente per le credenziali per configurare l'autenticazione, apporta le seguenti modifiche in base allo strumento di creazione.
Maven
<project>
<build>
<extensions>
<extension>
<groupId>com.google.cloud.artifactregistry</groupId>
<artifactId>artifactregistry-maven-wagon</artifactId>
<version>2.2.0</version>
</extension>
</extensions>
</build>
</project>
Gradle
plugins {
id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.0"
}
Autentica tramite password
Esegui l'autenticazione con password quando la tua applicazione Java richiede l'autenticazione con un nome utente e una password specificati. A seconda dello strumento di creazione in uso, modifica le impostazioni in base alle seguenti istruzioni:
Maven
Aggiungi le seguenti impostazioni di autenticazione nella sezione settings
del
file ~/.m2/settings.xml
. Per ulteriori informazioni, consulta il riferimento Impostazioni di Maven. Se il file ~/.m2/settings.xml
non esiste, crea un nuovo
file.
<settings>
<servers>
<server>
<id>artifact-registry</id>
<configuration>
<httpConfiguration>
<get>
<usePreemptive>true</usePreemptive>
</get>
<head>
<usePreemptive>true</usePreemptive>
</head>
<put>
<params>
<property>
<name>http.protocol.expect-continue</name>
<value>false</value>
</property>
</params>
</put>
</httpConfiguration>
</configuration>
<username>_json_key_base64</username>
<password>KEY</password>
</server>
</servers>
</settings>
Sostituisci KEY
con la codifica base64 dell'intero file di chiavi JSON dell'account di servizio. Per farlo, esegui questo comando:
cat KEY_FILE_LOCATION | base64
Sostituisci KEY_FILE_LOCATION con il percorso del file delle chiavi JSON dell'account di servizio.
Gradle
Aggiungi la riga seguente al file ~/.gradle/gradle.properties
in modo che la chiave non sia visibile nelle build o nel repository di controllo del codice sorgente.
artifactRegistryMavenSecret = KEY
Sostituisci KEY
con la chiave privata del file di chiave JSON del tuo account di servizio. Per json_key_base64
, artifactRegistryMavenSecret
contiene la
password criptata con Base64. Ad esempio: base64 -w 0 KEY
.
Nel file build.gradle
, specifica le impostazioni del repository utilizzando il seguente esempio:
repositories {
maven {
url "artifactregistry://us-maven.pkg.dev/PROJECT_ID/assuredoss-java"
credentials {
username = "_json_key_base64"
password = "$artifactRegistryMavenSecret"
}
authentication {
basic(BasicAuthentication)
}
}
}
Sostituisci PROJECT_ID
con l'ID del progetto selezionato durante la configurazione del software open source Assured.
Aggiorna il file di configurazione del progetto in modo che punti al repository
Maven
Aggiungi le seguenti impostazioni alla sezione appropriata nel file pom.xml
per
il tuo progetto Maven. Non sostituire le impostazioni di autenticazione.
<project>
<repositories>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-maven.pkg.dev/PROJECT_ID/assuredoss-java</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
</project>
Sostituisci PROJECT_ID
con l'ID del progetto selezionato durante la configurazione del software open source Assured.
Consulta il riferimento POM di Maven per i dettagli sulla struttura del file.
Gradle
Specifica le seguenti impostazioni del repository nel file build.gradle
. Non sostituire le impostazioni di autenticazione.
repositories {
maven {
url "artifactregistry://us-maven.pkg.dev/PROJECT_ID/assuredoss-java"
}
}
Sostituisci PROJECT_ID
con l'ID del progetto selezionato durante la configurazione del software open source Assured.
Aggiorna il file di configurazione del progetto per aggiungere dipendenze
Per scaricare un artefatto come parte della build, devi dichiararlo come dipendenza.
Maven
Dichiara i pacchetti che vuoi scaricare nel file pom.xml
del tuo progetto Maven.
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.17.1</version>
</dependency>
Gradle
Dichiara i pacchetti che vuoi scaricare nel file build.gradle
.
dependencies {
compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.17.1'
}
Elenco di tutti i pacchetti Java disponibili in Assured OSS
Per utilizzare un'API per ottenere un elenco di tutti i pacchetti Java disponibili nel repository Artifact Registry, consulta Elenco di tutti i pacchetti Java disponibili in Security Command Center.
Passaggi successivi
- Scarica i pacchetti Python utilizzando l'accesso diretto al repository nel livello a pagamento
- Accedere ai metadati di sicurezza e verificare i pacchetti nel livello a pagamento