איסוף יומני ביקורת של 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. נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
  2. נכנסים לדף IAM & Admin > Service Accounts.
  3. לוחצים על Create service account.
  4. מזינים את פרטי ההגדרה הבאים:
    • Service account name: מזינים שם לחשבון (לדוגמה, bindplane-ingest).
    • Service account description: מזינים תיאור (לדוגמה, Bindplane agent log ingestion).
  5. לוחצים על Create and continue.
  6. בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
  7. לוחצים על המשך ואז על סיום.
  8. לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
  9. לוחצים על Add key > Create new key.
  10. בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
  11. שומרים את קובץ המפתח בתור 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 כך שיתאים לנתיב שבו שמרתם אותו.
  12. עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.

אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
  3. מורידים את קובץ האימות להטמעת נתונים.
  4. שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.

איך מקבלים את מספר הלקוח ב-Google SecOps

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
  3. מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.

התקנת הסוכן של Bindplane

מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows או Linux לפי ההוראות הבאות.

התקנת חלונות

  1. פותחים את שורת הפקודה או את PowerShell כאדמין.
  2. מריצים את הפקודה הבאה:

    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
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    sc query observiq-otel-collector
    

השירות אמור להופיע כ-RUNNING.

התקנה ב-Linux

  1. פותחים טרמינל עם הרשאות root או sudo.
  2. מריצים את הפקודה הבאה:

    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
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    sudo systemctl status observiq-otel-collector
    

השירות אמור להופיע כפעיל (פועל).

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

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

הגדרת סוכן Bindplane להטמעת syslog ושליחה אל Google SecOps

מאתרים את קובץ התצורה

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    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
    • ‫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:

  1. מריצים את הפקודה הבאה:

    sudo systemctl restart observiq-otel-collector
    
  2. מוודאים שהשירות פועל:

    sudo systemctl status observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

    sudo journalctl -u observiq-otel-collector -f
    

כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows:

  1. בוחרים אחת מהאפשרויות האלה:

    • שורת הפקודה או PowerShell כאדמין:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • מסוף השירותים:
      1. לוחצים על Win+R, מקלידים services.msc ולוחצים על Enter.
      2. מאתרים את observIQ OpenTelemetry Collector.
      3. לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
  2. מוודאים שהשירות פועל:

    sc query observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

הגדרת העברה של יומן הביקורת של HashiCorp Vault באמצעות syslog

מכשירי הביקורת של Vault מתעדים את כל הבקשות והתגובות. אתם יכולים להפעיל מכשיר ביקורת של syslog כדי להעביר את יומני הביקורת לסוכן Bindplane.

הפעלת מכשיר ביקורת של syslog

  1. פותחים טרמינל עם גישה ל-Vault CLI ואסימון Vault תקין.
  2. מריצים את הפקודה הבאה כדי להפעיל את מכשיר הביקורת של syslog:

    vault audit enable syslog tag="vault" facility="AUTH"
    
  3. מוודאים שהמכשיר לביקורת מופעל:

    vault audit list
    

בפלט, התקן הביקורת של syslog אמור להופיע כ-enabled.

הגדרת העברת syslog לסוכן Bindplane

אחרי שמפעילים את מכשיר הביקורת של Vault syslog, מגדירים את ה-daemon של ה-syslog במערכת (rsyslog או syslog-ng) כדי להעביר את יומני הביקורת של Vault לסוכן Bindplane.

אפשרות – הגדרת rsyslog

  1. יוצרים קובץ תצורה חדש של rsyslog:

    sudo nano /etc/rsyslog.d/50-vault-forward.conf
    
  2. מוסיפים את ההגדרות הבאות:

    # Forward Vault audit logs to Bindplane agent
    if $programname == 'vault' then @@BINDPLANE_IP:1514
    

    מחליפים את BINDPLANE_IP בכתובת ה-IP של המארח של סוכן Bindplane.

  3. מפעילים מחדש את rsyslog:

    sudo systemctl restart rsyslog
    

אפשרות – הגדרת syslog-ng

  1. עורכים את קובץ התצורה של syslog-ng:

    sudo nano /etc/syslog-ng/conf.d/vault-forward.conf
    
  2. מוסיפים את ההגדרות הבאות:

    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.

  3. מפעילים מחדש את syslog-ng:

    sudo systemctl restart syslog-ng
    

חלופה – ביקורת מבוססת-קובץ עם מעביר יומנים

אם אתם לא רוצים להשתמש בביקורת של syslog, אתם יכולים להפעיל מכשיר לביקורת קבצים ולהעביר את תוכן הקובץ:

  1. הפעלת מכשיר לביקורת קבצים:

    vault audit enable file file_path=/var/log/vault/audit.log
    
  2. מגדירים את rsyslog למעקב אחרי הקובץ ולהעברה שלו:

    sudo nano /etc/rsyslog.d/50-vault-file-forward.conf
    
    module(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.

  3. מפעילים מחדש את rsyslog:

    sudo systemctl restart rsyslog
    

אימות העברת היומנים

  1. מבצעים פעולה ב-Vault (לדוגמה, התחברות או קריאת סוד):

    vault login token=<YOUR_TOKEN>
    
  2. בודקים את יומני הסוכן של 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.