איסוף יומני ביקורת של HashiCorp Vault
במאמר הזה מוסבר איך להטמיע יומני ביקורת של HashiCorp Vault ב-Google Security Operations באמצעות Bindplane.
HashiCorp Vault היא פלטפורמה לניהול סודות ולהגנה על נתונים, שמספקת אחסון מאובטח, יצירת סודות דינמיים, הצפנת נתונים ובקרת גישה שמבוססת על זהות. Vault יוצר יומני ביקורת שמתעדים את כל הבקשות והתגובות ל-Vault, כולל אימות, גישה לסודות ושינויים במדיניות. אפשר להעביר את יומני הביקורת האלה באמצעות syslog ל-SIEM לצורך ניטור לצורכי אבטחה ותאימות.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מופע של Google SecOps.
- Windows Server 2016 ואילך, או מארח Linux עם
systemd. - קישוריות רשת בין סוכן Bindplane לבין שרת HashiCorp Vault.
- אם אתם מפעילים את הסוכן מאחורי שרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- גישה עם הרשאות לשרת HashiCorp Vault (אסימון בסיס או הרשאות מדיניות מספיקות כדי להפעיל מכשירי ביקורת).
קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane
כדי לאמת את סוכן Bindplane ב-Google SecOps, בוחרים באחת מהשיטות הבאות:
- פריסות חדשות: משתמשים ב-Chronicle API (אפשרות 1).
- פריסות קודמות: ממשיכים להשתמש בקובץ האימות להטמעת נתונים (אפשרות 2) עד שה-Ingestion API יופסק ב-20 ביולי 2027.
אפשרות 1: יצירת חשבון שירות ל-Chronicle API (מומלץ)
- נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
- נכנסים לדף IAM & Admin > Service Accounts.
- לוחצים על Create service account.
- מזינים את פרטי ההגדרה הבאים:
- Service account name: מזינים שם לחשבון (לדוגמה,
bindplane-ingest). - Service account description: מזינים תיאור (לדוגמה,
Bindplane agent log ingestion).
- Service account name: מזינים שם לחשבון (לדוגמה,
- לוחצים על Create and continue.
- בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
- לוחצים על המשך ואז על סיום.
- לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
- לוחצים על Add key > Create new key.
- בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
- שומרים את קובץ המפתח בתור
ingestion-auth.jsonבספריית Bindplane collector (/opt/observiq-otel-collector/ingestion-auth.jsonב-Linux אוC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonב-Windows), או מעדכנים אתcreds_file_pathב-config.yamlכך שיתאים לנתיב שבו שמרתם אותו. - עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.
אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)
- נכנסים למסוף Google SecOps.
- עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
- מורידים את קובץ האימות להטמעת נתונים.
- שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.
איך מקבלים את מספר הלקוח ב-Google SecOps
- נכנסים למסוף Google SecOps.
- עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
- מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.
התקנת הסוכן של Bindplane
מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows או Linux לפי ההוראות הבאות.
התקנת חלונות
- פותחים את שורת הפקודה או את PowerShell כאדמין.
מריצים את הפקודה הבאה:
msiexec /i "[https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quietמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sc query observiq-otel-collector
השירות אמור להופיע כ-RUNNING.
התקנה ב-Linux
- פותחים טרמינל עם הרשאות root או sudo.
מריצים את הפקודה הבאה:
sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.shמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sudo systemctl status observiq-otel-collector
השירות אמור להופיע כפעיל (פועל).
מקורות מידע נוספים בנושא התקנה
לאפשרויות התקנה נוספות ולפתרון בעיות, עיינו במדריך להתקנת סוכן Bindplane.
הגדרת סוכן Bindplane להטמעת syslog ושליחה אל Google SecOps
מאתרים את קובץ התצורה
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
עריכת קובץ התצורה
מחליפים את כל התוכן של
config.yamlבהגדרות הבאות:receivers: tcplog: listen_address: "0.0.0.0:1514" exporters: chronicle/vault: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'your-customer-id-here' endpoint: chronicle.googleapis.com log_type: HASHICORP raw_log_field: body ingestion_labels: env: production service: pipelines: logs/vault_to_chronicle: receivers: - tcplog exporters: - chronicle/vault
פרמטרים להגדרה
מחליפים את ה-placeholders הבאים:
הגדרת המקלט:
-
listen_address: כתובת ה-IP והיציאה להאזנה. כדי להאזין בכל הממשקים, צריך להשתמש ב-0.0.0.0. מומלץ להשתמש ביציאה1514כדי להימנע מהצורך בהרשאות ברמה הבסיסית (root) ב-Linux.
-
הגדרת הייצוא:
-
creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
-
customer_id: מספר הלקוח ב-Google SecOps. -
location: מחליפים את<LOCATION>באזור של המכונה של Google SecOps (לדוגמה,us,europeאוasia-southeast1). המייצא מוסיף את הערך הזה בתחילתchronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות. -
project: מחליפים את<PROJECT_NUMBER>במספר הפרויקט שמופיע בקטע IAM & Admin > Settings. -
endpoint: משאירים את הערךchronicle.googleapis.com. -
ingestion_labels: תוויות אופציונליות בפורמט YAML (לדוגמה,env: production).
-
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcreds_file_pathלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים אתmalachiteingestion-pa.googleapis.comבנקודת הקצה האזורית (לדוגמה,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/vault: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'your-customer-id-here' endpoint: malachiteingestion-pa.googleapis.com log_type: HASHICORP raw_log_field: body ingestion_labels: env: production
שמירת קובץ התצורה
אחרי העריכה, שומרים את הקובץ:
- Linux: לוחצים על
Ctrl+O, אחר כך עלEnterואז עלCtrl+X - Windows: לוחצים על קובץ > שמירה
מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.
כדי להפעיל מחדש את סוכן Bindplane ב-Linux:
מריצים את הפקודה הבאה:
sudo systemctl restart observiq-otel-collectorמוודאים שהשירות פועל:
sudo systemctl status observiq-otel-collectorבודקים אם יש שגיאות ביומנים:
sudo journalctl -u observiq-otel-collector -f
כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows:
בוחרים אחת מהאפשרויות האלה:
- שורת הפקודה או PowerShell כאדמין:
net stop observiq-otel-collector && net start observiq-otel-collector- מסוף השירותים:
- לוחצים על
Win+R, מקלידיםservices.mscולוחצים על Enter. - מאתרים את observIQ OpenTelemetry Collector.
- לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
- לוחצים על
מוודאים שהשירות פועל:
sc query observiq-otel-collectorבודקים אם יש שגיאות ביומנים:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
הגדרת העברה של יומן הביקורת של HashiCorp Vault באמצעות syslog
מכשירי הביקורת של Vault מתעדים את כל הבקשות והתגובות. אתם יכולים להפעיל מכשיר ביקורת של syslog כדי להעביר את יומני הביקורת לסוכן Bindplane.
הפעלת מכשיר ביקורת של syslog
- פותחים טרמינל עם גישה ל-Vault CLI ואסימון Vault תקין.
מריצים את הפקודה הבאה כדי להפעיל את מכשיר הביקורת של syslog:
vault audit enable syslog tag="vault" facility="AUTH"מוודאים שהמכשיר לביקורת מופעל:
vault audit list
בפלט, התקן הביקורת של syslog אמור להופיע כ-enabled.
הגדרת העברת syslog לסוכן Bindplane
אחרי שמפעילים את מכשיר הביקורת של Vault syslog, מגדירים את ה-daemon של ה-syslog במערכת (rsyslog או syslog-ng) כדי להעביר את יומני הביקורת של Vault לסוכן Bindplane.
אפשרות – הגדרת rsyslog
יוצרים קובץ תצורה חדש של rsyslog:
sudo nano /etc/rsyslog.d/50-vault-forward.confמוסיפים את ההגדרות הבאות:
# Forward Vault audit logs to Bindplane agent if $programname == 'vault' then @@BINDPLANE_IP:1514מחליפים את
BINDPLANE_IPבכתובת ה-IP של המארח של סוכן Bindplane.מפעילים מחדש את rsyslog:
sudo systemctl restart rsyslog
אפשרות – הגדרת syslog-ng
עורכים את קובץ התצורה של syslog-ng:
sudo nano /etc/syslog-ng/conf.d/vault-forward.confמוסיפים את ההגדרות הבאות:
destination d_bindplane { network("BINDPLANE_IP" port(1514) transport("tcp")); }; filter f_vault { program("vault"); }; log { source(s_src); filter(f_vault); destination(d_bindplane); };מחליפים את
BINDPLANE_IPבכתובת ה-IP של המארח של סוכן Bindplane.מפעילים מחדש את syslog-ng:
sudo systemctl restart syslog-ng
חלופה – ביקורת מבוססת-קובץ עם מעביר יומנים
אם אתם לא רוצים להשתמש בביקורת של syslog, אתם יכולים להפעיל מכשיר לביקורת קבצים ולהעביר את תוכן הקובץ:
הפעלת מכשיר לביקורת קבצים:
vault audit enable file file_path=/var/log/vault/audit.logמגדירים את rsyslog למעקב אחרי הקובץ ולהעברה שלו:
sudo nano /etc/rsyslog.d/50-vault-file-forward.confmodule(load="imfile") input(type="imfile" File="/var/log/vault/audit.log" Tag="vault-audit" Severity="info" Facility="auth") if $syslogtag == 'vault-audit' then @@BINDPLANE_IP:1514מחליפים את
BINDPLANE_IPבכתובת ה-IP של המארח של סוכן Bindplane.מפעילים מחדש את rsyslog:
sudo systemctl restart rsyslog
אימות העברת היומנים
מבצעים פעולה ב-Vault (לדוגמה, התחברות או קריאת סוד):
vault login token=<YOUR_TOKEN>בודקים את יומני הסוכן של Bindplane כדי לוודא שהיומנים מתקבלים.
מידע נוסף זמין במסמכי התיעוד של מכשירי הביקורת של HashiCorp Vault.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
auth.client_token |
network.session_id |
הערך נלקח מ-auth.client_token (מגובב). |
auth.display_name |
principal.user.user_display_name |
הערך נלקח מ-auth.display_name. |
auth.metadata.role_name |
principal.user.attribute.roles.name |
הערך נלקח מ-auth.metadata.role_name. |
auth.policies |
principal.user.attribute.permissions.name |
הערכים נלקחו מהמערך auth.policies. |
auth.token_type |
additional.fields |
הערך נלקח מ-auth.token_type ונוסף עם המפתח token_type. |
request.id |
metadata.product_log_id |
הערך נלקח מ-request.id. |
request.operation |
metadata.product_event_type |
הערך נלקח מ-request.operation. |
request.path |
target.resource.name |
הערך נלקח מ-request.path. |
request.remote_address |
principal.ip |
הערך נלקח מ-request.remote_address. |
request.namespace.id |
target.namespace |
הערך נלקח מ-request.namespace.id. |
response.auth.client_token |
network.session_id |
הערך נלקח מהתשובה client_token (מגובב). |
type |
metadata.product_event_type |
מצורף לפעולה (לדוגמה, request או response). |
time |
metadata.event_timestamp |
מנותח כחותמת זמן מסוג RFC 3339. |
error |
security_result.description |
הערך נלקח מהשדה error אם הוא קיים. |
metadata.vendor_name |
מגדירים את האפשרות HashiCorp. | |
metadata.product_name |
מגדירים את האפשרות Vault. | |
metadata.event_type |
מגדירים את הערך USER_RESOURCE_ACCESS לפעולות סודיות, את הערך USER_LOGIN לפעולות אימות, ואת הערך GENERIC_EVENT לכל שאר הפעולות. | |
response.auth.metadata.username |
event.idm.read_only_udm.target.user.userid |
מופה מיומן השינויים |
appname |
event.idm.read_only_udm.target.application |
מופה מיומן השינויים |
priority |
event.idm.read_only_udm.security_result.priority_details |
מופה מיומן השינויים |
proc_id |
event.idm.read_only_udm.observer.process.pid |
מופה מיומן השינויים |
auth.policies |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
auth.token_policies |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
request.policy_override |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.admin_password |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.admin_token |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.admin_user |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.certificate |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.check_url |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.keystore |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.keystore_password |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
response.data.private_key |
event.idm.read_only_udm.target.resource.attribute.labels |
מופה מיומן השינויים |
type |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
auth.identity_policies |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
request.data |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
facility |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
task |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
jsonPayload.auth.policy_results.granting_policies.type", "jsonPayload.auth.policy_results.granting_policies.name", and "jsonPayload.auth.policy_results.granting_policies.namespace_id |
additional.fields |
מופה מיומן השינויים |
jsonPayload.request.namespace.id |
target.namespace |
מופה מיומן השינויים |
jsonPayload.cos.googleapis.com/container_id", "jsonPayload.cos.googleapis.com/container_name", "jsonPayload.cos.googleapis.com/stream |
additional.fields |
מופה מיומן השינויים |
resource.labels.instance_id |
principal.resource.product_object_id |
מופה מיומן השינויים |
principal.resource.attribute.cloud.availability_zone |
resource.labels.zone |
מופה מיומן השינויים |
logName |
security_result.category_details |
מופה מיומן השינויים |
resource.labels.namespace_name |
target.namespace |
מופה מיומן השינויים |
resource.labels.pod_name", "resource.labels.container_name |
additional.fields |
מופה מיומן השינויים |
resource.labels.project_id |
target.cloud.project.name |
מופה מיומן השינויים |
resource.labels.location |
target.location.name |
מופה מיומן השינויים |
insertId |
metadata.product_log_id |
מופה מיומן השינויים |
labels.k8s-pod/app_kubernetes_io/instance", "labels.k8s-pod/app_kubernetes_io/name", "labels.k8s-pod/component", "labels.k8s-pod/helm_sh/chart", "labels.k8s-pod/controller-revision-hash", "labels.k8s-pod/vault-initialized", "labels.k8s-pod/vault-version", "labels.k8s-pod/vault-sealed", "labels.k8s-pod/vault-perf-standby", and "labels.k8s-pod/vault-active |
target.resource.attribute.labels |
מופה מיומן השינויים |
labels.compute.googleapis.com/resource_name |
target.resource.name |
מופה מיומן השינויים |
status |
network.http.response_code |
מופה מיומן השינויים |
runner |
principal.user.userid |
מופה מיומן השינויים |
job_id", "job_status |
additional.fields |
מופה מיומן השינויים |
host |
observer.hostname |
מופה מיומן השינויים |
cluster |
observer.resource.name |
מופה מיומן השינויים |
cluster |
observer.resource.resource_type |
מופה מיומן השינויים |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.