Raccogli i log di OpenText Access Manager (in precedenza NetIQ Access Manager)

Supportato 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 delle identità e dell'accesso 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 criteri 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'agente viene eseguito dietro un proxy, assicurati che le porte firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Accesso privilegiato alla console di amministrazione di OpenText Access Manager.

Recupera le credenziali 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 (consigliata)

1. Accedi alla Google Cloud console e seleziona il progetto Google Cloud collegato alla tua istanza Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea service account.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome service account: 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 Editor Chronicle.
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 tuo 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) oppure 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 norme della tua organizzazione.

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

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni SIEM > 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.

Recuperare l'ID cliente Google SecOps

1. Accedi alla console Google SecOps.
2. Vai a Impostazioni SIEM > Profilo.
3. Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.

Installa l'agente Bindplane

Installa l'agente Bindplane sul 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 in base alle esigenze della 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 legacy

• Se utilizzi il file di autenticazione dell'importazione 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 di syslog di OpenText Access Manager

1. Accedi alla console di amministrazione di OpenText Access Manager.
2. Vai a Audit > Syslog.
3. Seleziona la casella di controllo 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: seleziona la facility 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	Mappata direttamente
D	metadata.description	Mappata direttamente
stringValue3	metadata.description	Mappata direttamente
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	Mappata direttamente
I	metadata.product_log_id	Mappata direttamente
eventId	metadata.product_log_id	Mappata direttamente
event_id	metadata.product_log_id	Mappata direttamente
product	metadata.product_name	Mappata direttamente
product_version	metadata.product_version	Mappata direttamente
vendor	metadata.vendor_name	Mappata direttamente
T	network.http.user_agent	Mappata direttamente
L	network.session_id	Mappata direttamente
subTarget	network.session_id	Mappata direttamente
F	principal.application	Mappata direttamente
appName	principal.application	Mappata direttamente
host	principal.asset.hostname	Mappata direttamente
host_name	principal.asset.hostname	Mappata direttamente
originator	principal.asset.hostname	Mappata direttamente
src_ip	principal.asset.ip	Unita
host	principal.hostname	Mappata direttamente
host_name	principal.hostname	Mappata direttamente
originator	principal.hostname	Mappata direttamente
src_ip	principal.ip	Unita
stringValue1	principal.user.userid	Mappata direttamente
I	security_result.action	Mappato: "002E0505","002E001E","002E0046" → security_action, 002E0525 → `security_actio…
security_action	security_result.action	Unita
name	security_result.action_details	Mappata direttamente
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	Mappata direttamente
A	security_result.rule_id	Mappata direttamente
severity	security_result.severity_details	Valori mappati (5 in totale, ad es. 1 → TRACE, 2 → DEBUG, 4 → INFO)
result	security_result.summary	Mappata direttamente
process_name	target.application	Mappata direttamente
dst_ip	target.asset.ip	Unita
dst_ip	target.ip	Unita
B	target.resource.id	Mappata direttamente
O	target.resource.name	Mappata direttamente
Y	target.url	Mappata direttamente
_group_identifier	target.user.group_identifiers	Unita
U	target.user.userid	Mappata direttamente
device_name	target.user.userid	Mappata direttamente
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.