רישום ביומן הביקורת של אנשי קשר חיוניים

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

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

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

שם השירות

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

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

   כניסה לדף Logs Explorer

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

       protoPayload.serviceName="essentialcontacts.googleapis.com"
     

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

לכל הרשאה ב-IAM יש מאפיין type עם enum שיכול להיות אחד מארבעת הערכים הבאים: ADMIN_READ,‏ ADMIN_WRITE,‏ DATA_READ או DATA_WRITE. כשקוראים ל-method, נוצר יומן ביקורת של Essential Contacts שהקטגוריה שלו תלויה במאפיין 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
DATA_READ	google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
DATA_WRITE	google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact

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

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

google.cloud.essentialcontacts.v1.EssentialContactsService

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

ComputeContacts

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

CreateContact

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

DeleteContact

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

GetContact

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

ListContacts

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

SendTestMessage

• Method:‏ google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.send - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage"
  

UpdateContact

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

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

יומני הביקורת הבאים משויכים ל-methods ששייכות ל-google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.

ComputeContacts

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.list - DATA_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"
  

CreateContact

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.create - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"
  

DeleteContact

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.delete - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"
  

GetContact

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.get - DATA_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"
  

ListContacts

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.list - DATA_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"
  

SendTestMessage

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.send - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"
  

UpdateContact

• Method:‏ google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.update - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"
  

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

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

ComputeContacts

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.get - DATA_READ
  • essentialcontacts.contacts.list - DATA_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"
  

CreateContact

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.create - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"
  

DeleteContact

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.delete - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"
  

GetContact

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.get - DATA_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact"
  

ListContacts

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.list - DATA_READ
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"
  

SendTestMessage

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.send - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"
  

UpdateContact

• Method:‏ google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  
• סוג יומן הביקורת: גישה לנתונים
  
• הרשאות:
  • essentialcontacts.contacts.update - DATA_WRITE
• ה-method היא פעולה ממושכת או פעולת סטרימינג: לא.
  
• סינון לפי ה-method: ‏ protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"
  

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

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

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

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

• google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ResendVerification
• google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.VerifyContact

יומני הביקורת Admin Activity לפעולות כתיבה

בנוסף ליומני הביקורת של גישה לנתונים (DATA_WRITE), שיטות הכתיבה הבאות של google.cloud.essentialcontacts.v1.EssentialContactsService יוצרות יומני ביקורת של פעילות אדמין (ADMIN_WRITE):

• google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
• google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
• google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
• google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage

יומני הביקורת Admin Activity מופעלים כברירת מחדל, ולא חלים עליהם חיובים על הטמעת נתונים ב-Cloud Logging.

אם מפעילים גם את בקרת הרשאות גישה לנתונים (DATA_WRITE) בשביל Essential Contacts, קריאה לארבע השיטות האלה יוצרת גם רשומה ביומן הביקורת של פעילות אדמין (cloudaudit.googleapis.com/activity) וגם רשומה ביומן הביקורת של Data Access‏ (cloudaudit.googleapis.com/data_access). אם מנתבים את יומני הביקורת לכיורי ייצוא או מגדירים התראות מבוססות-יומן, צריך לסנן לפי שם היומן או החשבון של שתי הרשומות ביומן כדי למנוע התראות כפולות או נפח הנתונים שמיוצאים לא צפוי.

שאילתות לדוגמה

כדי להציג את יומני הביקורת של פעילות אדמין לפעולות כתיבה של Essential Contacts, אתם יכולים להריץ את השאילתה לדוגמה הבאה ב-Logs Explorer:

תיאור השאילתה	ביטוי
יומני הביקורת Admin Activity לפעולות כתיבה של Essential Contacts	log_id("cloudaudit.googleapis.com/activity") protoPayload.serviceName="essentialcontacts.googleapis.com"