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

בדף הזה מוסבר איך מגדירים מאגר מרוחק כדי לגשת לחבילות Assured OSS ולהוריד אותן. יש שתי אפשרויות להגדרת מאגר מרוחק: JFrog Artifactory או Sonatype Nexus. מידע נוסף על אפשרויות המאגר זמין במאמר אפשרויות מאגר OSS מאומת.

המסמך הזה רלוונטי רק למהדורת הפרימיום של 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 או Go ל-Go).

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

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

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

      • ‫Java: 
        https://us-maven.pkg.dev
      • ‫Python: 
        https://us-python.pkg.dev
      • ‫Javascript: 
        https://us-npm.pkg.dev
      • עוברים אל: 
        https://us-go.pkg.dev

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

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

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

      Successfully connected to server

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

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

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

      • ‫Java: 
        https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
      • ‫Python: 
        https://us-python.pkg.dev/
      • ‫JavaScript: 
        https://us-npm.pkg.dev/PROJECT_ID/assuredoss-npm
      • עוברים אל: 
        https://us-go.pkg.dev/PROJECT_ID/assuredoss-go

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

    3. בשדה שם משתמש, מזינים _json_key_base64.

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

    5. ב-Python בלבד, בשדה כתובת ה-URL של המאגר, מזינים את הערך הבא: 

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

  6. ב-Go בלבד, בכרטיסייה הגדרות מתקדמות, בוחרים באפשרות דילוג על בקשות HEAD.

  7. לוחצים על יצירת מאגר מרוחק.

    עבור חבילות Python, מוסיפים את כתובת ה-URL שהתקבלה עם /simple. משתמשים בכתובת ה-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.

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

בעיות מוכרות

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

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

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

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

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

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

      • ‫Java: 

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

      • ‫Python: 

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

      • ‫JavaScript: 

        https://us-npm.pkg.dev/PROJECT_ID/assuredoss-npm

      • עוברים אל: 

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

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

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

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

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

  7. לוחצים על Create Repository (יצירת מאגר).

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

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