הורדת חבילות Java באמצעות גישה ישירה למאגר

במסלול פרימיום, חבילות Assured OSS מתארחות במאגר Artifact Registry שנוצר בפרויקט שבשליטתכם. כדי לגשת ישירות לחבילות Java ולהוריד אותן, אתם יכולים להתחבר למאגר Artifact Registry של Assured OSS.

המסמך הזה רלוונטי רק למסלול הפרימיום של Assured OSS. למידע על הורדת חבילות Java באמצעות גישה ישירה למאגר בתוכנית בחינם, קראו את המאמר הורדת חבילות Java באמצעות גישה ישירה למאגר בתוכנית בחינם.

לפני שמתחילים

  1. מבקשים מהאדמין להקצות לכם את התפקיד אדמין של מפתח חשבון שירות (roles/iam.serviceAccountKeyAdmin) ב-IAM בארגון. אתם צריכים את ההרשאה הזו כדי לקבל את המחרוזת בקידוד base64 של מפתח חשבון השירות. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

  2. שילוב של Assured OSS עם Security Command Center.

  3. מאמתים את הקישוריות ל-Assured OSS של חשבונות השירות המבוקשים.

  4. מתקינים את הגרסה העדכנית של Google Cloud CLI. אם כבר התקנתם את Google Cloud CLI, ודאו שפועלת אצלכם הגרסה העדכנית ביותר באמצעות הפקודה הבאה:

    gcloud components update

מגדירים אימות

ב-Artifact Registry יש תמיכה בשיטות האימות הבאות:

  • אימות באמצעות כלי עזר לפרטי כניסה
  • אימות באמצעות סיסמה

בקטעים הבאים מוסבר איך להגדיר את שיטות האימות האלה.

אימות באמצעות כלי עזר לפרטי כניסה

ב-Artifact Registry יש Maven wagon ותוסף Gradle שאפשר להשתמש בהם כעוזרי פרטי כניסה. זו האפשרות הכי גמישה.

כדי להגדיר את Application Default Credentials, קראו את המאמר הגדרת אימות.

הגדרת כלי העזר לפרטי הכניסה

אם אתם משתמשים בכלי עזר לפרטי כניסה כדי להגדיר אימות, בצעו את השינויים הבאים בהתאם לכלי ה-build.

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"
}

אימות באמצעות סיסמה

אימות באמצעות סיסמה, אם אפליקציית Java דורשת אימות באמצעות שם משתמש וסיסמה ספציפיים. משנים את ההגדרות בהתאם לכלי הפיתוח:

Maven

מוסיפים את הגדרות האימות הבאות בקטע settings של הקובץ ~/.m2/settings.xml. אם הקובץ לא קיים, יוצרים אותו. מידע נוסף זמין במאמר הגדרות Maven.

<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>

מחליפים את KEY בקידוד base64 של כל קובץ המפתח בפורמט JSON של חשבון השירות. כדי לעשות את זה, מריצים את הפקודה הבאה:

cat KEY_FILE_LOCATION  | base64

מחליפים את KEY_FILE_LOCATION במיקום של קובץ המפתח בפורמט JSON של חשבון השירות.

Gradle

מוסיפים את השורה הבאה לקובץ ~/.gradle/gradle.properties כדי שהמפתח לא יהיה גלוי בגרסאות ה-build או במאגר של בקרת המקור.

artifactRegistryMavenSecret = KEY

מחליפים את KEY במפתח הפרטי מקובץ המפתח בפורמט JSON של חשבון השירות. בשביל json_key_base64, השדה artifactRegistryMavenSecret מכיל את הסיסמה המוצפנת ב-base64. לדוגמה, base64 -w 0 KEY.

בקובץ build.gradle, מציינים את הגדרות המאגר לפי הדוגמה הבאה:

repositories {
  maven {
    url "artifactregistry://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java"
    credentials {
      username = "_json_key_base64"
      password = "$artifactRegistryMavenSecret"
    }
    authentication {
      basic(BasicAuthentication)
    }
  }
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט שבחרתם כשהגדרתם את Assured OSS.

  • ‫LOCATION: אזור נתמך.

עדכון קובץ התצורה של הפרויקט כך שיצביע על המאגר

Maven

מוסיפים את ההגדרות הבאות לקטע המתאים בקובץ pom.xml של פרויקט Maven. אל תחליפו את הגדרות האימות.

<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>

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט שבחרתם כשהגדרתם את Assured OSS.

  • ‫LOCATION: אזור נתמך.

בחומר העזר בנושא POM של Maven מפורט המבנה של הקובץ.

Gradle

מציינים את הגדרות המאגר הבאות בקובץ build.gradle. אל תחליפו את הגדרות האימות.

repositories {
  maven {
  url "artifactregistry://LOCATION-maven.pkg.dev/PROJECT_ID/assuredoss-java"
  }
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט שבחרתם כשהגדרתם את Assured OSS.

  • ‫LOCATION: אזור נתמך.

עדכון קובץ התצורה של הפרויקט כדי להוסיף יחסי תלות

כדי להוריד פריט מידע שנוצר בתהליך פיתוח התוכנה כחלק מה-build, צריך להצהיר על פריט המידע כתלות.

Maven

מצהירים על החבילות שרוצים להוריד בקובץ pom.xml של פרויקט Maven.

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.17.1</version>
</dependency>

Gradle

מצהירים על החבילות שרוצים להוריד בקובץ build.gradle.

dependencies {
    compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.17.1'
}

הצגת רשימה של כל חבילות Java שזמינות ב-Assured OSS

כדי להשתמש ב-API כדי לקבל רשימה של כל חבילות ה-Java שזמינות במאגר של Artifact Registry, קראו את המאמר הצגת רשימה של כל חבילות ה-Java שזמינות ב-Security Command Center.

המאמרים הבאים