Raccogli i log di SecureAuth Identity Platform

Supportata in:

Google SecOps SIEM

Questo documento spiega come importare i log di SecureAuth Identity Platform in Google Security Operations utilizzando l'agente Bindplane.

SecureAuth Identity Platform è una soluzione di gestione di identità e Single Sign-On che genera messaggi syslog per eventi di autenticazione, attività di sessione, decisioni di controllo dell'accesso e audit trail. Il parser estrae i campi dai log in formato syslog e XML utilizzando i pattern grok e li mappa al modello UDM (Unified Data Model).

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Un'istanza Google SecOps
• Windows Server 2016 o versioni successive o host Linux con systemd
• Connettività di rete tra l'agente Bindplane e SecureAuth Identity Platform
• Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Accesso con privilegi a SecureAuth

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 del 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) 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 policy 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 legacy (malachiteingestion-pa.googleapis.com), il cui fine del ciclo di vita è previsto da Google per il 20 luglio 2027. Pianifica di passare 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.

   Nota: l'ID cliente è obbligatorio per configurare l'esportatore dell'agente Bindplane.

Installa l'agente Bindplane

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

Installazione di finestre

1. Apri 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" /quiet
   

3. Attendi il completamento dell'installazione.

4. Verifica l'installazione eseguendo:

   sc query observiq-otel-collector
   

   Il servizio dovrebbe essere visualizzato come RUNNING.

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)" install_unix.sh
   

3. Attendi il completamento dell'installazione.

4. Verifica l'installazione eseguendo:

   sudo systemctl status observiq-otel-collector
   

   Il servizio dovrebbe essere visualizzato come attivo (in esecuzione).

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione e risoluzione dei problemi, consulta la guida all'installazione dell'agente Bindplane.

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 syslog e invialo a Google SecOps

Individua il file di configurazione

• Linux:

  sudo nano /opt/observiq-otel-collector/config.yaml
  

• Windows:

  notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
  

Modifica il file di configurazione

• Sostituisci l'intero contenuto di config.yaml con la seguente configurazione:

  receivers:
    udplog:
      listen_address: "0.0.0.0:514"
  
  exporters:
    chronicle/secureauth_sso:
      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: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: SECUREAUTH_SSO
      raw_log_field: body
  
  service:
    pipelines:
      logs/secureauth_sso_to_chronicle:
        receivers:
          - udplog
        exporters:
          - chronicle/secureauth_sso
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del ricevitore:

  • listen_address: indirizzo IP e porta su cui ascoltare:
    • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
    • La porta 514 è la porta syslog standard (richiede l'accesso root su Linux; utilizza 1514 per l'accesso non root)

• Configurazione dell'esportatore:

  • creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • customer_id: ID cliente copiato dalla console Google SecOps
  • location: 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. Per l'elenco completo, consulta Endpoint regionali.
  • project: sostituisci <PROJECT_NUMBER> con il numero di progetto in IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione su chronicle.googleapis.com.

Esportatore API di importazione legacy

• 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'importazione e, se la tua istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con l'endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/secureauth_sso:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: SECUREAUTH_SSO
      raw_log_field: body
  

Nota: questo esportatore smetterà di funzionare quando l'API Ingestion verrà ritirata il 20 luglio 2027.

Salva il file di configurazione

• Dopo la modifica, salva il file:
  • Linux: premi Ctrl+O, poi Enter e infine Ctrl+X.
  • Windows: fai clic su File > Salva

Riavvia l'agente Bindplane per applicare le modifiche

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

  sudo systemctl restart observiq-otel-collector
  

  1. Verifica che il servizio sia in esecuzione:

     sudo systemctl status observiq-otel-collector
     

  2. Controlla i log per individuare eventuali errori:

     sudo journalctl -u observiq-otel-collector -f
     

• Per riavviare l'agente Bindplane in Windows, scegli una delle seguenti opzioni:

  • Prompt dei comandi o PowerShell come amministratore:

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

  • Console dei servizi:

    1. Premi Win+R, digita services.msc e premi Invio.
    2. Individua observIQ OpenTelemetry Collector.
    3. Fai clic con il tasto destro del mouse e seleziona Riavvia.

    4. Verifica che il servizio sia in esecuzione:

       sc query observiq-otel-collector
       

    5. Controlla i log per individuare eventuali errori:

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

Configura SecureAuth Identity Platform

1. Accedi alla console SecureAuth Identity come amministratore.
2. Seleziona Log.
3. Fornisci i seguenti dettagli di configurazione nella sezione Opzioni di log:
   • ID istanza di log: inserisci l'ID istanza di log, il nome dell'applicazione o il nome del realm (ad esempio, SecureAuth1).
   • Audit log: seleziona la casella di controllo Syslog.
   • Log degli errori: seleziona la casella di controllo Syslog.
   • Syslog Server (Server Syslog): inserisci l'indirizzo IP dell'agente Bindplane.
   • Porta Syslog: inserisci il numero di porta dell'agente Bindplane (ad esempio 514).
   • Specifica RFC Syslog: seleziona RFC 5424.
4. Fai clic su Salva.

Tabella di mappatura UDM

Campo log	mappatura UDM	Logica
action_msg	read_only_udm.target.process.command_line	Valore del campo action_msg
Appliance	read_only_udm.principal.domain.name	Valore del campo Appliance
Appliance	read_only_udm.target.administrative_domain	Valore del campo Appliance
BrowserSession	read_only_udm.network.session_id	Valore del campo BrowserSession
gatto	read_only_udm.metadata.product_event_type	Valore del campo cat
Categoria	read_only_udm.metadata.product_event_type	Valore del campo Category
cn1	security_result.severity	Mappato in base al valore di cn1 quando cn1Label è "Priority": 1 - HIGH, 2 - MEDIUM, 3 o 4 - LOW
Società	read_only_udm.additional.fields.value.string_value	Valore del campo Company
cs1	read_only_udm.network.session_id	Valore del campo cs1 quando cs1Label è "BrowserSession"
cs3	read_only_udm.additional.fields.value.string_value	Valore del campo cs3 quando cs3Label è "CompanyName"
dst	read_only_udm.target.ip	Valore del campo dst
dominio	read_only_udm.principal.domain.name	Valore del campo domain
dvc	read_only_udm.intermediary.ip	Valore del campo dvc
EventID	read_only_udm.metadata.product_log_id	Valore del campo EventID
HostName	read_only_udm.principal.hostname	Valore del campo HostName quando grok non riesce a trovare un indirizzo IP corrispondente
HostName	read_only_udm.principal.ip	Valore del campo HostName quando grok corrisponde all'indirizzo IP
ip	read_only_udm.principal.ip	Valore del campo ip
Messaggio	read_only_udm.metadata.description	Valore del campo Message
Messaggio	security_result.description	Valore del campo Message
nat_ip	read_only_udm.principal.nat_ip	Valore del campo nat_ip
Priorità	security_result.severity	Mappato in base al valore di Priority: 1 - ALTO, 2 - MEDIO, 3 o 4 - BASSO
SAMLConsumerURL	read_only_udm.target.url	Valore del campo SAMLConsumerURL
sec_msg	security_result.description	Valore del campo sec_msg
SecureAuthIdPAppliance	read_only_udm.target.administrative_domain	Valore del campo SecureAuthIdPAppliance
SecureAuthIdPApplianceMachineName	read_only_udm.target.hostname	Valore del campo SecureAuthIdPApplianceMachineName
SecureAuthIdPDestinationSiteUrl	read_only_udm.target.url	Valore del campo SecureAuthIdPDestinationSiteUrl
SecureAuthIdPProductType	read_only_udm.additional.fields.value.string_value	Valore del campo SecureAuthIdPProductType
sessione	read_only_udm.network.session_id	Valore del campo session
spid	read_only_udm.target.process.pid	Valore del campo spid
src	read_only_udm.principal.ip	Valore del campo src
suser	read_only_udm.target.user.userid	Valore del campo suser
UserAgent	read_only_udm.network.http.user_agent	Valore del campo UserAgent
UserHostAddress	read_only_udm.principal.nat_ip	Valore del campo UserHostAddress
UserHostAddress	read_only_udm.target.ip	Valore del campo UserHostAddress
UserID	read_only_udm.principal.user.userid	Valore del campo UserID
Versione	read_only_udm.metadata.product_version	Valore del campo Version
	read_only_udm.additional.fields.key	Valore hardcoded: "CompanyName"
	read_only_udm.additional.fields.key	Valore hardcoded: "Company"
	read_only_udm.additional.fields.key	Valore impostato come hardcoded - "SecureAuthIdPProductType"
	read_only_udm.extensions.auth.type	Valore hardcoded: "SSO"
	read_only_udm.metadata.event_type	'USER_LOGIN' se SecureAuthIdPAuthGuiMode == 0 e auth_result == Success, 'USER_CHANGE_PERMISSIONS' se SecureAuthIdPAuthGuiMode == 0 e auth_result ==WS-Trust success., 'USER_LOGOUT' se SecureAuthIdPAuthGuiMode == 0 e auth_result == Session Aborted, 'NETWORK_CONNECTION' se UserHostAddress != and `HostName` !=, 'STATUS_UPDATE' se ip != or `HostName` !=, 'USER_UNCATEGORIZED' se UserHostAddress != and `HostName` == e UserID != ``, altrimenti - 'GENERIC_EVENT'
	read_only_udm.metadata.log_type	Valore impostato come hardcoded: "SECUREAUTH_SSO"
	read_only_udm.metadata.product_name	Valore impostato come hardcoded: "SECUREAUTH_SSO"
	read_only_udm.metadata.vendor_name	Valore impostato come hardcoded: "SECUREAUTH_SSO"
	read_only_udm.target.user.email_addresses	Valore del campo user_email quando not_email è false
	security_result.severity	'HIGH' se cn1Label == Priority e cn1 == 1, 'MEDIUM' se cn1Label == Priority e cn1 == 2, 'LOW' se cn1Label == Priority e cn1 in [3, 4], 'HIGH' se Priority == 1, 'MEDIUM' se Priority == 2, 'LOW' se Priority in [3, 4]
_timestamp	event.idm.read_only_udm.metadata.collected_timestamp	Mappato dal log delle modifiche
i_ip	event.idm.read_only_udm.intermediary.ip	Mappato dal log delle modifiche
i_port	event.idm.read_only_udm.intermediary.port	Mappato dal log delle modifiche
parsed.LogChannel	event.idm.read_only_udm.metadata.product_event_type	Mappato dal log delle modifiche
parsed.FormatVersion	event.idm.read_only_udm.metadata.product_version	Mappato dal log delle modifiche
parsed.EventID	event.idm.read_only_udm.metadata.product_log_id	Mappato dal log delle modifiche
parsed.CompanyID	event.idm.read_only_udm.principal.resource.product_object_id	Mappato dal log delle modifiche
parsed.Realm	event.idm.read_only_udm.principal.resource.name	Mappato dal log delle modifiche
parsed.UserHostAddress	event.idm.read_only_udm.principal.ip	Mappato dal log delle modifiche
parsed.UserHostAddress	event.idm.read_only_udm.principal.asset.ip	Mappato dal log delle modifiche
host.name	event.idm.read_only_udm.principal.hostname	Mappato dal log delle modifiche
host.name	event.idm.read_only_udm.principal.asset.hostname	Mappato dal log delle modifiche
parsed.RequestID	event.idm.read_only_udm.metadata.id	Mappato dal log delle modifiche
meta.cloud.availability_zone	event.idm.read_only_udm.principal.location.name	Mappato dal log delle modifiche
meta.cloud.region	event.idm.read_only_udm.principal.location.country_or_region	Mappato dal log delle modifiche
host.id	event.idm.read_only_udm.principal.resource.id	Mappato dal log delle modifiche
LogstashPod	event.idm.read_only_udm.observer.hostname	Mappato dal log delle modifiche
fields.ApplianceID	event.idm.read_only_udm.principal.asset.asset_id	Mappato dal log delle modifiche
LogChannel	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
FormatVersion	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
EventID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
Version	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
parsed.UserAgent	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
parsed.ApplianceID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
beat.name	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
beat.hostname	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
beat.version	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
fields.CompanyID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
derived.CompanyIndex	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
_version	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
derived.EventType	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
prospector.type	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
input.type	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
parsed_Message	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
meta.cloud.machine_type	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
ApplianceType	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
parsed.Version	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
host.architecture	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
host.os.platform	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
host.os.version	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
host.os.build	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
host.os.family	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
host.os.name	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
meta.cloud.provider	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
derived.LogChannelIndex	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
document_id	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
meta.cloud.instance_id	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
tags	event.idm.read_only_udm.principal.resource.attribute.labels	Mappato dal log delle modifiche
Realm	event.idm.read_only_udm.target.resource.name	Mappato dal log delle modifiche
CompanyID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
PEN	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
ApplianceID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
ApplianceMachineName	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
RequestID	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
UseJava	event.idm.read_only_udm.additional.fields	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.