Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

תחילת העבודה

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

בדף הזה מוסבר איך להתחיל להשתמש באבטחת API מתקדמת בארגונים עם מינוי ובארגונים עם תשלום לפי שימוש.

תפקידים והרשאות נדרשים

בקטעים הבאים מפורטים התפקידים וההרשאות שנדרשים לביצוע משימות באמצעות Advanced API Security.

התפקידים הנדרשים לצפייה בדוחות אבטחה

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

משימת דוח אבטחה	תפקידים נדרשים
הפעלה או השבתה של אבטחת API מתקדמת	‫Apigee אדמין בארגון (`roles/apigee.admin`)
יצירת דוחות	Apigee Organization Admin (`roles/apigee.admin`) Apigee Security Admin (`roles/apigee.securityAdmin`)
הצגת הדוחות	Apigee Security Viewer (`roles/apigee.securityViewer`) Apigee Security Admin (`roles/apigee.securityAdmin`)

התפקידים הנדרשים להערכת סיכונים

בטבלה הבאה מפורטים התפקידים הנדרשים לביצוע משימות שקשורות להערכת סיכונים.

משימת הערכת סיכונים	תפקידים נדרשים
יצירה, עדכון או מחיקה של פרופיל אבטחה בהתאמה אישית	Apigee אדמין לענייני אבטחה (`roles/apigee.securityAdmin`) Apigee אדמין של הארגון (`roles/apigee.admin`)
צירוף או ניתוק של פרופיל אבטחה	Apigee אדמין לענייני אבטחה (`roles/apigee.securityAdmin`) Apigee אדמין של הארגון (`roles/apigee.admin`)
צפייה בציוני אבטחה	‫Apigee אדמין אבטחה (`roles/apigee.securityAdmin`) Apigee צפייה באבטחה (`roles/apigee.securityViewer`) Apigee אדמין ארגון (`roles/apigee.admin`)
הצגת רשימה של כל פרופילי האבטחה או קבלת פרופיל	‫Apigee אדמין אבטחה (`roles/apigee.securityAdmin`) Apigee צפייה באבטחה (`roles/apigee.securityViewer`) Apigee אדמין ארגון (`roles/apigee.admin`)
יצירה, עדכון או מחיקה של תנאי למעקב אבטחה	Apigee אדמין לענייני אבטחה (`roles/apigee.securityAdmin`) Apigee אדמין של הארגון (`roles/apigee.admin`)
רשימה והצגה של תנאי ניטור אבטחה	‫Apigee אדמין אבטחה (`roles/apigee.securityAdmin`) Apigee צפייה באבטחה (`roles/apigee.securityViewer`) Apigee אדמין ארגון (`roles/apigee.admin`)
רשימה והצגה של מדדים של תנאי מעקב אבטחה	אדמין ב-Monitoring (`roles/monitoring.admin`) עריכה ב-Monitoring (`roles/monitoring.editor`)
יצירה, עדכון או מחיקה של התראות למעקב	אילו תפקידים צריך (להתראות אבטחה)
הצגת התראות המעקב	ראו אירועים שקשורים למדיניות התראות מבוססת-מדדים: לפני שמתחילים

תפקידים והרשאות שנדרשים לזיהוי התנהלות פוגעת

בטבלה הבאה מפורטים התפקידים וההרשאות שנדרשים לביצוע משימות שקשורות לזיהוי התנהלות פוגעת.

משימת זיהוי התנהלות פוגעת	תפקידים והרשאות נדרשים
צפייה באירועים בממשק המשתמש של זיהוי שימוש לרעה	‫Apigee אדמין אבטחה (`roles/apigee.securityAdmin`) Apigee צפייה באבטחה (`roles/apigee.securityViewer`) Apigee אדמין ארגון (`roles/apigee.admin`)
הבעת הסכמה או ביטול הסכמה של ארגון לשימוש במודלים של למידת מכונה לזיהוי התנהלות פוגעת	הרשאה`apigee.securitySettings.update` אדמין אבטחה ב-Apigee (`roles/apigee.securityAdmin`) אדמין ארגון ב-Apigee (`roles/apigee.admin`)

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

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

משימת פעולת אבטחה	תפקידים נדרשים
יצירה, עריכה או מחיקה של הגדרות של פעולות אבטחה	Apigee אדמין לענייני אבטחה (`roles/apigee.securityAdmin`) Apigee אדמין של הארגון (`roles/apigee.admin`)
צפייה בפעולות אבטחה או הצגת רשימה שלהן	‫Apigee אדמין אבטחה (`roles/apigee.securityAdmin`) Apigee צפייה באבטחה (`roles/apigee.securityViewer`) Apigee אדמין ארגון (`roles/apigee.admin`)
בדיקת מצב האכיפה	‫Apigee אדמין אבטחה (`roles/apigee.securityAdmin`) Apigee צפייה באבטחה (`roles/apigee.securityViewer`) Apigee אדמין ארגון (`roles/apigee.admin`)

ניהול אבטחת API מתקדמת בארגונים עם מינוי

כדי להשתמש ב-Advanced API Security כלקוחות מינוי, צריך לוודא ש-Advanced API Security כלול בהרשאות המינוי שלכם. מידע על זכויות גישה ב-Apigee כדי להוסיף את Advanced API Security להרשאות שלכם, צריך לפנות אל צוות המכירות של Apigee.

אחרי שתוכנית האבטחה המתקדמת ל-API תהיה חלק מההרשאות שלכם, תוכלו להפעיל אותה בארגון:

איך מקבלים את ההגדרה של תוספים ל-Apigee
הפעלה של Advanced API Security בארגונים עם מינוי

אם אתם לא בטוחים אם אתם משתמשים בארגון Apigee עם מינוי או עם תשלום לפי שימוש, פנו לאדמין של ארגון Apigee שלכם.

איך מקבלים את ההגדרה של תוספים ל-Apigee

כדי להפעיל את Advanced API Security בארגון המנוי שלכם, קודם צריך לקבל את ההגדרה הנוכחית של תוספי Apigee באמצעות קריאת ה-API הבאה. בנוסף, תוכלו לראות אם כבר הפעלתם את התכונה 'אבטחת API מתקדמת'.

curl "https://apigee.googleapis.com/v1/organizations/ORG" \
  -X GET \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer $TOKEN"

איפה

‫ORG הוא שם הארגון.
‫$TOKEN הוא משתנה הסביבה של אסימון גישה ל-OAuth.

הקריאה הזו מחזירה מידע בסיסי על הארגון, כולל קטע להגדרת תוספים של Apigee שמתחיל בשורה:

"addonsConfig": {

בודקים אם הקטע הזה מכיל את הרשומה הבאה:

"apiSecurityConfig": {
          "enabled": true
      }

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

הפעלת אבטחת API מתקדמת בארגונים עם מינויים

כדי להפעיל את התכונה 'אבטחת API מתקדמת' בארגון עם מינוי עם הגדרת ברירת המחדל, מנפיקים בקשת POST כמו זו שמוצגת למטה.

curl "https://apigee.googleapis.com/v1/organizations/ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "apiSecurityConfig": {
          "enabled": true
      }
      <Other entries of your current add-ons configuration>
    }
  }'

איפה

‫ORG הוא שם הארגון.
‫$TOKEN הוא משתנה הסביבה של אסימון גישה ל-OAuth.
<Other entries of your current add-ons configuration> מורכב מכל הערכים האחרים של הגדרת התוספים הנוכחית של Apigee.

לדוגמה, אם ההגדרה הנוכחית של התוספים היא

"addonsConfig": {
  "integrationConfig": {
      "enabled":true
  },
  "monetizationConfig": {
      "enabled":true
  }
},

הפקודה להפעלת אבטחת API מתקדמת תהיה

curl "https://apigee.googleapis.com/v1/organizations/ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "apiSecurityConfig": {
          "enabled": true
      },
      "integrationConfig": {
          "enabled": true
      },
      "monetizationConfig": {
          "enabled": true
      }
    }
  }'

אחרי ששולחים את הבקשה, מקבלים תגובה כמו זו:

{
  "name": "organizations/apigee-docs-d/operations/0718a945-76e0-4393-a456-f9929603b32c",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/apigee-docs-d",
    "state": "IN_PROGRESS"
  }
}

השבתת אבטחת API מתקדמת בארגונים עם מינוי

אם מסיבה כלשהי אתם צריכים להשבית את Advanced API Security בארגון המינוי שלכם, אתם יכולים לעשות זאת על ידי שליחת בקשת POST, והעברת הגדרות התוספים בגוף הבקשה, כמו בדוגמה שלמטה.

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "apiSecurityConfig": {
          "enabled": false
      }
     <Include current add-ons configuration>
    }
  }'

בדוגמה הבאה אפשר לראות את התגובה שמציינת שהפעולה מתבצעת:

{
  "name": "organizations/$ORG/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

מידע נוסף זמין במאמר בנושא הגדרת API של תוספים לארגון.

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

אם אתם לקוחות עם תוכנית Pay-as-you-go, אתם יכולים להפעיל את Advanced API Security כתוסף בתשלום. מידע נוסף על הפעלת התוסף Advanced API Security בסביבות ביניים או בסביבות מקיפות של Apigee זמין במאמר ניהול התוסף Advanced API Security.

אם אתם לא בטוחים אם אתם משתמשים בארגון Apigee עם מינוי או עם תשלום לפי שימוש, פנו לאדמין של ארגון Apigee שלכם.

ניהול אבטחת API מתקדמת בארגוני הערכה

התוסף Advanced API Security נכלל אוטומטית בארגוני ניסיון (הערכה) של Apigee, אבל צריך להפעיל אותו.

כדי להפעיל אותה, פועלים לפי ההוראות במאמר הפעלת אבטחת API מתקדמת בארגונים עם מינוי.

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

הגדרת אבטחה מתקדמת של API באמצעות Terraform

‫Apigee תומך בשימוש ב- כדי לנהל חלק מהפונקציות של אבטחת API מתקדמת.

לדוגמה, אפשר להשתמש ב-Terraform כדי להגדיר:

מידע על הפונקציונליות הנתמכת כרגע זמין בקטע Apigee ב- Terraform Registry. שמות משאבים שקשורים ל-Advanced API Security מתחילים ב-google_apigee_security.

מידע כללי על שימוש ב-Terraform עם Apigee זמין במאמר שימוש ב-Terraform עם Apigee.

השלבים הבאים

אחרי שמפעילים את אבטחת ה-API המתקדמת, כדאי לעיין במאמרים הבאים: