רישום ביומן הביקורת של API Gateway

במאמר הזה מפורטים ה-methods שנבדקו ב-API Gateway.שירותי Google Cloud יוצרים יומני ביקורת שבהם מתועדים אירועי גישה למשאבי Google Cloud והפעולות שהאדמינים עשו בהם. אתם יכולים לקרוא מידע נוסף על יומני הביקורת של Cloud במאמרים האלה:

• הסוגים של יומני הביקורת
• המבנה של רשומות ביומני הביקורת
• שמירה וניתוב של יומני ביקורת
• מחירון מקוצר של Cloud Logging
• הפעלת יומני ביקורת של גישה לנתונים

שם השירות

כדי להציג את יומני הביקורת של API Gateway:

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

   כניסה לדף Logs Explorer

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

       protoPayload.serviceName="apigateway.googleapis.com"
     

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

לכל הרשאה ב-IAM יש מאפיין type עם enum שיכול להיות אחד מארבעת הערכים הבאים: ADMIN_READ,‏ ADMIN_WRITE,‏ DATA_READ או DATA_WRITE. כשקוראים ל-method, ב-API Gateway נוצר יומן ביקורת שהקטגוריה שלו תלויה במאפיין 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.apigateway.v1.ApiGatewayService.GetApi google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig google.cloud.apigateway.v1.ApiGatewayService.GetGateway google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs google.cloud.apigateway.v1.ApiGatewayService.ListApis google.cloud.apigateway.v1.ApiGatewayService.ListGateways google.cloud.apigateway.v1beta.ApiGatewayService.GetApi google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway google.cloud.apigateway.v1beta.ApiGatewayService.ListApiConfigs google.cloud.apigateway.v1beta.ApiGatewayService.ListApis google.cloud.apigateway.v1beta.ApiGatewayService.ListGateways GetIamPolicy google.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations
ADMIN_WRITE	google.cloud.apigateway.v1.ApiGatewayService.CreateApi (LRO) google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig (LRO) google.cloud.apigateway.v1.ApiGatewayService.CreateGateway (LRO) google.cloud.apigateway.v1.ApiGatewayService.DeleteApi (LRO) google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig (LRO) google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway (LRO) google.cloud.apigateway.v1.ApiGatewayService.UpdateApi (LRO) google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig (LRO) google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig (LRO) google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway (LRO) SetIamPolicy google.longrunning.Operations.CancelOperation google.longrunning.Operations.DeleteOperation

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

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

google.cloud.apigateway.v1.ApiGatewayService

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

CreateApi

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.CreateApi
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apis.create - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateApi"
  

CreateApiConfig

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.create - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig"
  

CreateGateway

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.CreateGateway
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.gateways.create - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateGateway"
  

DeleteApi

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.DeleteApi
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apis.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteApi"
  

DeleteApiConfig

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig"
  

DeleteGateway

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.gateways.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway"
  

GetApi

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.GetApi
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apis.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApi"
  

GetApiConfig

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apiconfigs.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig"
  

GetGateway

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.GetGateway
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.gateways.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetGateway"
  

ListApiConfigs

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apiconfigs.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs"
  

ListApis

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.ListApis
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apis.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApis"
  

ListGateways

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.ListGateways
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.gateways.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListGateways"
  

UpdateApi

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.UpdateApi
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apis.update - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateApi"
  

UpdateApiConfig

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.update - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig"
  

UpdateGateway

• Method:‏ google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.gateways.update - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway"
  

google.cloud.apigateway.v1beta.ApiGatewayService

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.cloud.apigateway.v1beta.ApiGatewayService.

CreateApi

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apis.create - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi"
  

CreateApiConfig

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.create - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig"
  

CreateGateway

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.gateways.create - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway"
  

DeleteApi

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apis.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi"
  

DeleteApiConfig

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig"
  

DeleteGateway

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.gateways.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway"
  

GetApi

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.GetApi
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apis.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApi"
  

GetApiConfig

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apiconfigs.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig"
  

GetGateway

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.gateways.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway"
  

ListApiConfigs

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.ListApiConfigs
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apiconfigs.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListApiConfigs"
  

ListApis

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.ListApis
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apis.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListApis"
  

ListGateways

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.ListGateways
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.gateways.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListGateways"
  

UpdateApi

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apis.update - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi"
  

UpdateApiConfig

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.update - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig"
  

UpdateGateway

• Method:‏ google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.gateways.update - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: פעולה ממושכת
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway"
  

google.iam.v1.IAMPolicy

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.iam.v1.IAMPolicy.

GetIamPolicy

• Method:‏ GetIamPolicy
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.apis.getIamPolicy - ADMIN_READ
  • apigateway.gateways.getIamPolicy - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="GetIamPolicy"
  

SetIamPolicy

• Method:‏ SetIamPolicy
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.apiconfigs.setIamPolicy - ADMIN_WRITE
  • apigateway.apis.setIamPolicy - ADMIN_WRITE
  • apigateway.gateways.setIamPolicy - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="SetIamPolicy"
  

google.longrunning.Operations

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.longrunning.Operations.

CancelOperation

• Method:‏ google.longrunning.Operations.CancelOperation
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.operations.cancel - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

DeleteOperation

• Method:‏ google.longrunning.Operations.DeleteOperation
  
• סוג יומן הביקורת: פעילות אדמין
  
• הרשאות:
  • apigateway.operations.delete - ADMIN_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.longrunning.Operations.DeleteOperation"
  

GetOperation

• Method:‏ google.longrunning.Operations.GetOperation
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.operations.get - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• Method:‏ google.longrunning.Operations.ListOperations
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • apigateway.operations.list - ADMIN_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

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

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

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

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

• google.cloud.location.Locations.GetLocation
• google.cloud.location.Locations.ListLocations
• google.longrunning.Operations.WaitOperation