In der Premium-Stufe werden Assured OSS-Pakete in einem Artifact Registry-Repository gehostet, das in einem von Ihnen verwalteten Projekt erstellt wird. Wenn Sie direkt auf Java-Pakete zugreifen und diese herunterladen möchten, können Sie eine Verbindung zum Artifact Registry-Repository für Assured OSS herstellen.
Dieses Dokument gilt nur für die Assured OSS-Premium-Stufe. Informationen zur kostenlosen Stufe finden Sie unter Java-Pakete über den direkten Repository-Zugriff für die kostenlose Stufe herunterladen.
Hinweis
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Zentraler Dienstkontoadministrator (
roles/iam.serviceAccountKeyAdmin) für Ihre Organisation zuzuweisen. Sie benötigen diese Berechtigung, um den base64-codierten String des Dienstkontoschlüssels abzurufen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.Prüfen Sie die Verbindung zu Assured OSS für die angeforderten Dienstkonten.
Installieren Sie die aktuelle Version der Google Cloud CLI. Wenn Sie die Google Cloud CLI bereits installiert haben, prüfen Sie, ob Sie die aktuelle Version haben. Führen Sie dazu diesen Befehl aus:
gcloud components update
Authentifizierung einrichten
Artifact Registry unterstützt die folgenden Authentifizierungsmethoden:
- Authentifizierung mit einem Hilfsprogramm für Anmeldedaten
- Authentifizierung mit einem Passwort
In den folgenden Abschnitten wird beschrieben, wie Sie diese Authentifizierungsmethoden einrichten.
Mit einem Hilfsprogramm für Anmeldedaten authentifizieren
Artifact Registry bietet einen Maven-Wagon und ein Gradle-Plug-in, die als Anmeldedaten-Hilfsprogramme verwendet werden können. Diese Option bietet die größte Flexibilität.
Informationen zum Einrichten von Standardanmeldedaten für Anwendungen finden Sie unter Authentifizierung einrichten.
Anmeldedaten-Hilfsprogramme einrichten
Wenn Sie die Authentifizierung mit einem Hilfsprogramm für Anmeldedaten einrichten, nehmen Sie die folgenden Änderungen vor, je nachdem, welches Build-Tool Sie verwenden.
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"
}
Mit Passwort authentifizieren
Mit Passwort authentifizieren, wenn Ihre Java-Anwendung eine Authentifizierung mit einem bestimmten Nutzernamen und Passwort erfordert. Ändern Sie die Einstellungen je nach Build-Tool:
Maven
Fügen Sie im Abschnitt settings der Datei ~/.m2/settings.xml die folgenden Authentifizierungseinstellungen hinzu. Wenn die Datei noch nicht vorhanden ist, erstellen Sie sie. Weitere Informationen finden Sie in der Referenz zu den Maven-Einstellungen.
<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>
Ersetzen Sie KEY durch die Base64-Codierung der gesamten JSON-Schlüsseldatei des Dienstkontos. Führen Sie hierzu den folgenden Befehl aus:
cat KEY_FILE_LOCATION | base64
Ersetzen Sie KEY_FILE_LOCATION durch den Speicherort der JSON-Schlüsseldatei des Dienstkontos.
Gradle
Fügen Sie der Datei ~/.gradle/gradle.properties die folgende Zeile hinzu, damit der Schlüssel in Ihren Builds oder Ihrem Quellcode-Repository nicht sichtbar ist.
artifactRegistryMavenSecret = KEY
Ersetzen Sie KEY durch den privaten Schlüssel aus der JSON-Schlüsseldatei Ihres Dienstkontos. Bei json_key_base64 enthält artifactRegistryMavenSecret das base64-verschlüsselte Passwort. Beispiel: base64 -w 0 KEY
Geben Sie in der Datei build.gradle die Repository-Einstellungen wie im folgenden Beispiel an:
repositories {
maven {
url "artifactregistry://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java"
credentials {
username = "_json_key_base64"
password = "$artifactRegistryMavenSecret"
}
authentication {
basic(BasicAuthentication)
}
}
}
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, das Sie beim Einrichten von Assured OSS ausgewählt haben.LOCATION: eine unterstützte Region.
Projektkonfigurationsdatei aktualisieren, sodass sie auf das Repository verweist
Maven
Fügen Sie die folgenden Einstellungen dem entsprechenden Abschnitt in der Datei pom.xml für Ihr Maven-Projekt hinzu. Ersetzen Sie die Authentifizierungseinstellungen nicht.
<project>
<repositories>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
</project>
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, das Sie beim Einrichten von Assured OSS ausgewählt haben.LOCATION: eine unterstützte Region.
Weitere Informationen zur Struktur der Datei finden Sie in der POM-Referenz von Maven.
Gradle
Geben Sie in der Datei build.gradle die folgenden Repository-Einstellungen an. Ersetzen Sie die Authentifizierungseinstellungen nicht.
repositories {
maven {
url "artifactregistry://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java"
}
}
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, das Sie beim Einrichten von Assured OSS ausgewählt haben.LOCATION: eine unterstützte Region.
Projektkonfigurationsdatei aktualisieren, um Abhängigkeiten hinzuzufügen
Wenn Sie ein Artefakt als Teil Ihres Builds herunterladen möchten, muss es als Abhängigkeit deklariert werden.
Maven
Deklarieren Sie die Pakete, die Sie herunterladen möchten, in der Datei pom.xml für Ihr Maven-Projekt.
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.17.1</version>
</dependency>
Gradle
Deklarieren Sie die Pakete, die Sie herunterladen möchten, in der Datei build.gradle.
dependencies {
compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.17.1'
}
Alle in Assured OSS verfügbaren Java-Pakete auflisten
Wenn Sie eine API verwenden möchten, um eine Liste aller im Artifact Registry-Repository verfügbaren Java-Pakete abzurufen, lesen Sie den Abschnitt Alle in Security Command Center verfügbaren Java-Pakete auflisten.