Raccogliere i log di Akeyless Vault
Questo documento spiega come importare i log di Akeyless Vault in Google Security Operations utilizzando l'importazione diretta o Bindplane. Il parser normalizza innanzitutto i messaggi di log, che possono essere in formato chiave-valore o JSON, in una struttura coerente. Poi estrae i campi pertinenti e li mappa allo schema Unified Data Model (UDM), classificando il tipo di evento in base alla presenza di indirizzi IP e alle azioni eseguite.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Istanza Google SecOps
- Accesso privilegiato ad Akeyless Vault
Recuperare il file di autenticazione importazione di Google SecOps
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Agenti di raccolta.
- Scarica il file di autenticazione importazione.
Recuperare l'ID cliente Google SecOps
- Accedi alla console Google SecOps.
- Vai a Impostazioni SIEM > Profilo.
- Copia e salva l'ID cliente dalla sezione Dettagli dell'organizzazione.
Configura l'inoltro dei log per l'importazione diretta in Google SecOps in Akeyless Vault
- Accedi all'interfaccia utente web di Akeyless Gateway.
- Vai a Inoltro log.
- Seleziona Attiva.
- Fornisci i seguenti dettagli di configurazione:
- Formato log: seleziona JSON.
- Audit Log Server: inserisci
https://audit.akeyless.io/
. - Servizio: seleziona Google Chronicle.
- Chiave dell'account di servizio: fornisci il file JSON contenente le credenziali dell'account di servizio.
- ID cliente: inserisci il tuo identificatore univoco Google SecOps.
- Regione: inserisci la regione in cui viene eseguito il provisioning di Google SecOps.
- Log Type (Tipo di log): inserisci AKEYLESS_VAULT.
- Fai clic su Salva modifiche.
(Facoltativo) Inserire Syslog tramite Bindplane
Installazione di Bindplane per Windows
- Apri il prompt dei comandi o PowerShell come amministratore.
Esegui questo comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Installazione di Bindplane per Linux
- Apri un terminale con privilegi di root o sudo.
Esegui questo comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
Risorse aggiuntive per l'installazione
Per ulteriori opzioni di installazione, consulta la guida all'installazione.
Configura l'agente Bindplane per importare Syslog e inviarli a Google SecOps
- Accedi al file di configurazione:
- Individua il file
config.yaml
. In genere, si trova nella directory/etc/bindplane-agent/
su Linux o nella directory di installazione su Windows. - Apri il file utilizzando un editor di testo (ad esempio
nano
,vi
o Blocco note).
- Individua il file
Modifica il file
config.yaml
come segue:receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization ingestion_labels: log_type: 'AKEYLESS_VAULT' raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
Sostituisci la porta e l'indirizzo IP in base alle esigenze della tua infrastruttura.
Sostituisci
<customer_id>
con l'ID cliente effettivo.Aggiorna
/path/to/ingestion-authentication-file.json
al percorso in cui è stato salvato il file di autenticazione nella sezione Recupera il file di autenticazione per l'importazione di Google SecOps.
Riavvia l'agente Bindlane per applicare le modifiche
Per riavviare l'agente Bindplane in Linux, esegui questo comando:
sudo systemctl restart bindplane-agent
Per riavviare l'agente Bindplane in Windows, puoi utilizzare la console Servizi o inserire il seguente comando:
net stop BindPlaneAgent && net start BindPlaneAgent
Configurare l'inoltro di Syslog a Bindplane in Akeyless Vault
- Accedi all'interfaccia utente web di Akeyless Gateway.
- Vai a Inoltro log.
- Seleziona Attiva.
- Fornisci i seguenti dettagli di configurazione:
- Formato log: seleziona JSON.
- Audit Log Server: inserisci
https://audit.akeyless.io/
. - Servizio: seleziona Syslog.
- Rete Syslog: seleziona UDP. Puoi selezionare un'altra opzione, a seconda della configurazione dell'agente Bindplane.
- Host syslog: inserisci l'indirizzo IP dell'agente Bindplane.
- Syslog Formatter: seleziona Testo.
- (Facoltativo) TLS: seleziona la casella di controllo TLS e carica il certificato TLS.
- Fai clic su Salva modifiche.
Tabella di mappatura UDM
Campo log | Mappatura UDM | Logic |
---|---|---|
access_id | read_only_udm.metadata.product_log_id | Mappato direttamente dal campo access_id . Se non presente, viene estratto dal campo message utilizzando l'espressione regolare access_id:\s+(?<accessid>[\w-]+) . |
account_id | read_only_udm.target.user.userid | Mappato direttamente dal campo account_id . |
azione | read_only_udm.security_result.action_details | Mappato direttamente dal campo action . |
componente | read_only_udm.target.resource.name | Mappato direttamente dal campo component . |
duration | read_only_udm.network.session_duration.seconds | Mappato direttamente dal campo duration e convertito in numero intero. |
remote_addr | read_only_udm.principal.ip | Estratto dal campo remote_addr , suddiviso per virgola e aggiunto all'array principal.ip . |
request_parameters.access_type | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "access_type") | Mappato direttamente dal campo request_parameters.access_type . Se non presente, viene estratto dal campo message utilizzando l'espressione regolare access_type:\s+(?<accesstype>[\S]+) . |
request_parameters.comment | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "comment") | Mappato direttamente dal campo request_parameters.comment . |
request_parameters.operation | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "operation") | Mappato direttamente dal campo request_parameters.operation . |
request_parameters.product | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "product") | Mappato direttamente dal campo request_parameters.product . Se non presente, viene estratto dal campo message utilizzando l'espressione regolare product:\s+(?<product>[\w\s]+) . |
request_parameters.token_id | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "token_id") | Mappato direttamente dal campo request_parameters.token_id . |
request_parameters.transaction_type | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "transaction_type") | Mappato direttamente dal campo request_parameters.transaction_type e convertito in stringa. Se non presente, viene estratto dal campo message utilizzando l'espressione regolare transaction_type:\s+(?<transactiontype>[\S]+) . |
request_parameters.unique_id | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "unique_id") | Mappato direttamente dal campo request_parameters.unique_id . Se non presente, viene estratto dal campo message utilizzando l'espressione regolare unique_id:\s+(?<uniqueid>[\w-]+) . |
request_parameters.universal_identity_rotate_type | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "universal_identity_rotate_type") | Mappato direttamente dal campo request_parameters.universal_identity_rotate_type . |
request_parameters.user_agent | read_only_udm.target.resource.attribute.labels.value (dove la chiave è "user_agent") | Mappato direttamente dal campo request_parameters.user_agent . |
gravità | Mappato direttamente dal campo severity . |
|
stato | read_only_udm.network.http.response_code | Mappato direttamente dal campo status e convertito in numero intero. |
timestamp | read_only_udm.metadata.event_timestamp | Mappato direttamente dal campo timestamp della voce di log. |
read_only_udm.metadata.log_type | Codificato in modo permanente su AKEYLESS_VAULT . |
|
read_only_udm.metadata.event_type | Impostato su STATUS_UPDATE se ip_present è true, altrimenti il valore predefinito è GENERIC_EVENT . |
|
read_only_udm.metadata.vendor_name | Estratto dal campo message utilizzando l'espressione regolare CEF:0|%{DATA:device_vendor}|%{DATA:device_product}|%{DATA:device_version}|%{DATA:device_event_class_id}\s+%{WORD}\[%{INT}\]:\s+%{GREEDYDATA:kv_data} . |
|
read_only_udm.metadata.product_name | Estratto dal campo message utilizzando l'espressione regolare CEF:0|%{DATA:device_vendor}|%{DATA:device_product}|%{DATA:device_version}|%{DATA:device_event_class_id}\s+%{WORD}\[%{INT}\]:\s+%{GREEDYDATA:kv_data} . |
|
read_only_udm.metadata.product_version | Estratto dal campo message utilizzando l'espressione regolare CEF:0|%{DATA:device_vendor}|%{DATA:device_product}|%{DATA:device_version}|%{DATA:device_event_class_id}\s+%{WORD}\[%{INT}\]:\s+%{GREEDYDATA:kv_data} . |
|
read_only_udm.metadata.product_event_type | Estratto dal campo message utilizzando l'espressione regolare <%{INT}>%{TIMESTAMP_ISO8601:time}\s+%{DATA}\s+(?P<product_event_type>[\w-]+)\[%{INT}\]:\s+(?P<time2>\d{1,2}-%{MONTH}-\d{1,4}\s+\d{1,2}:\d{1,2}:\d{1,2}.\d+)\s+%{WORD}\s+%{WORD:severity}\s+CEF:0|%{DATA:device_vendor}|%{DATA:device_product}|%{DATA:device_version}|%{DATA:device_event_class_id}\s+%{WORD}\[%{INT}\]:\s+%{GREEDYDATA:kv_data} . |
|
read_only_udm.target.namespace | Estratto dal campo message utilizzando l'espressione regolare namespace:\s+(?<namespace>[\S]+) . |
|
read_only_udm.security_result.severity | Mappatura dal campo severity : Info a INFORMATIONAL , Error a ERROR , Warning a MEDIUM , altrimenti UNKNOWN_SEVERITY . |
|
read_only_udm.network.http.method | Mappatura dal campo action : get a GET , put e Authentication a PUT , post a POST , delete a DELETE . |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.