Google Cloud מדיניות הארגון מאפשרת לכם שליטה מרוכזת ופרוגרמטית על המשאבים של הארגון. אדמינים של מדיניות הארגון יכולים להגדיר מדיניות ארגונית, שהיא קבוצה של הגבלות שנקראות אילוצים, שחלות על משאבי Google Cloud ועל הצאצאים של המשאבים האלה בGoogle Cloud היררכיית המשאבים. אפשר לאכוף את מדיניות הארגון ברמת הארגון, התיקייה או הפרויקט.
מדיניות הארגון מספקת אילוצים מוגדרים מראש לשירותים שונים שלGoogle Cloud . עם זאת, אם אתם רוצים שליטה מפורטת יותר וניתנת להתאמה אישית על השדות הספציפיים שמוגבלים במדיניות הארגון, אתם יכולים גם ליצור אילוצים בהתאמה אישית. כדי להטמיע אילוץ בהתאמה אישית ב-CCAI Platform, צריך להגדיר את המכונות לגישה פרטית. כך הגישה הציבורית לאינטרנט מוגבלת למכונות האלה, וצריך להגדיר את Private Service Connect כדי שהנציגים, המנהלים והאדמינים של CCAI Platform יוכלו לגשת אליהן. מידע נוסף זמין במאמר הגדרת Private Service Connect.
יתרונות
מדיניות הארגון ב-CCAI Platform מאפשרת לאדמינים ב- Google Cloudלאכוף אילוצים ברמת הארגון על נתיבי רשת שלא נכללים ב-VPC Service Controls. בנוסף, כללי מדיניות הארגון האלה מאפשרים שליטה פרטנית בנתיבי תעבורת הנתונים הנכנסת (ingress) והיוצאת (egress), על ידי חלוקת התנועה ברשת לרכיבים. מידע נוסף מופיע במאמר רכיבים.
ירושה של מדיניות
כברירת מחדל, מדיניות הארגון עוברת בירושה לצאצאים של המשאבים שעליהם אתם אוכפים את המדיניות. לדוגמה, אם אוכפים מדיניות בתיקייה, Google Cloud אוכף את המדיניות בכל הפרויקטים שבתיקייה. במאמר כללי הערכה של היררכיה מוסבר בהרחבה על ההתנהגות הזו ואיך לשנות אותה.
תמחור
שירות מדיניות הארגון, כולל כללי מדיניות מוגדרים מראש וכללי מדיניות בהתאמה אישית, מוצע ללא תשלום.
מגבלות
פלטפורמת CCAI לא משולבת עם מאגר משאבי ענן, ולכן התכונה סימולטור המדיניות של כלים לבקרת מדיניות לא זמינה למדיניות הארגון בפלטפורמת CCAI.
לפני שמתחילים
לפני שמתחילים, צריך לבצע את הפעולות הבאות:
- פועלים לפי השלבים שמפורטים במאמר הגדרת פרויקט ב- Google Cloud ל-CCAI Platform.
- כדי להתקין ולהפעיל את ה-CLI של Google Cloud :
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:
gcloud init
-
- מוודאים שאתם יודעים מהו מזהה הארגון שלכם.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול מדיניות הארגון, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM:
- אדמין של מדיניות הארגון (
roles/orgpolicy.policyAdmin) במשאב הארגון -
כדי לקבל גישה מלאה למשאבים של CCAI Platform:
אדמין של Contact Center AI Platform (
roles/contactcenteraiplatform.admin) במשאב של הפרויקט -
כדי להפעיל, להשבית ולבדוק את מצבי השירות, לבדוק פעולות ולצרוך מכסות וחיובים בפרויקט של צרכן:
אדמין של Service Usage (
roles/serviceusage.serviceUsageAdmin) במשאב הפרויקט
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לנהל את מדיניות הארגון. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לנהל את מדיניות הארגון, נדרשות ההרשאות הבאות:
-
orgpolicy.customConstraints.get -
orgpolicy.customConstraints.list -
orgpolicy.customConstraints.create -
orgpolicy.customConstraints.update -
orgpolicy.customConstraints.delete
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
רכיבים
אתם משתמשים ברכיבים כשאתם יוצרים אילוצים בהתאמה אישית במכונות של פלטפורמת CCAI. רכיבים הם הפשטות של נתיבי רשת שמשויכים לפונקציות ספציפיות של פלטפורמת CCAI. לדוגמה, הרכיב agent מייצג את הקבוצה של כל נתיבי הרשת הנכנסים שקשורים למשימות שמבצעים נציג, מנהל או אדמין ב-CCAI Platform.
בטבלה הבאה מפורטים הרכיבים שמשמשים לאילוצים בהתאמה אישית ב-CCAI Platform:
| רכיב | תיאור | כיוון התנועה | ערך לדוגמה |
|---|---|---|---|
AGENT |
קבוצה של כל נתיבי הרשת הנכנסים שקשורים למשימות שמבצעים נציג, מנהל או אדמין ב-CCAI Platform. | תעבורת נתונים נכנסת (Ingress) | AGENT |
CRM |
תעבורת נתונים יוצאת לאפליקציה לניהול קשרי לקוחות (CRM). | תעבורת נתונים יוצאת (egress) | CRM |
MEDIA |
תעבורת נתונים יוצאת (egress) של מדיה. | תעבורת נתונים יוצאת (egress) | MEDIA |
DIRECT_ACCESS_POINT |
תנועה יוצאת לנקודת קצה (endpoint) של גישה ישירה (DAP). | תעבורת נתונים יוצאת (egress) | DIRECT_ACCESS_POINT |
EMAIL |
תעבורת נתונים יוצאת (egress) באימייל. | תעבורת נתונים יוצאת (egress) | EMAIL |
COBROWSE |
תנועת גולשים יוצאת של שיתוף מסך. | תעבורת נתונים יוצאת (egress) | COBROWSE |
יצירת אילוץ בהתאמה אישית
אילוץ מותאם אישית מוגדר בקובץ YAML לפי המשאבים, השיטות, התנאים והפעולות שנתמכים בשירות שבו אתם אוכפים את מדיניות הארגון. התנאים לאילוצים המותאמים אישית מוגדרים באמצעות Common Expression Language (CEL). למידע נוסף על יצירת תנאים באילוצים בהתאמה אישית באמצעות CEL, קראו את הקטע בנושא CEL במאמר יצירה וניהול של אילוצים בהתאמה אישית.
כדי להגדיר אילוץ בהתאמה אישית בקובץ YAML ל-CCAI Platform, מבצעים את השלבים הבאים:
יוצרים קובץ טקסט שמכיל את השורות הבאות:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: - contactcenteraiplatform.googleapis.com/ContactCenter methodTypes: - CREATE - UPDATE condition: "CONDITION" actionType: ACTION_TYPE displayName: "DISPLAY_NAME" description: "DESCRIPTION"מחליפים את מה שכתוב בשדות הבאים:
ORGANIZATION_ID: מזהה הארגון.
CONSTRAINT_NAME: השם של האילוץ המותאם אישית. אילוץ בהתאמה אישית חייב להתחיל בקידומתcustom., ויכול לכלול רק אותיות רישיות, אותיות קטנות או מספרים – לדוגמה,custom.requirePrivateAccess. האורך המקסימלי של השדה הזה הוא 70 תווים, לא כולל הקידומת.
CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך, לדוגמהresource.privateAccess.ingressSettings.exists(private_component, private_component.name == 'AGENT'). האורך המקסימלי של השדה הזה הוא 1,500 תווים. במאמר הזה מפורטים המשאבים והפעולות שנתמכים ב-CCAI Platform, שאפשר לכתוב להם תנאים. מידע נוסף על רכיבים מופיע במאמר רכיבים.
ACTION_TYPE: הפעולה שצריך לבצע אם מתקיים התנאיcondition. מציינים אתALLOW.
DISPLAY_NAME: שם קריא לאנשים של האילוץ. האורך המקסימלי של השדה הזה הוא 200 תווים.
DESCRIPTION: תיאור ידידותי למשתמש של האילוץ, שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. האורך המקסימלי של השדה הזה הוא 2,000 תווים.
שומרים את האילוץ המותאם אישית כקובץ YAML, לדוגמה
customconstraint.yaml. משתמשים בנתיב לקובץ הזה כערך של המשתנהCONSTRAINT_PATHבקטע הגדרת אילוץ בהתאמה אישית.
למידע נוסף על מדיניות ארגון בהתאמה אישית ועל תחביר של אילוצים, ראו דוגמאות למדיניות ארגון בהתאמה אישית לתרחישים נפוצים.
הגדרת אילוץ בהתאמה אישית
המסוף
כדי ליצור אילוץ בהתאמה אישית:
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- לוחצים על Custom constraint.
- בתיבה Display name, מזינים שם לאילוץ שיהיה קריא לאנשים. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע רגיש בשמות לתצוגה, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
-
בתיבה Constraint ID, מזינים את המזהה שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה
custom.requirePrivateAccess. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. - בתיבה Description, מזינים תיאור של האילוץ שקריא לאנשים. התיאור הזה משמש כהודעת שגיאה כשיש הפרה של המדיניות. ציינו פרטים על הסיבה להפרת המדיניות ואיך לפתור את הבעיה. אל תכללו פרטים אישיים מזהים או מידע רגיש בתיאור, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
-
בתיבה Resource type, בוחרים את השם של משאב ה- Google Cloud REST שמכיל את האובייקט והשדה שרוצים להגביל, לדוגמה
container.googleapis.com/Cluster. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
אפשר לאכוף את האילוץ הזה רק ב-REST
CREATE. - כדי להגדיר תנאי, לוחצים על עריכת התנאי.
-
בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, לדוגמה
resource.autopilot.enabled == false. השדה הזה יכול להכיל עד 1,500 תווים. לפרטים על השימוש ב-CEL, ראו Common Expression Language. מידע נוסף על משאבי השירות שבהם אפשר להשתמש באילוצים מותאמים אישית מופיע במאמר שירותים שנתמכים באילוצים מותאמים אישית. - לוחצים על Save.
- בקטע Action, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.
- לוחצים על Create constraint.
כדי לראות את השיטות הנתמכות בכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
פעולת הדחייה פירושה שהפעולה ליצירה או לעדכון של המשאב נחסמת אם התנאי מקבל את הערך True.
פעולת ההרשאה מאפשרת ליצור או לעדכן את המשאב רק אם התנאי מתקיים. כל מקרה אחר, מלבד אלה שרשומים במפורש בתנאי, נחסם.
אחרי שמזינים ערך בכל שדה, הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה מופיעה בצד שמאל.
gcloud
- כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא:
-
ORGANIZATION_ID: מזהה הארגון, למשל123456789. -
CONSTRAINT_NAME: השם שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה,custom.requirePrivateAccess. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. -
RESOURCE_NAME: השם המלא של המשאב ב- Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה,contactcenteraiplatform.googleapis.com/ContactCenter. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
methodTypes: השיטות של REST שעליהן נאכף האילוץ. הערך יכול להיות רקCREATE. -
CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,500 תווים. לדוגמה,.resource.privateAccess.ingressSettings.exists(private_component, private_component.name == 'AGENT') -
ACTION: הפעולה שצריך לבצע אם התנאיconditionמתקיים. הערך יכול להיות רקALLOW. -
DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים או במידע רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים. -
DESCRIPTION: תיאור קריא של האילוץ שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. השדה הזה יכול להכיל עד 2,000 תווים. -
אחרי שיוצרים את קובץ ה-YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה
gcloud org-policies set-custom-constraint: -
כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה
gcloud org-policies list-custom-constraints:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
מחליפים את מה שכתוב בשדות הבאים:
כדי לראות את השיטות הנתמכות לכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
למידע נוסף על המשאבים הזמינים לכתיבת תנאים, ראו משאבים נתמכים.
הפעולה allow פירושה שאם התנאי מקבל את הערך true, מותר ליצור או לעדכן את המשאב. זה גם אומר שכל מקרה אחר, מלבד המקרה שמופיע במפורש בתנאי, נחסם.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוץ בהתאמה אישית. לדוגמה, /home/user/customconstraint.yaml.
בסיום הפעולה, האילוצים המותאמים אישית יהיו זמינים כמדיניות של הארגון ברשימת Google Cloud מדיניות הארגון.
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
מחליפים את ORGANIZATION_ID במזהה של משאב הארגון.
אכיפה של אילוץ בהתאמה אישית
כדי לאכוף אילוץ בוליאני, אפשר ליצור מדיניות ארגון שמפנה אליו ולהחיל את המדיניות הזו על משאב Google Cloud .
כדי לאכוף אילוץ בהתאמה אישית:
כדי ליצור מדיניות ארגון שאוכפת אילוץ בוליאני, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ הבא:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: trueמחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ. -
CONSTRAINT_NAME: השם שהגדרתם לאילוץ בהתאמה אישית, לדוגמהcustom.requirePrivateAccess.
-
כדי לאכוף את מדיניות הארגון שמכילה את האילוץ, מריצים את הפקודה הבאה:
gcloud org-policies set-policy POLICY_PATHמחליפים את
POLICY_PATHבנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
בדיקת האילוץ המותאם אישית
אילוץ בהתאמה אישית, כמו שמוגדר בקטע יצירת אילוץ בהתאמה אישית (עם רכיב מסוג AGENT, כמו בדוגמה בתיאור של CONDITION), אוכף את ההתנהגויות הבאות:
יצירה או עדכון של מכונה עם רכיב מסוג
AGENTמצליחים. מידע נוסף זמין במאמר יצירה ועדכון של מכונה של CCAI Platform עם רכיב מסוגAGENT.יצירה או עדכון של מכונה בלי רכיב מסוג
AGENTנכשלים. מידע נוסף זמין במאמרים יצירת מכונה של פלטפורמת CCAI בלי רכיב מסוגAGENTועדכון מכונה של פלטפורמת CCAI בלי רכיב מסוגAGENT.
יצירה ועדכון של מכונה של פלטפורמת CCAI עם רכיב מסוג AGENT
כדי לבדוק את היצירה והעדכון של מכונה של פלטפורמת CCAI עם רכיב מסוג AGENT, פועלים לפי השלבים הבאים:
יוצרים, מגדירים ואוכפים אילוץ בהתאמה אישית לפי ההוראות שבמסמך הזה.
יוצרים מכונה לפי ההוראות במאמר יצירת מכונה של פלטפורמת CCAI שמוגדרת לגישה פרטית. המכונה נוצרת בהצלחה.
כדי לעדכן את המכונה:
בתפריט הניווט במסוף Google Cloud , לוחצים על CCAI Platform.
מופיע הדף CCAI Platform instances.
לוחצים על שם המכונה שיצרתם קודם לכן בתהליך הזה.
לוחצים על עריכה ואז על הגדרת פריסות.
משנים את לוח הזמנים לפריסה ולוחצים על שמירה. העדכון בוצע בהצלחה.
מכיוון שיצרתם מכונה פרטית של פלטפורמת CCAI, אתם צריכים להגדיר חיבור של Private Service Connect כדי לגשת אליה.
יצירת מכונה של פלטפורמת CCAI בלי רכיב מסוג AGENT
כדי לבדוק יצירה ועדכון של מכונה של פלטפורמת CCAI בלי רכיב מסוג AGENT, מבצעים את השלבים הבאים:
יוצרים, מגדירים ואוכפים אילוץ בהתאמה אישית לפי ההוראות שבמסמך הזה.
מנסים ליצור מכונה לפי ההוראות במאמר יצירת מכונה של פלטפורמת CCAI, בלי להגדיר גישה פרטית. יצירת המכונה נכשלת.
עדכון של מכונה ב-CCAI Platform בלי רכיב מסוג AGENT
כפי שמוצג בקטע יצירת מכונה של פלטפורמת CCAI בלי רכיב מסוג AGENT, אי אפשר ליצור מכונה בלי רכיב מסוג AGENT אחרי אכיפת האילוץ המותאם אישית. אם כבר היה לכם מכונה כזו לפני שאכפתם את האילוץ המותאם אישית, אחרי אכיפת האילוץ, העדכונים של המכונה ייכשלו (אלא אם העדכונים כוללים הוספה של רכיב מסוג AGENT – ראו את ההערה הבאה).
המשאבים והפעולות שנתמכים ב-CCAI Platform
בטבלה הבאה מפורטים המשאבים והפעולות שנתמכים באילוצים בהתאמה אישית של מדיניות הארגון.
| משאב | פעולה | מאפיין | אופרטור | תנאי לדוגמה |
|---|---|---|---|---|
| ContactCenter | יוצרים או מעדכנים מכונה. מידע נוסף זמין במאמר יצירת מכונה של CCAI Platform. | name | מכיל | resource.name.contains("us-central1/contactCenters/myContactCenter") |
| תואם את | resource.name.matches("projects/my-project/locations/us-central1/contactCenters/myContactCenter") |
|||
| startsWith | resource.name.startsWith("projects/my-project") |
|||
| endsWith | resource.name.endsWith("myContactCenter") |
|||
| privateAccess | קיים |
resource.privateAccess.ingressSettings.exists(private_component, private_component.name == 'AGENT')
בודק שהרכיב |
דוגמאות למדיניות ארגונית בהתאמה אישית לתרחישים נפוצים
בטבלה הבאה מפורט התחביר של כמה כללי מדיניות ארגוניים בהתאמה אישית שיכולים להיות שימושיים:
| תיאור | תחביר האילוץ |
|---|---|
כל הרכיבים שצוינו הם פרטיים, כלומר AGENT). |
name: organizations/ORGANIZATION_ID/customConstraints/custom.requirePrivateAccess resourceTypes: - contactcenteraiplatform.googleapis.com/ContactCenter methodTypes: - CREATE - UPDATE condition: "resource.privateAccess.ingressSettings.exists(private_component, private_component.name == 'AGENT')" actionType: ALLOW displayName: Agents cannot connect over the internet. description: Internet access is disallowed for agents. |
כל המכונות, מלבד המכונה היחידה שצוינה, חייבות להשתמש ב-AGENT הפרטי שצוין. |
name: organizations/ORGANIZATION_ID/customConstraints/custom.requirePrivateAccess resourceTypes: - contactcenteraiplatform.googleapis.com/ContactCenter methodTypes: - CREATE - UPDATE condition: "resource.privateAccess.ingressSettings.exists(private_component, private_component.name == 'AGENT' || resource.name.contains('myContactCenterId')" actionType: ALLOW displayName: Restrict Internet access to AGENT for all instances except a single instance. description: Internet access for agents is restricted except for myContactcenterId CCAI Platform instances. |
המאמרים הבאים
- מבוא לשירות מדיניות הארגון
- שימוש באילוצים
- יצירה וניהול של מדיניות ארגונית בהתאמה אישית
- אילוצים של מדיניות הארגון