איסוף יומני Censys ASM
גרסת המנתח: 1.0
במסמך הזה מוסבר איך להטמיע יומני Censys ב-Google Security Operations באמצעות Cloud Storage V2.
Censys מספקת ניהול מקיף של שטחי מתקפה ומודיעין אינטרנט באמצעות ה-API שלה. השילוב הזה מאפשר לכם לאסוף אירועים של גילוי מארחים, אירועי סיכון ושינויים בנכסים מ-Censys ASM ולהעביר אותם ל-Google SecOps לצורך ניתוח ומעקב.
לפני שמתחילים
ודאו שאתם עומדים בדרישות המוקדמות הבאות:
- מכונה של Google SecOps
- פרויקט ב- Google Cloud עם Cloud Storage API מופעל
- הרשאות ליצירה ולניהול של קטגוריות של Cloud Storage
- הרשאות לניהול כללי מדיניות של ניהול זהויות והרשאות גישה (IAM) בקטגוריות של Cloud Storage
- הרשאות ליצירת שירותי Cloud Run, נושאי Pub/Sub ומשימות ב-Cloud Scheduler
- גישה מיוחדת ל-Censys ASM
איסוף פרטי הכניסה ל-Censys API
- נכנסים למסוף Censys ASM בכתובת app.censys.io.
- בחלק העליון של הדף, לוחצים על שילובים.
- מעתיקים ושומרים את מפתח ה-API ואת מזהה הארגון.
- שימו לב לכתובת ה-URL הבסיסית של ה-API:
https://api.platform.censys.io
יצירת קטגוריה של Cloud Storage
- נכנסים למסוףGoogle Cloud .
- בוחרים פרויקט או יוצרים פרויקט חדש.
- בתפריט הניווט, לוחצים על Cloud Storage > Buckets.
- לוחצים על Create bucket.
ממלאים את פרטי ההגדרה הבאים:
הגדרה ערך Name your bucket מזינים שם ייחודי גלובלי (לדוגמה, censys-logs)סוג המיקום בוחרים לפי הצרכים (אזור, שני אזורים, מספר אזורים) Location בוחרים את המיקום (לדוגמה, us-central1)סוג האחסון (storage class) רגיל (מומלץ ליומנים שהגישה אליהם תכופה) בקרת גישה אחיד (מומלץ) כלי הגנה אופציונלי: הפעלה של ניהול גרסאות של אובייקטים או מדיניות שמירת נתונים לוחצים על יצירה.
יצירת חשבון שירות לפונקציית Cloud Run
לפונקציית Cloud Run נדרש חשבון שירות עם הרשאות כתיבה בקטגוריה של Cloud Storage.
יצירת חשבון שירות
- במסוף Google Cloud , נכנסים לדף IAM & Admin > Service Accounts.
- לוחצים על Create Service Account.
- מזינים את פרטי ההגדרה הבאים:
- Service account name: מזינים
censys-data-collector-sa. - Service account description: מזינים
Service account for Cloud Run function to collect Censys logs.
- Service account name: מזינים
- לוחצים על יצירה והמשך.
- בקטע Grant this service account access to project, מוסיפים את התפקידים הבאים:
- לוחצים על בחירת תפקיד.
- מחפשים את התפקיד Storage Object Admin ובוחרים אותו.
- לוחצים על + הוספת תפקיד.
- מחפשים את התפקיד Cloud Run Invoker ובוחרים בו.
- לוחצים על + הוספת תפקיד.
- מחפשים את התפקיד Cloud Functions Invoker ובוחרים אותו.
- לוחצים על Continue.
- לוחצים על סיום.
התפקידים האלה נדרשים כדי:
- אדמין של אובייקטים באחסון: כתיבת יומנים בקטגוריה של Cloud Storage וניהול קובצי תמונת מצב
- Cloud Run Invoker: מאפשר ל-Pub/Sub להפעיל את הפונקציה.
- מפעיל פונקציות של Cloud Functions: מאפשר להפעיל פונקציות
הענקת הרשאות IAM בקטגוריה של Cloud Storage
נותנים לחשבון השירות הרשאות כתיבה בקטגוריה של Cloud Storage:
- נכנסים לדף Cloud Storage > Buckets.
- לוחצים על שם הקטגוריה.
- עוברים לכרטיסייה Permissions.
- לוחצים על הענקת גישה.
- מזינים את פרטי ההגדרה הבאים:
- הוספת חשבונות משתמשים: מזינים את כתובת האימייל של חשבון השירות (לדוגמה,
censys-data-collector-sa@PROJECT_ID.iam.gserviceaccount.com). - הקצאת תפקידים: בוחרים באפשרות אדמין של אובייקטים באחסון.
- הוספת חשבונות משתמשים: מזינים את כתובת האימייל של חשבון השירות (לדוגמה,
- לוחצים על Save.
יצירת נושא Pub/Sub
יוצרים נושא Pub/Sub ש-Cloud Scheduler יפרסם בו ופונקציית Cloud Run תירשם אליו.
- במסוף Google Cloud , נכנסים לדף Pub/Sub > Topics.
- לוחצים על Create topic.
- מזינים את פרטי ההגדרה הבאים:
- מזהה הנושא: מזינים
censys-data-trigger. - משאירים את שאר ההגדרות כברירת מחדל.
- מזהה הנושא: מזינים
- לוחצים על יצירה.
יצירת פונקציית Cloud Run לאיסוף יומנים
פונקציית Cloud Run מופעלת על ידי הודעות Pub/Sub מ-Cloud Scheduler כדי לאחזר יומנים מ-Censys ASM API ולכתוב אותם ב-Cloud Storage.
- נכנסים לדף Cloud Run במסוף Google Cloud .
- לוחצים על Create service.
- בוחרים באפשרות Function (שימוש בעורך ישיר כדי ליצור פונקציה).
בקטע Configure, מזינים את פרטי ההגדרה הבאים:
הגדרה ערך שם השירות censys-data-collectorאזור בוחרים את האזור שתואם לקטגוריה של Cloud Storage (לדוגמה, us-central1)זמן ריצה בוחרים באפשרות Python 3.12 ואילך. בקטע טריגר (אופציונלי):
- לוחצים על + הוספת טריגר.
- בוחרים באפשרות Cloud Pub/Sub.
- בקטע Select a Cloud Pub/Sub topic, בוחרים את הנושא ב-Pub/Sub (
censys-data-trigger). - לוחצים על Save.
בקטע Authentication:
- לוחצים על דרישת אימות.
- בודקים את ניהול הזהויות והרשאות הגישה (IAM).
- גוללים למטה ומרחיבים את Containers, Networking, Security.
- עוברים לכרטיסייה אבטחה:
- חשבון שירות: בוחרים את חשבון השירות (
censys-data-collector-sa).
- חשבון שירות: בוחרים את חשבון השירות (
עוברים לכרטיסייה Containers:
- לוחצים על Variables & Secrets.
לוחצים על + Add variable לכל משתנה סביבה:
שם משתנה ערך לדוגמה GCS_BUCKETcensys-logsGCS_PREFIXcensys/STATE_KEYcensys/state.jsonCENSYS_API_KEYyour-censys-api-keyCENSYS_ORG_IDyour-organization-idAPI_BASEhttps://api.platform.censys.io
גוללים למטה בכרטיסייה Variables & Secrets (משתנים וסודות) עד שמגיעים לקטע Requests (בקשות):
- Request timeout: מזינים
600שניות (10 דקות).
- Request timeout: מזינים
עוברים לכרטיסייה הגדרות בקטע מאגרים:
- בקטע Resources:
- Memory: בוחרים באפשרות 512 MiB או יותר.
- מעבד (CPU): בוחרים באפשרות 1.
- לוחצים על סיום.
- בקטע Resources:
גוללים אל Execution environment:
- בוחרים באפשרות ברירת מחדל (מומלץ).
בקטע Revision scaling:
- מספר מינימלי של מכונות: מזינים
0. - Maximum number of instances: מזינים
100(או משנים בהתאם לעומס הצפוי).
- מספר מינימלי של מכונות: מזינים
לוחצים על יצירה.
ממתינים ליצירת השירות (דקה או שתיים).
אחרי שיוצרים את השירות, עורך הקוד המוטבע נפתח באופן אוטומטי.
הוספת קוד פונקציה
- מזינים main בשדה Function entry point.
בכלי לעריכת קוד, יוצרים שני קבצים:
- הקובץ הראשון: main.py:
import functions_framework from google.cloud import storage import json import urllib3 import gzip import os from datetime import datetime, timedelta, timezone from typing import Dict, List, Any, Optional from urllib.parse import urlencode # Initialize HTTP client with timeouts http = urllib3.PoolManager( timeout=urllib3.Timeout(connect=5.0, read=30.0), retries=False, ) # Initialize Storage client storage_client = storage.Client() @functions_framework.cloud_event def main(cloud_event): """ Cloud Run function triggered by Pub/Sub to fetch logs from Censys ASM API and write to GCS. Args: cloud_event: CloudEvent object containing Pub/Sub message """ # Get environment variables bucket_name = os.environ.get('GCS_BUCKET') prefix = os.environ.get('GCS_PREFIX', 'censys/') state_key = os.environ.get('STATE_KEY', 'censys/state.json') censys_api_key = os.environ.get('CENSYS_API_KEY') censys_org_id = os.environ.get('CENSYS_ORG_ID') api_base = os.environ.get('API_BASE', 'https://api.platform.censys.io') if not all([bucket_name, censys_api_key, censys_org_id]): print('Error: Missing required environment variables') return try: collector = CensysCollector( bucket_name=bucket_name, prefix=prefix, state_key=state_key, api_key=censys_api_key, org_id=censys_org_id, api_base=api_base ) # Get last collection time last_collection_time = collector.get_last_collection_time() current_time = datetime.now(timezone.utc) print(f'Collecting events since {last_collection_time}') # Collect different types of events logbook_events = collector.collect_logbook_events() risk_events = collector.collect_risks_events() # Save events to GCS collector.save_events_to_gcs(logbook_events, 'logbook') collector.save_events_to_gcs(risk_events, 'risks') # Update state collector.save_collection_time(current_time) print(f'Successfully processed {len(logbook_events)} logbook events and {len(risk_events)} risk events') except Exception as e: print(f'Error processing logs: {str(e)}') raise class CensysCollector: def __init__(self, bucket_name: str, prefix: str, state_key: str, api_key: str, org_id: str, api_base: str): self.bucket_name = bucket_name self.prefix = prefix self.state_key = state_key self.headers = { 'Authorization': f'Bearer {api_key}', 'X-Organization-ID': org_id, 'Content-Type': 'application/json' } self.api_base = api_base self.bucket = storage_client.bucket(bucket_name) def get_last_collection_time(self) -> Optional[datetime]: """Get the last collection timestamp from GCS state file.""" try: blob = self.bucket.blob(self.state_key) if blob.exists(): state_data = blob.download_as_text() state = json.loads(state_data) return datetime.fromisoformat(state.get('last_collection_time', '2024-01-01T00:00:00Z')) except Exception as e: print(f'No state file found or error reading state: {e}') return datetime.now(timezone.utc) - timedelta(hours=1) def save_collection_time(self, collection_time: datetime): """Save the current collection timestamp to GCS state file.""" state = {'last_collection_time': collection_time.strftime('%Y-%m-%dT%H:%M:%SZ')} blob = self.bucket.blob(self.state_key) blob.upload_from_string( json.dumps(state), content_type='application/json' ) def collect_logbook_events(self, cursor: str = None) -> List[Dict[str, Any]]: """Collect logbook events from Censys ASM API using cursor-based pagination.""" events = [] url = f"{self.api_base}/v3/logbook" params = {} if cursor: params['cursor'] = cursor try: query_string = urlencode(params) if params else '' full_url = f"{url}?{query_string}" if query_string else url response = http.request('GET', full_url, headers=self.headers) # Handle rate limiting with exponential backoff if response.status == 429: retry_after = int(response.headers.get('Retry-After', '60')) print(f'Rate limited (429). Retrying after {retry_after}s...') import time time.sleep(retry_after) return self.collect_logbook_events(cursor) if response.status != 200: print(f'API request failed with status {response.status}: {response.data}') return [] data = json.loads(response.data.decode('utf-8')) events.extend(data.get('logbook_entries', [])) # Handle cursor-based pagination next_cursor = data.get('next_cursor') if next_cursor: events.extend(self.collect_logbook_events(next_cursor)) print(f'Collected {len(events)} logbook events') return events except Exception as e: print(f'Error collecting logbook events: {e}') return [] def collect_risks_events(self) -> List[Dict[str, Any]]: """Collect risk events from Censys ASM API.""" events = [] url = f"{self.api_base}/v3/risks" try: response = http.request('GET', url, headers=self.headers) # Handle rate limiting with exponential backoff if response.status == 429: retry_after = int(response.headers.get('Retry-After', '60')) print(f'Rate limited (429). Retrying after {retry_after}s...') import time time.sleep(retry_after) return self.collect_risks_events() if response.status != 200: print(f'API request failed with status {response.status}: {response.data}') return [] data = json.loads(response.data.decode('utf-8')) events.extend(data.get('risks', [])) print(f'Collected {len(events)} risk events') return events except Exception as e: print(f'Error collecting risk events: {e}') return [] def save_events_to_gcs(self, events: List[Dict[str, Any]], event_type: str): """Save events to GCS in compressed NDJSON format.""" if not events: return timestamp = datetime.now(timezone.utc).strftime('%Y%m%d_%H%M%S') filename = f"{self.prefix}{event_type}_{timestamp}.json.gz" try: # Convert events to newline-delimited JSON ndjson_content = '\n'.join(json.dumps(event, separators=(',', ':')) for event in events) # Compress with gzip gz_bytes = gzip.compress(ndjson_content.encode('utf-8')) blob = self.bucket.blob(filename) blob.upload_from_string( gz_bytes, content_type='application/gzip' ) print(f'Saved {len(events)} {event_type} events to {filename}') except Exception as e: print(f'Error saving {event_type} events to GCS: {e}') raise- הקובץ השני: requirements.txt:
functions-framework==3.* google-cloud-storage==2.* urllib3>=2.0.0לוחצים על Deploy כדי לשמור ולפרוס את הפונקציה.
מחכים שהפריסה תסתיים (2-3 דקות).
יצירת משימה ב-Cloud Scheduler
Cloud Scheduler מפרסם הודעות בנושא Pub/Sub במרווחי זמן קבועים, ומפעיל את פונקציית Cloud Run.
- במסוף Google Cloud , נכנסים לדף Cloud Scheduler.
- לוחצים על Create Job.
ממלאים את פרטי ההגדרה הבאים:
הגדרה ערך שם censys-data-collector-hourlyאזור בוחרים את אותו אזור כמו של פונקציית Cloud Run. תדירות 0 * * * *(כל שעה, בשעה עגולה)אזור זמן בחירת אזור זמן (מומלץ לבחור ב-UTC) סוג היעד Pub/Sub נושא בוחרים את נושא Pub/Sub ( censys-data-trigger)גוף ההודעה {}(אובייקט JSON ריק)לוחצים על יצירה.
אפשרויות לתדירות התזמון
בוחרים את התדירות בהתאם לנפח היומן ולדרישות לגבי זמן האחזור:
תדירות ביטוי Cron תרחיש לדוגמה כל 5 דקות */5 * * * *נפח גבוה, זמן אחזור נמוך כל 15 דקות */15 * * * *נפח חיפושים בינוני כל שעה 0 * * * *רגיל (מומלץ) כל 6 שעות 0 */6 * * *נפח נמוך, עיבוד באצווה יומי 0 0 * * *איסוף נתונים היסטוריים
בדיקת השילוב
- במסוף Cloud Scheduler, מוצאים את המשימה.
- לוחצים על Force run כדי להפעיל את המשימה באופן ידני.
- מחכים כמה שניות.
- עוברים אל Cloud Run > Services.
- לוחצים על שם הפונקציה (
censys-data-collector). - לוחצים על הכרטיסייה Logs.
מוודאים שהפונקציה בוצעה בהצלחה. מחפשים את הדברים הבאים:
Collecting events since YYYY-MM-DDTHH:MM:SS+00:00 Collected X logbook events Collected X risk events Saved X logbook events to censys/logbook_YYYYMMDD_HHMMSS.json.gz Saved X risks events to censys/risks_YYYYMMDD_HHMMSS.json.gz Successfully processed X logbook events and X risk eventsנכנסים לדף Cloud Storage > Buckets.
לוחצים על שם הקטגוריה.
עוברים לתיקיית הקידומת (
censys/).מוודאים שנוצרו קובצי
.json.gzחדשים עם חותמת הזמן הנוכחית.
אם מופיעות שגיאות ביומנים:
- HTTP 401: בודקים את פרטי הכניסה ל-API במשתני הסביבה
- HTTP 403: מוודאים שלחשבון יש את ההרשאות הנדרשות
- HTTP 429: הגבלת קצב של יצירת בקשות – הפונקציה תנסה שוב באופן אוטומטי עם השהיה (backoff)
- חסרים משתני סביבה: צריך לוודא שכל המשתנים הנדרשים מוגדרים.
אחזור של חשבון השירות של Google SecOps
מערכת Google SecOps משתמשת בחשבון שירות ייחודי כדי לקרוא נתונים מהקטגוריה של Cloud Storage. אתם צריכים לתת לחשבון השירות הזה גישה לקטגוריה שלכם.
איך מקבלים את כתובת האימייל של חשבון השירות
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Censys logs). - בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
- בוחרים באפשרות CENSYS בתור Log type.
- לוחצים על Get Service Account (קבלת חשבון שירות).
תוצג כתובת אימייל ייחודית של חשבון שירות, לדוגמה:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comמעתיקים את כתובת האימייל הזו כדי להשתמש בה בשלב הבא.
הקצאת הרשאות IAM לחשבון השירות של Google SecOps
לחשבון השירות של Google SecOps צריך להיות התפקיד צפייה באובייקט אחסון בקטגוריה של Cloud Storage.
- נכנסים לדף Cloud Storage > Buckets.
- לוחצים על שם הקטגוריה.
- עוברים לכרטיסייה Permissions.
- לוחצים על הענקת גישה.
- מזינים את פרטי ההגדרה הבאים:
- Add principals: מדביקים את כתובת האימייל של חשבון השירות של Google SecOps.
- הקצאת תפקידים: בוחרים באפשרות צפייה באובייקטים באחסון.
- לוחצים על Save.
הגדרת פיד ב-Google SecOps כדי להטמיע יומני Censys
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Censys logs). - בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
- בוחרים באפשרות CENSYS בתור Log type.
- לוחצים על הבא.
מציינים ערכים לפרמטרים הבאים של הקלט:
כתובת ה-URL של קטגוריה של Cloud Storage: מזינים את ה-URI של קטגוריה של Cloud Storage עם נתיב הקידומת:
gs://censys-logs/censys/מחליפים את:
-
censys-logs: השם של הקטגוריה ב-Cloud Storage. -
censys/: נתיב אופציונלי לקידומת או לתיקייה שבהם מאוחסנים היומנים (משאירים ריק בשביל תיקיית הבסיס).
-
לדוגמה:
- קטגוריית הבסיס:
gs://censys-logs/ - עם הקידומת:
gs://censys-logs/censys/
- קטגוריית הבסיס:
אפשרות מחיקת המקור: בוחרים את אפשרות המחיקה המועדפת:
- אף פעם: לא מוחק קבצים אחרי העברות (מומלץ לבדיקה).
- מחיקת קבצים שהועברו: מחיקת קבצים אחרי שהועברו בהצלחה.
מחיקת קבצים שהועברו וספריות ריקות: מחיקת קבצים וספריות ריקות אחרי העברה מוצלחת.
גיל הקובץ המקסימלי: כולל קבצים ששונו במספר הימים האחרונים. ברירת המחדל היא 180 ימים.
מרחב השמות של הנכס: מרחב השמות של הנכס.
תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
לוחצים על הבא.
בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | היגיון |
|---|---|---|
| assetId | read_only_udm.principal.asset.hostname | אם השדה assetId הוא לא כתובת IP, הוא ממופה ל-principal.asset.hostname. |
| assetId | read_only_udm.principal.asset.ip | אם השדה assetId הוא כתובת IP, הוא ממופה ל-principal.asset.ip. |
| assetId | read_only_udm.principal.hostname | אם השדה assetId הוא לא כתובת IP, הוא ממופה ל-principal.hostname. |
| assetId | read_only_udm.principal.ip | אם השדה assetId הוא כתובת IP, הוא ממופה ל-principal.ip. |
| associatedAt | read_only_udm.security_result.detection_fields.value | השדה associatedAt ממופה ל-security_result.detection_fields.value. |
| autonomousSystem.asn | read_only_udm.additional.fields.value.string_value | השדה autonomousSystem.asn מומר למחרוזת וממופה ל-additional.fields.value.string_value עם המפתח autonomousSystem_asn. |
| autonomousSystem.bgpPrefix | read_only_udm.additional.fields.value.string_value | השדה autonomousSystem.bgpPrefix ממופה ל-additional.fields.value.string_value עם המפתח autonomousSystem_bgpPrefix. |
| באנר | read_only_udm.principal.resource.attribute.labels.value | השדה banner ממופה ל-principal.resource.attribute.labels.value עם המפתח "banner". |
| ענן, קלאוד | read_only_udm.metadata.vendor_name | השדה בענן ממופה ל-metadata.vendor_name. |
| comments.refUrl | read_only_udm.network.http.referral_url | השדה comments.refUrl ממופה ל-network.http.referral_url. |
| data.cve | read_only_udm.additional.fields.value.string_value | השדה data.cve ממופה ל-additional.fields.value.string_value עם המפתח "data_cve". |
| data.cvss | read_only_udm.additional.fields.value.string_value | השדה data.cvss ממופה ל-additional.fields.value.string_value עם המפתח "data_cvss". |
| data.ipAddress | read_only_udm.principal.asset.ip | אם השדה data.ipAddress לא שווה לשדה assetId, הוא ממופה ל-principal.asset.ip. |
| data.ipAddress | read_only_udm.principal.ip | אם השדה data.ipAddress לא שווה לשדה assetId, הוא ממופה ל-principal.ip. |
| data.location.city | read_only_udm.principal.location.city | אם השדה location.city ריק, השדה data.location.city ממופה ל-principal.location.city. |
| data.location.countryCode | read_only_udm.principal.location.country_or_region | אם השדה location.country ריק, השדה data.location.countryCode ממופה ל-principal.location.country_or_region. |
| data.location.latitude | read_only_udm.principal.location.region_coordinates.latitude | אם השדות location.coordinates.latitude ו-location.geoCoordinates.latitude ריקים, השדה data.location.latitude מומר ל-float וממופה ל-principal.location.region_coordinates.latitude. |
| data.location.longitude | read_only_udm.principal.location.region_coordinates.longitude | אם השדות location.coordinates.longitude ו-location.geoCoordinates.longitude ריקים, השדה data.location.longitude מומר ל-float וממופה ל-principal.location.region_coordinates.longitude. |
| data.location.province | read_only_udm.principal.location.state | אם השדה location.province ריק, השדה data.location.province ממופה ל-principal.location.state. |
| data.mailServers | read_only_udm.additional.fields.value.list_value.values.string_value | כל רכיב במערך data.mailServers ממופה לרשומה נפרדת של additional.fields עם המפתח "Mail Servers" ו-value.list_value.values.string_value שמוגדר לערך הרכיב. |
| data.names.forwardDns[].name | read_only_udm.network.dns.questions.name | כל רכיב במערך data.names.forwardDns ממופה לרשומה נפרדת של network.dns.questions, כאשר שדה השם מוגדר לשדה השם של הרכיב. |
| data.nameServers | read_only_udm.additional.fields.value.list_value.values.string_value | כל רכיב במערך data.nameServers ממופה לרשומה נפרדת של additional.fields עם המפתח "Name nameServers" ו-value.list_value.values.string_value שמוגדר לערך הרכיב. |
| data.protocols[].transportProtocol | read_only_udm.network.ip_protocol | אם השדה data.protocols[].transportProtocol הוא אחד מהבאים: TCP, EIGRP, ESP, ETHERIP, GRE, ICMP, IGMP, IP6IN4, PIM, UDP או VRRP, הוא ממופה ל-network.ip_protocol. |
| data.protocols[].transportProtocol | read_only_udm.principal.resource.attribute.labels.value | השדה data.protocols[].transportProtocol ממופה ל-principal.resource.attribute.labels.value עם המפתח "data_protocols {index}". |
| http.request.headers[].key, http.request.headers[].value.headers.0 | read_only_udm.network.http.user_agent | אם השדה http.request.headers[].key הוא "User-Agent", השדה התואם http.request.headers[].value.headers.0 ממופה ל-network.http.user_agent. |
| http.request.headers[].key, http.request.headers[].value.headers.0 | read_only_udm.network.http.parsed_user_agent | אם השדה http.request.headers[].key הוא "User-Agent", השדה התואם http.request.headers[].value.headers.0 מנותח כמחרוזת של סוכן משתמש וממופה ל-network.http.parsed_user_agent. |
| http.request.headers[].key, http.request.headers[].value.headers.0 | read_only_udm.principal.resource.attribute.labels.key, read_only_udm.principal.resource.attribute.labels.value | לכל רכיב במערך http.request.headers, השדה key ממופה ל-principal.resource.attribute.labels.key והשדה value.headers.0 ממופה ל-principal.resource.attribute.labels.value. |
| http.request.uri | read_only_udm.principal.asset.hostname | החלק של שם המארח בשדה http.request.uri נשלף וממופה ל-principal.asset.hostname. |
| http.request.uri | read_only_udm.principal.hostname | החלק של שם המארח בשדה http.request.uri מחולץ וממופה ל-principal.hostname. |
| http.response.body | read_only_udm.principal.resource.attribute.labels.value | השדה http.response.body ממופה ל-principal.resource.attribute.labels.value עם המפתח "http_response_body". |
| http.response.headers[].key, http.response.headers[].value.headers.0 | read_only_udm.target.hostname | אם השדה http.response.headers[].key הוא "Server", השדה התואם http.response.headers[].value.headers.0 ממופה ל-target.hostname. |
| http.response.headers[].key, http.response.headers[].value.headers.0 | read_only_udm.principal.resource.attribute.labels.key, read_only_udm.principal.resource.attribute.labels.value | לכל רכיב במערך http.response.headers, השדה key ממופה ל-principal.resource.attribute.labels.key והשדה value.headers.0 ממופה ל-principal.resource.attribute.labels.value. |
| http.response.statusCode | read_only_udm.network.http.response_code | השדה http.response.statusCode מומר למספר שלם וממופה ל-network.http.response_code. |
| ip | read_only_udm.target.asset.ip | השדה ip ממופה ל-target.asset.ip. |
| ip | read_only_udm.target.ip | השדה ip ממופה ל-target.ip. |
| isSeed | read_only_udm.additional.fields.value.string_value | השדה isSeed מומר למחרוזת וממופה ל-additional.fields.value.string_value עם המפתח "isSeed". |
| location.city | read_only_udm.principal.location.city | השדה location.city ממופה ל-principal.location.city. |
| location.continent | read_only_udm.additional.fields.value.string_value | השדה location.continent ממופה אל additional.fields.value.string_value עם המפתח "location_continent". |
| location.coordinates.latitude | read_only_udm.principal.location.region_coordinates.latitude | השדה location.coordinates.latitude מומר ל-float וממופה ל-principal.location.region_coordinates.latitude. |
| location.coordinates.longitude | read_only_udm.principal.location.region_coordinates.longitude | השדה location.coordinates.longitude מומר ל-float וממופה ל-principal.location.region_coordinates.longitude. |
| location.country | read_only_udm.principal.location.country_or_region | השדה location.country ממופה ל-principal.location.country_or_region. |
| location.geoCoordinates.latitude | read_only_udm.principal.location.region_coordinates.latitude | אם השדה location.coordinates.latitude ריק, השדה location.geoCoordinates.latitude מומר ל-float וממופה ל-principal.location.region_coordinates.latitude. |
| location.geoCoordinates.longitude | read_only_udm.principal.location.region_coordinates.longitude | אם השדה location.coordinates.longitude ריק, השדה location.geoCoordinates.longitude מומר ל-float וממופה ל-principal.location.region_coordinates.longitude. |
| location.postalCode | read_only_udm.additional.fields.value.string_value | השדה location.postalCode ממופה ל-additional.fields.value.string_value עם המפתח "Postal code". |
| location.province | read_only_udm.principal.location.state | השדה location.province ממופה לשדה principal.location.state. |
| פעולה | read_only_udm.security_result.action_details | השדה operation ממופה ל-security_result.action_details. |
| perspectiveId | read_only_udm.principal.group.product_object_id | השדה perspectiveId ממופה ל-principal.group.product_object_id. |
| יציאה | read_only_udm.principal.port | השדה port מומר למספר שלם וממופה ל-principal.port. |
| risks[].severity, risks[].title | read_only_udm.security_result.category_details | השדה risks[].severity משורשר עם השדה risks[].title וממופה ל-security_result.category_details. |
| serviceName | read_only_udm.network.application_protocol | אם השדה serviceName הוא "HTTP" או "HTTPS", הוא ממופה ל-network.application_protocol. |
| sourceIp | read_only_udm.principal.asset.ip | השדה sourceIp ממופה ל-principal.asset.ip. |
| sourceIp | read_only_udm.principal.ip | השדה sourceIp ממופה ל-principal.ip. |
| חותמת זמן | read_only_udm.metadata.event_timestamp | השדה של חותמת הזמן מנותח כחותמת זמן וממופה ל-metadata.event_timestamp. |
| transportFingerprint.id | read_only_udm.metadata.product_log_id | השדה transportFingerprint.id מומר למחרוזת וממופה ל-metadata.product_log_id. |
| transportFingerprint.raw | read_only_udm.additional.fields.value.string_value | השדה transportFingerprint.raw ממופה ל-additional.fields.value.string_value עם המפתח "transportFingerprint_raw". |
| סוג | read_only_udm.metadata.product_event_type | השדה type ממופה ל-metadata.product_event_type. |
| - | read_only_udm.metadata.product_name | הערך "CENSYS_ASM" מוקצה ל-metadata.product_name. |
| - | read_only_udm.metadata.vendor_name | הערך "CENSYS" מוקצה ל-metadata.vendor_name. |
| - | read_only_udm.metadata.event_type | סוג האירוע נקבע על סמך הנוכחות של שדות ספציפיים: NETWORK_CONNECTION אם has_princ_machine_id ו-has_target_machine הם true ו-has_network_flow הוא false, NETWORK_DNS אם has_network_flow הוא true, STATUS_UPDATE אם has_princ_machine_id הוא true, ו-GENERIC_EVENT אחרת. |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.