הורדת חבילות Assured OSS באמצעות מאגר מרוחק

כדי לגשת לחבילות של Assured Open Source Software (Assured OSS) ולהוריד אותן, אתם יכולים להגדיר מאגר מרוחק של JFrog Artifactory או Sonatype Nexus. ההגדרה הזו מאפשרת לכם להוריד חבילות של Assured OSS ולהעביר אותן דרך שרת proxy באמצעות מנהל הארטיפקטים הקיים. מידע נוסף על אפשרויות המאגר זמין במאמר אפשרויות המאגר של Assured OSS.

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

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

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

  2. מאמתים את הקישוריות ל-Security Command Center של חשבונות השירות המבוקשים.

הגדרת מאגר מרוחק באמצעות JFrog Artifactory

  1. נכנסים למנהל המאגרים של JFrog Artifactory. מוודאים שיש לכם את ההרשאות הנדרשות כדי ליצור מאגר מרוחק חדש.
  2. במנהל המאגרים, בוחרים באפשרות ליצור מאגר מרוחק חדש.
  3. בוחרים את סוג המאגר המתאים (לדוגמה, בוחרים באפשרות Maven ל-Java, באפשרות PyPi ל-Python, באפשרות npm ל-JavaScript או באפשרות Go ל-Go).

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

    1. בשדה Repository Key, מזינים שם או מזהה ייחודי למאגר המרוחק.

    2. בשדה כתובת URL, מזינים אחת מהאפשרויות הבאות:

      • Java: 
        https://LOCATION-maven.pkg.dev
      • ‫Python: 
        https://LOCATION-python.pkg.dev
      • ‫JavaScript‏ (NPM): 
        https://LOCATION-npm.pkg.dev
      • מעבר אל: 
        https://LOCATION-go.pkg.dev

      מחליפים את LOCATION באזור נתמך.

      אל תזינו את שם הדומיין המלא, כי הפעולה הזו עלולה להחזיר קוד סטטוס HTTP 404 או HTTP 405.

    3. משאירים את שאר השדות ריקים.

    4. לוחצים על בדיקה. החיבור הצליח אם מופיע הפלט הבא:

      Successfully connected to server

  5. כדי ליצור מאגר מרוחק חדש, מזינים את הפרטים הבאים:

    1. בשדה Repository Key, מזינים שם או מזהה ייחודי למאגר המרוחק. לדוגמה, assured-oss-java-repo.

    2. בשדה כתובת URL, מזינים אחת מהאפשרויות הבאות:

      • 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
      • מעבר אל: 
        https://LOCATION-go.pkg.dev/PROJECT_ID/assuredoss-go

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

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

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

    3. בשדה שם משתמש, מזינים את הערך _json_key_base64.

    4. בשדה Password, מזינים את המחרוזת בקידוד base64 של קובץ המפתח בפורמט JSON של חשבון השירות. משתמשים בכל המחרוזת בקידוד Base64 בשורה אחת בתור הסיסמה. כדי לקבל את המחרוזת בקידוד Base64, מריצים את הפקודה cat key-filename.json | base64 -w 0.

    5. ב-Python בלבד, בשדה Registry URL מזינים את הפרטים הבאים: 

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

  6. ב-Go בלבד, בכרטיסייה Advanced Settings, בוחרים באפשרות Bypass HEAD Requests.

  7. לוחצים על Create Remote Repository.

    בחבילות Python, מוסיפים /simple לכתובת ה-URL שהתקבלה. משתמשים בכתובת ה-URL בתור index-url בפקודה pip install כדי להוריד את חבילות Python הנדרשות. לדוגמה, אם כתובת ה-URL של המאגר היא https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo, הערך התואם של index-url הוא https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple.

אחרי שמגדירים את המאגר המרוחק החדש, מגדירים את כלי ה-build (לדוגמה, Apache Maven,‏ Gradle Build Tool או pip) כך שישתמשו במאגר המרוחק החדש.

בעיות מוכרות

בדיקת החיבור באמצעות הלחצן Test יכולה להחזיר שגיאה גם אם החיבור מוגדר בצורה נכונה. מומלץ ליצור את המאגר המרוחק בלי קשר להתנהגות של לחצן הבדיקה. במאמר אימות החיבור מוסבר איך לאמת את החיבור בדרך אחרת.

הגדרת מאגר מרוחק באמצעות Sonatype Nexus

  1. נכנסים למנהל המאגרים של Sonatype Nexus. מוודאים שיש לכם את ההרשאות הנדרשות כדי ליצור מאגר מרוחק חדש.
  2. בוחרים באפשרות ליצור מאגר חדש.
  3. בוחרים את סוג המאגר המתאים (לדוגמה, בוחרים באפשרות Maven ל-Java, באפשרות PyPi ל-Python, באפשרות npm ל-JavaScript או באפשרות Go ל-Go).

  4. מזינים את הפרטים הבאים של המאגר החדש:

    1. בשדה Name, מזינים שם או מזהה ייחודי למאגר המרוחק.

    2. בשדה אחסון מרחוק, בוחרים אחת מהאפשרויות הבאות:

      • 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

      • מעבר אל: 

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

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

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

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

  5. בקטע HTTP, בוחרים באפשרות Authentication.

  6. מציינים את הפרטים הבאים:

    1. בשדה Authentication type, מזינים את הערך Username.
    2. בשדה שם משתמש, מזינים את הערך _json_key_base64.
    3. בשדה Password, מזינים את המחרוזת בקידוד base64 של קובץ המפתח בפורמט JSON של חשבון השירות. משתמשים בכל המחרוזת בקידוד Base64 בשורה אחת בתור הסיסמה. כדי לקבל את המחרוזת בקידוד Base64, מריצים את הפקודה cat key-filename.json | base64.

  7. לוחצים על Create Repository.

אחרי שמגדירים את המאגר המרוחק החדש, צריך להגדיר את כלי ה-build (לדוגמה, Apache Maven,‏ Gradle Build Tool או pip) כך שישתמשו במאגר המרוחק החדש.

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