Assured OSS-Pakete über ein Remote-Repository herunterladen

Wenn Sie auf Assured Open Source Software-Pakete (Assured OSS) zugreifen und diese herunterladen möchten, können Sie ein Remote-Repository von JFrog Artifactory oder Sonatype Nexus einrichten. Mit dieser Konfiguration können Sie Assured OSS-Pakete über Ihren vorhandenen Artefaktmanager per Proxy herunterladen. Weitere Informationen zu Repository-Optionen finden Sie unter Assured OSS-Repository-Optionen.

Dieses Dokument gilt nur für die Assured OSS-Premiumstufe. Informationen zur kostenlosen Stufe finden Sie unter Assured OSS-Pakete über ein Remote-Repository herunterladen.

Hinweis

  1. Assured OSS in Security Command Center einbinden.

  2. Prüfen Sie die Verbindung zu Security Command Center für die angeforderten Dienstkonten.

Remote-Repository mit JFrog Artifactory einrichten

  1. Melden Sie sich im JFrog Artifactory-Repository-Manager an. Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Erstellen eines neuen Remote-Repositorys haben.
  2. Wählen Sie die Option zum Erstellen eines neuen Remote-Repositorys in Ihrem Repository-Manager aus.
  3. Wählen Sie den entsprechenden Repository-Typ aus (z. B. Maven für Java, PyPi für Python, npm für JavaScript oder Go für Go).

  4. Optional können Sie die Verbindung zum Repository mit den folgenden Schritten testen:

    1. Geben Sie im Feld Repository-Schlüssel einen eindeutigen Namen oder eine eindeutige Kennung für das Remote-Repository ein.

    2. Geben Sie im Feld URL eine der folgenden Optionen ein:

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

      Ersetzen Sie LOCATION durch eine unterstützte Region.

      Geben Sie nicht den vollständigen Domainnamen ein, da diese Aktion möglicherweise den HTTP-Statuscode 404 oder 405 zurückgibt.

    3. Lassen Sie die restlichen Felder leer.

    4. Klicken Sie auf Testen. Die Verbindung ist erfolgreich, wenn die folgende Ausgabe angezeigt wird:

      Successfully connected to server

  5. Geben Sie die folgenden Informationen ein, um ein neues Remote-Repository zu erstellen:

    1. Geben Sie im Feld Repository-Schlüssel einen eindeutigen Namen oder eine eindeutige Kennung für das Remote-Repository ein. Beispiel: assured-oss-java-repo.

    2. Geben Sie im Feld URL eine der folgenden Optionen ein:

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

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die ID des Projekts, das Sie beim Einrichten von Assured OSS ausgewählt haben.

      • LOCATION: eine unterstützte Region.

    3. Geben Sie im Feld Nutzername _json_key_base64 ein.

    4. Geben Sie im Feld Passwort den base64-codierten String der JSON-Schlüsseldatei des Dienstkontos an. Verwenden Sie den gesamten base64-codierten String in einer einzigen Zeile als Passwort. Führen Sie den Befehl cat key-filename.json | base64 -w 0 aus, um den base64-codierten String abzurufen.

    5. Geben Sie nur für Python im Feld Registry-URL Folgendes ein: 

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

  6. Wählen Sie nur für Go auf dem Tab Erweiterte Einstellungen die Option HEAD-Anfragen umgehen aus.

  7. Klicken Sie auf Remote-Repository erstellen.

    Hängen Sie bei Python-Paketen /simple an die abgerufene URL an. Verwenden Sie die URL als index-url im Befehl pip install, um die erforderlichen Python-Pakete herunterzuladen. Wenn die abgerufene URL des Repositorys beispielsweise https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo lautet, ist der entsprechende index-url-Wert https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple.

Nachdem das neue Remote-Repository eingerichtet wurde, konfigurieren Sie Ihre Build-Tools (z. B. Apache Maven, Gradle Build Tool oder pip) so, dass sie dieses neue Remote-Repository verwenden.

Bekannte Probleme

Wenn Sie die Verbindung mit dem Button Testen testen, kann ein Fehler zurückgegeben werden, auch wenn die Verbindung richtig konfiguriert ist. Wir empfehlen, das Remote-Repository unabhängig vom Verhalten des Test-Buttons zu erstellen. Eine weitere Möglichkeit, eine Verbindung zu bestätigen, finden Sie unter Verbindung validieren.

Remote-Repository mit Sonatype Nexus einrichten

  1. Melden Sie sich in Ihrem Sonatype Nexus-Repository-Manager an. Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Erstellen eines neuen Remote-Repositorys haben.
  2. Wählen Sie die Option zum Erstellen eines neuen Repositorys aus.
  3. Wählen Sie den entsprechenden Repository-Typ aus (z. B. Maven für Java, PyPi für Python, npm für JavaScript oder Go für Go).

  4. Geben Sie die folgenden Details für das neue Repository ein:

    1. Geben Sie im Feld Name einen eindeutigen Namen oder eine eindeutige Kennung für das Remote-Repository ein.

    2. Wählen Sie im Feld Remote-Speicher eine der folgenden Optionen aus:

      • Java: 

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

      • Python: 

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

      • JavaScript (NPM): 

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

      • Go: 

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

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die ID des Projekts, das Sie beim Einrichten von Assured OSS ausgewählt haben.

      • LOCATION: eine unterstützte Region.

  5. Wählen Sie unter HTTP die Option Authentifizierung aus.

  6. Geben Sie Folgendes an:

    1. Geben Sie im Feld Authentifizierungstyp den Wert Username ein.
    2. Geben Sie im Feld Nutzername _json_key_base64 ein.
    3. Geben Sie im Feld Passwort den base64-codierten String der JSON-Schlüsseldatei des Dienstkontos an. Verwenden Sie den gesamten base64-codierten String in einer einzigen Zeile als Passwort. Führen Sie den Befehl cat key-filename.json | base64 aus, um den base64-codierten String abzurufen.

  7. Klicken Sie auf Repository erstellen.

Nachdem das neue Remote-Repository eingerichtet wurde, verweisen Sie mit Ihren Build-Tools (z. B. Apache Maven, Gradle Build Tool oder pip) auf dieses neue Remote-Repository.

Nächste Schritte