רישום ביומן ביקורת של שרת proxy לאימות זהויות (IAP)

יומני הביקורת של Cloud ל-IAP מאפשרים לכם לעקוב אחרי פעולות ניהול וגישה לנתונים במשאבים שלכם, כדי לעזור לכם לעקוב אחרי שינויים בגישה ובהגדרות. אתם יכולים לשלוח שאילתות ליומנים האלה ב-Logs Explorer ולבדוק אילו שיטות של Identity-Aware Proxy API יוצרות יומני ביקורת של Cloud.

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

הערות

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

שם השירות

כדי להציג את יומני הביקורת של שרת proxy לאימות זהויות (IAP):

  1. במסוף Google Cloud , נכנסים לדף Logs Explorer:

    כניסה לדף Logs Explorer

  2. מעתיקים את השאילתה הבאה ומדביקים אותה בשדה Query של Logs Explorer, ואז לוחצים על Run query.

        protoPayload.serviceName="iap.googleapis.com"

קודי Method לפי סוג ההרשאה

לכל הרשאה ב-IAM יש מאפיין type עם enum שיכול להיות אחד מארבעת הערכים הבאים: ADMIN_READ,‏ ADMIN_WRITE,‏ DATA_READ או DATA_WRITE. כשקוראים ל-method, שרת proxy לאימות זהויות (IAP) יוצר יומן ביקורת שהקטגוריה שלו תלויה במאפיין type של ההרשאה שנדרשת לביצוע ה-method. ה-methods שבשבילן צריך הרשאה ב-IAM עם הערכים DATA_READ‏, DATA_WRITE או ADMIN_READ במאפיין type יוצרות יומני ביקורת של Data Access. ה-methods שבשבילן צריך הרשאה ב-IAM עם הערכים ADMIN_WRITE במאפיין type יוצרות יומני ביקורת של Admin Activity.

ה-methods של ה-API ברשימה הבאה שמסומנות ב-(LRO) הן פעולות ממושכות. בדרך כלל, ה-methods האלה יוצרות שתי רשומות ביומן הביקורת: אחת כשהפעולה מתחילה ואחת כשהיא מסתיימת. אתם יכולים לקרוא מידע נוסף במאמר בנושא יומני ביקורת של פעולות ממושכות.
סוג ההרשאה Methods
ADMIN_READ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
ADMIN_WRITE google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
DATA_READ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
DATA_WRITE google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression

יומני ביקורת של ממשק ה-API

במאמר העזרה בנושא ניהול הזהויות והרשאות הגישה (IAM) ל-IAP מוסבר איך מתבצעת הבדיקה של ההרשאות לכל method ואילו הרשאות נבדקות.

google.cloud.iap.v1.IdentityAwareProxyAdminService

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.cloud.iap.v1.IdentityAwareProxyAdminService.

CreateTunnelDestGroup

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelDestGroups.create - DATA_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup"

DeleteTunnelDestGroup

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelDestGroups.delete - DATA_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup"

GetIamPolicy

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelServices.getIamPolicy - ADMIN_READ
    • iap.web.getIamPolicy - ADMIN_READ
    • iap.webServices.getIamPolicy - ADMIN_READ
    • iap.webTypes.getIamPolicy - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"

GetIapSettings

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.projects.getSettings - ADMIN_READ
    • iap.web.getSettings - ADMIN_READ
    • iap.webServiceVersions.getSettings - ADMIN_READ
    • iap.webServices.getSettings - ADMIN_READ
    • iap.webTypes.getSettings - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"

GetTunnelDestGroup

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelDestGroups.get - DATA_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup"

ListTunnelDestGroups

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelDestGroups.list - DATA_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups"

SetIamPolicy

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • iap.tunnelServices.setIamPolicy - ADMIN_WRITE
    • iap.web.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"

UpdateIapSettings

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - DATA_WRITE
    • iap.webServiceVersions.updateSettings - DATA_WRITE
    • iap.webServices.updateSettings - DATA_WRITE
    • iap.webTypes.updateSettings - DATA_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"

UpdateTunnelDestGroup

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelDestGroups.update - DATA_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup"

ValidateIapAttributeExpression

  • Method:‏ google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - DATA_WRITE
    • iap.webServices.updateSettings - DATA_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression"

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.

GetIamPolicy

  • Method:‏ google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  • סוג יומן הביקורת: גישה לנתונים
  • הרשאות:
    • iap.tunnelServices.getIamPolicy - ADMIN_READ
    • iap.web.getIamPolicy - ADMIN_READ
    • iap.webServiceVersions.getIamPolicy - ADMIN_READ
    • iap.webServices.getIamPolicy - ADMIN_READ
    • iap.webTypes.getIamPolicy - ADMIN_READ
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"

SetIamPolicy

  • Method:‏ google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  • סוג יומן הביקורת: פעילות אדמין
  • הרשאות:
    • iap.tunnelServices.setIamPolicy - ADMIN_WRITE
    • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  • סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"

אילו methods לא יוצרות יומני ביקורת

יכולות להיות כמה סיבות שב-method מסוימת לא נוצרים יומני ביקורת:

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

ה-methods הבאות לא יוצרות יומני ביקורת:

  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateBrand
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateIdentityAwareProxyClient
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.DeleteIdentityAwareProxyClient
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetBrand
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetIdentityAwareProxyClient
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListBrands
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListIdentityAwareProxyClients
  • google.cloud.iap.v1.IdentityAwareProxyOAuthService.ResetIdentityAwareProxyClientSecret
  • google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.TestIamPermissions

שדות

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

הנה פרטים חשובים על כמה מהשדות ביומן:

שדה ערך
authenticationInfo כתובת האימייל של המשתמש שניסה לגשת למשאב בתור principalEmail. המידע הזה לא מופיע ביומנים של בקשות לא מאומתות.
requestMetadata.callerIp כתובת ה-IP שממנה הגיעה הבקשה.
requestMetadata.requestAttributes שיטת הבקשה וכתובת ה-URL.
authorizationInfo.resource המשאב שאליו ניגשים.
authorizationInfo.granted ערך בוליאני שמציין אם IAP אישר את הגישה המבוקשת.