כשסוכן הניהול קורא לסוכן Agent2Agent (A2A) מרוחק, הגדרת היקף ההרשאות עוזרת לוודא שהסוכן המרוחק מקבל רק את ההרשאות שנדרשות לבקשה הזו. אחרי שמוצאים נציג ב-Agent Registry, אפשר לכלול את פרטי הכניסה של המשתמש או ליצור אסימונים בהיקף מסוים באמצעות מנהל האימות של Agent Identity עם היקפי הרשאות מוגבלים של OAuth או גבולות גישה לפרטי כניסה ל-Cloud Storage.
לפני שמתחילים
לפני שמגבילים את הרשאות הסוכן באמצעות פרטי כניסה ברמת ההיקף לקריאות A2A, צריך לבצע את השלבים הבאים:
- הגדרת Agent Registry.
אם אתם משתמשים בפרויקט אחד, אתרו את מזהה הפרויקט של פרויקט הפיקוח שבו מופעל Agent Registry. אם הגדרתם גבול ניהול לכמה פרויקטים, השתמשו במזהה של פרויקט הניהול כדי לגלות ולרשום את כל הפרויקטים בגבול, או ציינו מזהה של פרויקט חבר כדי לבצע פעולות בפרויקט יחיד.
אם רוצים להגביל את האסימונים של Cloud Storage, צריך להפעיל בפרויקט את Security Token Service API (
sts.googleapis.com).מתקינים את ספריות Python
google-authו-requests:pip install --upgrade google-auth requestsמגדירים את Application Default Credentials (ADC) לפיתוח מקומי. אחרת, מצרפים חשבון שירות או הגדרת פרטי כניסה של איחוד שירותי אימות הזהות של עומסי עבודה:
gcloud auth application-default login
התפקידים הנדרשים
אתם יכולים להשתמש בחשבון המשתמש שלכם לפיתוח מקומי, או להשתמש בחשבון שירות או בישות מורשית של סוכן כדי שהסוכן המתאם יזהה סוכנים רשומים וישלח קריאות לסוכני A2A. כדי להשלים את המשימות האלה, צריך להקצות את התפקידים המתאימים לחשבון המשתמש, לחשבון השירות או לישות המורשית של הסוכן.
כדי לוודא שלחשבון המשתמש, לחשבון השירות או לישות המורשית של הסוכן יש את ההרשאות הנדרשות כדי למצוא סוכני A2A ב-Agent Registry ולקרוא לסוכני A2A, צריך לבקש מהאדמין לתת לחשבון המשתמש, לחשבון השירות או לישות המורשית של הסוכן את תפקידי ה-IAM הבאים:
-
כדי לחפש סוכנים ב-Agent Registry:
צפייה ב-Agent Registry API (
roles/agentregistry.viewer) בפרויקט הפיקוח שבו Agent Registry מופעל -
כדי לקרוא לסוכן A2A בזמן הריצה:
התפקיד של זמן הריצה או השער לשירות שמארח את סוכן היעד, שנדרש כדי לקרוא לסוכן הזה. לדוגמה, אם הנציג המטורגט פועל ב-Cloud Run, לחשבון או לחשבון המשתמש צריך להיות התפקיד "מפעיל Cloud Run" (
roles/run.invoker).
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שהאדמין גם יוכל לתת לחשבון המשתמש, לחשבון השירות או לישות המורשית של הסוכן את ההרשאות הנדרשות באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
איך פרטי הכניסה עוברים בין סוכנים
כשלקוח A2A או סוכן תזמור שולחים הודעה לסוכן מרוחק, שירותים במורד הזרם בודקים את ההרשאות על סמך אופן האימות של הבקשה:
- בשם המשתמש: המשתמש נכנס לסוכן הניהול, שמעביר לסוכן ה-A2A המרוחק אסימון OAuth 2.0 שהמשתמש אישר או אסימון שמנוהל על ידי מנהל האימות. ממשקי ה-API של Google Cloud מאמתים את האסימון ובודקים את ההרשאות של המשתמש בניהול הזהויות והרשאות הגישה (IAM), כדי שהסוכן המרוחק לא יוכל לגשת למשאבים שלמשתמש אין הרשאה לגשת אליהם.
- שימוש בזהות של הסוכן עצמו: כשסוכן תזמור פועל בלי משתמש מחובר, הוא מאמת את עצמו באמצעות זהות הסוכן או חשבון השירות שלו. שירותים במורד הזרם בודקים את התפקידים שהוקצו לחשבון המשתמש של הנציג (
principal://), לקבוצת חשבונות משתמשים תואמת (principalSet://) או לחשבון השירות שלו. - מעומסי עבודה חיצוניים או חוצי-עננים: סוכנים שפועלים מחוץ ל-Google Cloud מחליפים טוקנים מספק זהויות חיצוני באמצעות איחוד זהויות של עומסי עבודה כדי לקבל טוקני גישה מאוחדים של Google Cloud לפני שהם שולחים קריאה ל-Agent Endpoint של סוכן ה-A2A המטורגט.
כדי להגביל את ההרשאות שהאסימון מעניק לסוכן מרוחק, אתם יכולים להגביל את ההיקף של אסימוני OAuth באמצעות קישורים לסוכני A2A של צד שלישי או של SaaS.
אתם יכולים גם להגביל את הטוקנים של Cloud Storage באמצעות גבול הגישה של פרטי הכניסה, כדי להגביל את טוקן הגישה של Google Cloud לקטגוריות או לאובייקטים ספציפיים של Cloud Storage. גבולות הגישה לפרטי כניסה תומכים רק בהרשאות של Cloud Storage (storage.googleapis.com). לממשקי API אחרים של Google Cloud ולקריאות של סוכני A2A, צריך להגדיר את היקף הגישה באמצעות קישורים של מנהל האימות, זהויות של סוכנים עם הרשאות מינימליות באמצעות מדיניות ההרשאות והדחיות של IAM או Agent Gateway.
אם האפשרויות האלה לא מתאימות לתרחיש לדוגמה שלכם, וסוכן התזמור מאמת באמצעות חשבון שירות, אתם יכולים גם להשתמש בהתחזות לחשבון שירות כדי לבקש אסימון לטווח קצר לחשבון שירות ייעודי, שיש לו רק את התפקידים שנדרשים למשימה ספציפית.
היקף טוקנים של OAuth עם קישורים
כשמפעילים סוכן A2A של צד שלישי או של SaaS שמשתמש ב-OAuth 2.0 עם 2 רגליים או 3 רגליים, צריך ליצור ספק אימות במנהל האימות ולצרף משאב Binding במרשם הסוכנים שמפרט רק את scopes של OAuth שהסוכן המרוחק צריך. כשהערכה לפיתוח סוכנים (ADK) מאחזרת את הסוכן המרוחק באמצעות get_remote_a2a_agent(), היא מבקשת אסימונים שמוגבלים להיקפים של הקישור הזה. במאמרים אימות לכלים ולמשאבים וניהול קישורים מוסבר איך עושים את זה.
הגבלת טוקנים של Cloud Storage
אם סוכן ה-orchestrator מעביר טוקן גישה מסוג OAuth 2.0 לסוכן או לכלי שקורא או כותב נתונים ב-Cloud Storage, אתם יכולים לצמצם את ההרשאות של הטוקן כדי לאפשר גישה רק לקטגוריות או לתחיליות של אובייקטים ספציפיים. משתמשים ב-Security Token Service כדי להחיל גבול גישה לפרטי הכניסה לפני ששולחים את הבקשה:
import google.auth
from google.auth import downscoped
from google.auth.transport.requests import Request
source_creds, _ = google.auth.default(
scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
access_boundary_rule = downscoped.AccessBoundaryRule(
available_resource=(
"//storage.googleapis.com/projects/_/buckets/BUCKET_NAME"
),
available_permissions=["inRole:roles/storage.objectViewer"],
)
cab = downscoped.CredentialAccessBoundary(rules=[access_boundary_rule])
downscoped_creds = downscoped.Credentials(
source_credentials=source_creds,
credential_access_boundary=cab,
)
downscoped_creds.refresh(Request())
מחליפים את BUCKET_NAME בשם של הקטגוריה ב-Cloud Storage שהסוכן המרוחק יכול לקרוא.
אמצעי בקרה נוספים לאבטחה
אתם יכולים לשלב את היקף ההרשאות עם מדיניות רשת ב-Kubernetes ובדיקת הנחיות:
- כללי מדיניות גישה לרשת: ניתוב קריאות A2A דרך Agent Gateway כדי לאכוף את מערכת הגישה המאוחדת לכללי מדיניות (UAP) של שרת proxy לאימות זהויות (IAP) במשאבי
Agentרשומים. - בדיקת פרומפטים ותשובות: מגדירים את השילוב של הגנה מוגברת על המודל עם Agent Gateway ואת הקישורים ל-Service Extensions כדי לבדוק את הפרומפטים והתשובות הנתמכים של A2A, במטרה לזהות החדרת פרומפטים וחשיפה של מידע אישי רגיש.
המאמרים הבאים
- במאמר אימות מול כלים ומשאבים מוסבר איך מגדירים קישורי OAuth דו-רגליים ותלת-רגליים.
- קריאה ל-Agent Endpoint של סוכני A2A באמצעות אסימוני OAuth 2.0 ו-OIDC ביצירת מערכות מרובות סוכנים וקריאה לסוכני A2A.
- בקטע תפקידים והרשאות מפורטים התפקידים שנדרשים כדי להפעיל סוכני A2A וכללי מדיניות הדחייה ב-IAM.