הרשמה להתראות

כשנרשמים להתראות Pub/Sub, מקבלים התראות כשחבילות חדשות ועדכוני פגיעויות זמינים ל-Assured Open Source Software‏ (Assured OSS).

ב-Assured OSS מתפרסמים שני סוגים של התראות:

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

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

התראות פרוגרמטיות על עדכונים במטא-נתונים של אבטחה וחבילות חדשות מתפרסמות בנושאי Pub/Sub. ההתראות האלה זמינות בפורמט JSON. כדי לקבל התראות, אתם יכולים ליצור מינוי שליפה או מינוי דחיפה לנושא של Assured OSS.

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

בקטעים הבאים מתוארים נושאי Pub/Sub.

המסמך הזה רלוונטי גם למסלול פרימיום וגם לתוכנית בחינם.

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

עבור מסלול הפרימיום של Assured OSS, אם הפעלתם את VPC Service Controls, הגדירו את כלל התעבורה היוצאת.

נושא: הדרכה על החבילה

  • שם הנושא: projects/cloud-aoss/topics/package_onboarding
  • הודעה: הנושא הזה מכיל מידע על גרסאות חדשות של חבילות שנוספו ל-Assured OSS ועדכונים לגבי סטטוס ההצטרפות שלהן.

  • סכימת נתוני ההודעות:

    {
"package_name" string
"package_version" string
"language" string
"onboarding_status" string
"notification_status" string
}

  • מאפייני נתוני ההודעות:

    "PackageName"     string
"PackageVersion"  string
"PackageLanguage" string
"SchemaVersion"   string
"GenerateTime"    string

נושא המידע על נקודת החולשה

  • שם הנושא: projects/cloud-aoss/topics/vulnerability_information
  • הודעה: הנושא הזה מכיל מידע על נקודות חולשה חדשות שזוהו במערכת, או אם המטא-נתונים של נקודת חולשה כלשהי עודכנו.

  • סכימת נתוני ההודעות:

    {
"vulnerabilityId" string
"notificationStatus" string
}

  • מאפייני נתוני ההודעות:

    "PackageName"     string
"PackageVersion"  string
"PackageLanguage" string
"SchemaVersion"   string
"GenerateTime"    string

נושא מידע מאוחד על הוספת חבילות ונקודות חולשה לרמת פרימיום

אפשר לגשת לכל ההתראות של Assured OSS מהנושא הבא ב-Pub/Sub:

projects/assuredoss-blue/topics/assuredoss-notifications

מאפייני ההתראות

מאפייני ההתראה הבאים הם חלק מההודעה שפורסמה ב-Pub/Sub. אפשר להשתמש במאפיינים האלה כדי לסנן את ההודעה.

{
  "Type": "string",             // Indicates the type of notification, can be 'PackageVersion' or 'Vulnerability'
  "PackageName": "string",      // Package ID
  "PackageVersion": "string",   // Version of the package
  "Language": "string",         // Language of the package
  "SchemaVersion": int,         // Schema version of the data in message
  "GenerateTime": "string"      // Time at which the event occurred
}

המאפיין GenerateTime הוא בפורמט RFC 3339.

כשהמאפיין Type הוא PackageVersion, נתוני ההודעה כוללים את השדות הבאים:

{
  "PackageName": "string",       // Package ID
  "PackageVersion": "string",    // Version of the package
  "Language": "string",          // Language of the package
  "NotificationStatus": "string" // Status of package-version,'New' indicates available to download from Assured OSS
}

כשהמאפיין Type הוא Vulnerability, נתוני ההודעה כוללים את השדות הבאים:

{
  "ID": "string",            // Vulnerability ID affecting the package
  "Severity": "string",      // Severity of the vulnerability
  "Sources": [
    {
      "Name": "string",      // Source of vulnerability information
      "Link": "string"       // URL of vulnerability details
    }
  ],
  "Summary": "string",       // Summary of vulnerability
  "Description": "string",   // Detailed description of vulnerability
  "PackageName": "string",       // Package ID
  "PackageVersion": "string",    // Version of the package
  "Language": "string",          // Language of the package
  "NotificationStatus": "string" // Status of package-version
}

הערך בשדה NotificationStatus מציין את סטטוס נקודת החולשה. אם נקודת החולשה חדשה בחבילה, הערך הוא New. אם יש עדכון לנקודת חולשה קיימת, הערך הוא Update.

יצירת מינוי שליפה

כדי ליצור מינוי שליפה:

  1. יוצרים מינוי שליפה. אפשר להשתמש במסוףGoogle Cloud , ב-Google Cloud CLI או ב-Pub/Sub API.

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

יצירת מינוי דחיפה

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

  • אם יש לכם פרויקט וחשבון שירות ב- Google Cloud (לדוגמה, אם שילבתם את Assured OSS עם Security Command Center):

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

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

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