Raccogli i log di OpenText Access Manager (precedentemente NetIQ Access Manager)

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di OpenText Access Manager (precedentemente noto come NetIQ Access Manager) in Google Security Operations utilizzando Bindplane.

OpenText Access Manager è una soluzione di gestione di identità e accessi on-premise che fornisce Single Sign-On (SSO), autenticazione a più fattori, federazione e controllo dell'accesso basato su policy per applicazioni e servizi web. Funge da gateway sicuro tra gli utenti e le risorse protette, applicando policy di autenticazione e autorizzazione negli ambienti aziendali.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Un'istanza Google SecOps.
• Un host che esegue Windows 2016 o versioni successive o un host Linux con systemd.
• Connettività di rete: se l'esecuzione avviene dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Accesso con privilegi alla console di amministrazione di OpenText Access Manager.

Ottieni le credenziali di Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuovi deployment: utilizza l'API Chronicle (opzione 1).
• Deployment legacy: continua a utilizzare il file di autenticazione dell'acquisizione (opzione 2) fino alla dismissione dell'API Ingestion il 20 luglio 2027.

Opzione 1: crea un account di servizio per l'API Chronicle (consigliato)

1. Accedi alla consoleGoogle Cloud e seleziona il progetto Google Cloud collegato alla tua istanza di Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea account di servizio.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome account di servizio: inserisci un nome per l'account (ad esempio bindplane-ingest).
   • Descrizione service account: inserisci una descrizione (ad esempio, Bindplane agent log ingestion).
5. Fai clic su Crea e continua.
6. Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Chronicle Editor.
7. Fai clic su Continua e poi su Fine.
8. Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
9. Fai clic su Aggiungi chiave > Crea nuova chiave.
10. Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul computer.
11. Salva il file della chiave come ingestion-auth.json nella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.json su Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json su Windows) o aggiorna creds_file_path in config.yaml in modo che corrisponda al percorso in cui lo salvi.
12. Vai a IAM e amministrazione > Impostazioni e copia il Numero progetto. Ti servirà per la configurazione dell'esportatore.

Nota: la chiave JSON è una credenziale. Limita l'accesso al file sull'host Bindplane e ruota la chiave in base alle policy della tua organizzazione.

Opzione 2: scarica il file di autenticazione dell'acquisizione (legacy)

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni > Gestione dei dati > Agenti di raccolta. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Agenti di raccolta.
3. Scarica il file di autenticazione dell'acquisizione.
4. Salva il file in modo sicuro sul sistema in cui verrà installato l'agente Bindplane.

Nota: questo file autentica l'agente nell'API Ingestion precedente (malachiteingestion-pa.googleapis.com), che Google ha programmato per la fine del ciclo di vita il 20 luglio 2027. Pianifica il passaggio all'Opzione 1 prima di questa data.

Ottieni l'ID cliente Google SecOps

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni > Amministrazione > Profilo. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Profilo.
3. Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.

Installa l'agente Bindplane

Installa l'agente Bindplane sul tuo sistema operativo Windows o Linux seguendo le istruzioni riportate di seguito.

Installazione di Windows

1. Apri il prompt dei comandi o PowerShell come amministratore.

2. Esegui questo comando:

   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
   

Installazione di Linux

1. Apri un terminale con privilegi root o sudo.

2. Esegui questo comando:

   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
   

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione, consulta questa guida all'installazione.

Nota: la configurazione dell'esportatore dell'API Chronicle richiede Bindplane Collector v1.106.0 o versioni successive. I comandi precedenti installano l'ultima release. Se stai aggiornando un'installazione esistente, esegui l'upgrade del raccoglitore prima di modificare la configurazione.

Configura l'agente Bindplane per importare Syslog e inviarlo a Google SecOps

1. Accedi al file di configurazione:

   • Individua il file config.yaml. In genere, si trova nella directory /opt/observiq-otel-collector su Linux o nella directory di installazione su Windows.
   • Apri il file utilizzando un editor di testo (ad esempio nano, vi o Blocco note).

2. Modifica il file config.yaml come segue:

   receivers:
     tcplog:
       listen_address: "0.0.0.0:514"
   
   exporters:
     chronicle/chronicle_w_labels:
       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
       # Adjust the path to the credentials file you downloaded in Step 1
       creds_file_path: '/path/to/ingestion-authentication-file.json'
       # Replace with your actual customer ID from Step 2
       customer_id: '<customer_id>'
       endpoint: chronicle.googleapis.com
       log_type: NETIQ_ACCESS_MANAGER
       raw_log_field: body
       ingestion_labels:
   
   service:
     pipelines:
       logs/source0__chronicle_w_labels-0:
         receivers:
           - tcplog
         exporters:
           - chronicle/chronicle_w_labels
   

• Sostituisci la porta e l'indirizzo IP come richiesto nella tua infrastruttura.
• Sostituisci <LOCATION> con la regione della tua istanza Google SecOps (ad esempio us, europe o asia-southeast1). L'esportatore antepone chronicle.googleapis.com a questo valore.
• Sostituisci <PROJECT_NUMBER> con il numero di progetto indicato in IAM e amministrazione > Impostazioni.
• Sostituisci <customer_id> con l'ID cliente effettivo.
• Aggiorna /path/to/ingestion-authentication-file.json con il percorso del file in cui è stato salvato il file della chiave del account di servizio (Opzione 1) nei passaggi precedenti.

Esportatore API di importazione precedente

• Se utilizzi il file di autenticazione dell'acquisizione dell'Opzione 2, sostituisci il blocco exporters con il seguente. Imposta creds_file_path sul percorso del file di autenticazione dell'acquisizione e, se l'istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con il tuo endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/chronicle_w_labels:
      compression: gzip
      # Adjust the path to the credentials file you downloaded in Step 1
      creds_file_path: '/path/to/ingestion-authentication-file.json'
      # Replace with your actual customer ID from Step 2
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: NETIQ_ACCESS_MANAGER
      raw_log_field: body
      ingestion_labels:
  

Nota: questo strumento di esportazione smetterà di funzionare quando l'API Ingestion non sarà più disponibile il 20 luglio 2027.

Riavvia l'agente Bindplane per applicare le modifiche

1. Per riavviare l'agente Bindplane in Linux, esegui questo comando:

   sudo systemctl restart observiq-otel-collector
   

2. Per riavviare l'agente Bindplane in Windows, puoi utilizzare la console Servizi o inserire il seguente comando:

   net stop observiq-otel-collector && net start observiq-otel-collector
   

Configura l'inoltro del syslog di OpenText Access Manager

1. Accedi alla console di amministrazione di OpenText Access Manager.
2. Vai a Controllo > Syslog.
3. Seleziona la casella di controllo Enable Syslog (Abilita Syslog).
4. Fornisci i seguenti dettagli di configurazione:
   • Indirizzo server Syslog: inserisci l'indirizzo IP dell'host dell'agente Bindplane.
   • Porta: inserisci 514.
   • Facility (Funzione): seleziona la funzione syslog appropriata (ad esempio, LOCAL0).
5. Nella sezione Eventi di controllo, seleziona le categorie di eventi da inoltrare:
   • Eventi di autenticazione
   • Eventi di autorizzazione
   • Eventi di amministrazione
   • Eventi di sistema
6. Fai clic su Applica per salvare la configurazione di syslog.

Nota: verifica che l'appliance OpenText Access Manager possa raggiungere l'host dell'agente Bindplane sulla porta TCP 514. Controlla i log dell'agente Bindplane per verificare che i messaggi syslog vengano ricevuti.

---

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
version	about.resource.attribute.labels	Unita
_field	additional.fields	Unita
I	extensions.auth.type	Mappatura: "002E0505","002E001E","002E0046" → AUTHTYPE_UNSPECIFIED, "002E0007","002E000C"…
host_name	intermediary.hostname	Mappatura diretta
D	metadata.description	Mappatura diretta
stringValue3	metadata.description	Mappatura diretta
timestamp	metadata.event_timestamp	Analizzato come RFC 3339
I	metadata.event_type	Mappatura: "002E0505","002E001E","002E0046" → USER_LOGIN, 002E0525 → `NETWORK_UNCATEGORIZ…
has_principal	metadata.event_type	Mappatura: true → NETWORK_CONNECTION, true → STATUS_UPDATE
has_user	metadata.event_type	Mappatura: true → USER_UNCATEGORIZED
id_sub_event	metadata.product_event_type	Mappatura diretta
I	metadata.product_log_id	Mappatura diretta
eventId	metadata.product_log_id	Mappatura diretta
event_id	metadata.product_log_id	Mappatura diretta
product	metadata.product_name	Mappatura diretta
product_version	metadata.product_version	Mappatura diretta
vendor	metadata.vendor_name	Mappatura diretta
T	network.http.user_agent	Mappatura diretta
L	network.session_id	Mappatura diretta
subTarget	network.session_id	Mappatura diretta
F	principal.application	Mappatura diretta
appName	principal.application	Mappatura diretta
host	principal.asset.hostname	Mappatura diretta
host_name	principal.asset.hostname	Mappatura diretta
originator	principal.asset.hostname	Mappatura diretta
src_ip	principal.asset.ip	Unita
host	principal.hostname	Mappatura diretta
host_name	principal.hostname	Mappatura diretta
originator	principal.hostname	Mappatura diretta
src_ip	principal.ip	Unita
stringValue1	principal.user.userid	Mappatura diretta
I	security_result.action	Mappatura: "002E0505","002E001E","002E0046" → security_action, 002E0525 → `security_actio…
security_action	security_result.action	Unita
name	security_result.action_details	Mappatura diretta
g_label	security_result.detection_fields	Unita
h_label	security_result.detection_fields	Unita
impersonatee_session_id_label	security_result.detection_fields	Unita
m_label	security_result.detection_fields	Unita
v_label	security_result.detection_fields	Unita
priority	security_result.priority_details	Mappatura diretta
A	security_result.rule_id	Mappatura diretta
severity	security_result.severity_details	Valori mappati (5 in totale, ad es. 1 → TRACE, 2 → DEBUG, 4 → INFO)
result	security_result.summary	Mappatura diretta
process_name	target.application	Mappatura diretta
dst_ip	target.asset.ip	Unita
dst_ip	target.ip	Unita
B	target.resource.id	Mappatura diretta
O	target.resource.name	Mappatura diretta
Y	target.url	Mappatura diretta
_group_identifier	target.user.group_identifiers	Unita
U	target.user.userid	Mappatura diretta
device_name	target.user.userid	Mappatura diretta
N/D	extensions.auth.type	Costante: AUTHTYPE_UNSPECIFIED
N/D	metadata.event_type	Costante: USER_LOGIN
N/D	metadata.product_name	Costante: Netiq_Access_Manager
N/D	metadata.vendor_name	Costante: Netiq
N/D	security_result.severity_details	Costante: TRACE
"2"	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
"3"	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
"host_name"	event.idm.read_only_udm.intermediary.hostname	Mappato dal log delle modifiche
1	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
stringValue2	event.idm.read_only_udm.security_result.detection_fields	Mappato dal log delle modifiche
eventId	event.idm.read_only_udm.metadata.product_log_id	Mappato dal log delle modifiche
subTarget	event.idm.read_only_udm.network.session_id	Mappato dal log delle modifiche
stringValue1	event.idm.read_only_udm.principal.user.userid	Mappato dal log delle modifiche
stringValue3	event.idm.read_only_udm.metadata.description	Mappato dal log delle modifiche
originator	event.idm.read_only_udm.principal.asset.hostname	Mappato dal log delle modifiche
originator	event.idm.read_only_udm.principal.hostname	Mappato dal log delle modifiche
G","H","M" and "V	security_result.detection_fields	Mappato dal log delle modifiche
L	event.idm.read_only_udm.network.session_id	Mappato dal log delle modifiche
T	event.idm.read_only_udm.network.http.user_agent	Mappato dal log delle modifiche

Log delle modifiche

Visualizza il log delle modifiche per questo parser

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.