Raccogli i log di Appian Cloud

Versione parser: 4.0

Supportato in:

Google SecOps SIEM

Questo documento spiega come importare i log di Appian Cloud in Google Security Operations utilizzando l'agente Bindplane.

Appian Cloud è una piattaforma di automazione low-code che consente alle organizzazioni di creare applicazioni e workflow aziendali. Lo streaming dei log fornisce i log eventi di controllo e gli eventi di sicurezza dal tuo ambiente Appian Cloud tramite una connessione VPN IPsec.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Un'istanza Google SecOps
• Windows Server 2016 o versioni successive oppure host Linux con systemd
• Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane.
• Licenza Professional o Signature con Appian Cloud
• Record degli URL dell'ambiente Appian
• VPN IPsec tra Appian Cloud e l'ambiente in cui verrà eseguito il deployment dell'agente Bindplane

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 al ritiro dell'API Ingestion il 20 luglio 2027.

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

1. Accedi alla consoleGoogle Cloud 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 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 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 legacy (malachiteingestion-pa.googleapis.com), il cui fine del ciclo di vita è previsto da Google per 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 SIEM > Profilo.

3. Copia e salva l'ID cliente dalla sezione Dettagli dell'organizzazione.

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

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 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 l'agente Bindplane per importare syslog e inviarli 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:
    tcplog:
      listen_address: "0.0.0.0:6514"
  
  exporters:
    chronicle/appian_cloud:
      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: APPIAN_CLOUD
      raw_log_field: body
  
  service:
    pipelines:
      logs/appian_to_chronicle:
        receivers:
          - tcplog
        exporters:
          - chronicle/appian_cloud
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del destinatario:

  • listen_address: Indirizzo IP e porta da ascoltare:
    • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
    • La porta 6514 è quella consigliata per lo streaming dei log di Appian Cloud

• 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 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/appian_cloud:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: APPIAN_CLOUD
      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 verificare la presenza di 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 verificare la presenza di errori:

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

Abilita lo streaming dei log per Appian Cloud

1. Apri una richiesta di assistenza con Appian, con l'oggetto Abilita flussi di log, e includi i seguenti dettagli:
   • URL ambiente
   • Percorso di rete desiderato, come una VPN IPsec
   • Indirizzo IP dell'agente Bindplane
   • Numero di porta TCP dell'agente Bindplane (ad esempio, 6514)
2. L'assistenza Appian pianifica un periodo di manutenzione e implementa la configurazione.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
available_heap_space_label	additional.fields	Unita
cpu_core_count_label	additional.fields	Unita
daemon_thread_count_label	additional.fields	Unita
data_store_label	additional.fields	Unita
devicetimestamp_label	additional.fields	Unita
entity_label	additional.fields	Unita
execute_time_label	additional.fields	Unita
load_average_label	additional.fields	Unita
operation_name_label	additional.fields	Unita
operation_type_label	additional.fields	Unita
permanent_generation_available_label	additional.fields	Unita
permanent_generation_used_label	additional.fields	Unita
prepare_time_label	additional.fields	Unita
retcode_label	additional.fields	Unita
session_count_label	additional.fields	Unita
tenured_collection_count_label	additional.fields	Unita
tenured_collection_time_label	additional.fields	Unita
tenured_generation_available_label	additional.fields	Unita
tenured_generation_usage_after_collection_label	additional.fields	Unita
tenured_generation_used_label	additional.fields	Unita
thread_label	additional.fields	Unita
total_swap_space_label	additional.fields	Unita
total_system_memory_label	additional.fields	Unita
total_thread_count_label	additional.fields	Unita
transform_time_label	additional.fields	Unita
used_heap_space_label	additional.fields	Unita
used_swap_space_label	additional.fields	Unita
used_system_memory_label	additional.fields	Unita
young_cllection_time_label	additional.fields	Unita
young_collection_count_label	additional.fields	Unita
has_principal_user	extensions.auth.type	Mappatura: true → AUTHTYPE_UNSPECIFIED
src_host	intermediary.hostname	Mappata direttamente
src_ip	intermediary.ip	Unita
time	metadata.event_timestamp	Analizzato come yyyy-MM-dd HH:mm:ss
event_type	metadata.event_type	Mappata direttamente
device	metadata.product_event_type	Mappato direttamente
product_type	metadata.product_event_type	Mappato direttamente
http_method	network.http.method	Mappato direttamente
useragent	network.http.parsed_user_agent	Rinominato/mappato
useragent	network.http.user_agent	Mappata direttamente
connectionid	network.session_id	Mappato direttamente
sessionID	network.session_id	Mappato direttamente
session_id	network.session_id	Mappato direttamente
domain	principal.administrative_domain	Mappato direttamente
application	principal.application	Mappato direttamente
host	principal.asset.hostname	Mappato direttamente
hostname	principal.asset.hostname	Mappata direttamente
IpAddress	principal.asset.ip	Unita
host	principal.hostname	Mappato direttamente
hostname	principal.hostname	Mappata direttamente
IpAddress	principal.ip	Unita
src_port	principal.port	Mappato direttamente
process_id	principal.process.pid	Mappato direttamente
url	principal.url	Mappata direttamente
roles	principal.user.attribute.roles	Unita
companyname	principal.user.company_name	Mappata direttamente
email	principal.user.email_addresses	Unita
user_id	principal.user.email_addresses	Mappato: N/A → user_id
modified_by_uuid	principal.user.product_object_id	Mappata direttamente
user	principal.user.product_object_id	Mappato direttamente
modified_by_username	principal.user.userid	Mappato direttamente
userId	principal.user.userid	Mappato direttamente
user_id	principal.user.userid	Mappato direttamente
username2	principal.user.userid	Mappato direttamente
versionDetails	security_result.about.platform_version	Mappata direttamente
outcome_result	security_result.action	Unita
security_result_action	security_result.action	Unita
act	security_result.action_details	Mappato direttamente
status	security_result.action_details	Mappata direttamente
sec_result_category	security_result.category	Unita
category	security_result.category_details	Unita
desc	security_result.description	Mappato direttamente
details	security_result.description	Mappata direttamente
details_label	security_result.detection_fields	Unita
endpoint_label	security_result.detection_fields	Unita
execution_count_label	security_result.detection_fields	Unita
maximum_execution_time_label	security_result.detection_fields	Unita
maximum_response_size_label	security_result.detection_fields	Unita
maximum_response_time_label	security_result.detection_fields	Unita
mean_execution_time_label	security_result.detection_fields	Unita
mean_response_size_label	security_result.detection_fields	Unita
minimum_execution_time_label	security_result.detection_fields	Unita
minimum_response_size_label	security_result.detection_fields	Unita
model_label	security_result.detection_fields	Unita
rolesAllow_label	security_result.detection_fields	Unita
sqlcmd_label	security_result.detection_fields	Unita
status_code_1xx_count_label	security_result.detection_fields	Unita
status_code_2xx_count_label	security_result.detection_fields	Unita
status_code_3xx_count_label	security_result.detection_fields	Unita
status_code_4xx_count_label	security_result.detection_fields	Unita
status_code_5xx_count_label	security_result.detection_fields	Unita
type_label	security_result.detection_fields	Unita
uuid_label	security_result.detection_fields	Unita
severity	security_result.severity	Mappatura: "INFORMATIONAL","INFORMATION","INFO" → INFORMATIONAL, "WARNING", "MEDIUM" → `M…
detail	security_result.severity_details	Mappata direttamente
action1	security_result.summary	Mappato direttamente
msg	security_result.summary	Mappato direttamente
object	security_result.summary	Mappato direttamente
operation_detail	security_result.summary	Mappato direttamente
reason	security_result.summary	Mappato direttamente
summary	security_result.summary	Mappato direttamente
server_host	target.asset.hostname	Mappato direttamente
tar_host	target.asset.hostname	Mappata direttamente
src_ip1	target.asset.ip	Unita
hash	target.file.md5	Mappata direttamente
document_name	target.file.names	Unita
server_host	target.hostname	Mappato direttamente
tar_host	target.hostname	Mappata direttamente
src_ip1	target.ip	Unita
commandline	target.process.command_line	Mappata direttamente
action_label	target.resource.attribute.labels	Unita
environment_label	target.resource.attribute.labels	Unita
filters_label	target.resource.attribute.labels	Unita
new_value_label	target.resource.attribute.labels	Unita
original_value_label	target.resource.attribute.labels	Unita
page_group_invoved_label	target.resource.attribute.labels	Unita
page_involved_label	target.resource.attribute.labels	Unita
record_identifier_label	target.resource.attribute.labels	Unita
record_type_name_label	target.resource.attribute.labels	Unita
record_type_url_stub_label	target.resource.attribute.labels	Unita
setting_new_value_label	target.resource.attribute.labels	Unita
setting_old_value_label	target.resource.attribute.labels	Unita
site_involved_label	target.resource.attribute.labels	Unita
site_url_stub_label	target.resource.attribute.labels	Unita
view_label	target.resource.attribute.labels	Unita
database	target.resource.name	Mappato direttamente
property	target.resource.name	Mappato direttamente
record_type_name	target.resource.name	Mappato direttamente
resourcename	target.resource.name	Mappato direttamente
site_involved	target.resource.name	Mappato direttamente
id	target.resource.product_object_id	Mappato direttamente
oid	target.resource.product_object_id	Mappato direttamente
queryid	target.resource.product_object_id	Mappato direttamente
sessionID	target.resource.product_object_id	Mappato direttamente
transactionId	target.resource.product_object_id	Mappato direttamente
action	target.resource.resource_subtype	Mappato direttamente
name	target.resource.resource_subtype	Mappato direttamente
user_uuid	target.user.product_object_id	Mappato direttamente
username1	target.user.userid	Mappato direttamente
N/D	extensions.auth.type	Costante: AUTHTYPE_UNSPECIFIED
N/D	metadata.event_type	Costante: GENERIC_EVENT
N/D	metadata.log_type	Costante: APPIAN_CLOUD
N/D	metadata.product_name	Costante: Cloud Platform
N/D	metadata.vendor_name	Costante: Appian
N/D	security_result.severity	Costante: INFORMATIONAL
sessionID	event.idm.read_only_udm.network.session_id	Mappato dal log delle modifiche
transactionId	event.idm.read_only_udm.target.resource.product_object_id	Mappato dal log delle modifiche
versionDetails	event.idm.read_only_udm.security_result.about.platform_version	Mappato dal log delle modifiche
application	event.idm.read_only_udm.principal.application	Mappato dal log delle modifiche
IpAddress	event.idm.read_only_udm.principal.ip	Mappato dal log delle modifiche
IpAddress	event.idm.read_only_udm.principal.asset.ip	Mappato dal log delle modifiche
userId	event.idm.read_only_udm.principal.user.userid	Mappato dal log delle modifiche
rolesAllow	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
userRole	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
status	event.idm.read_only_udm.section_result.action_details	Mappato dal log delle modifiche
resourcename	event.idm.read_only_udm.target.resource.name	Mappato dal log delle modifiche
commandline	event.idm.read_only_udm.target.process.command_line	Mappato dal log delle modifiche
devicetimestamp	event.idm.read_only_udm.additional.fields	Mappato dal log delle modifiche
email	event.idm.read_only_udm.principal.user.email_addresses	Mappato dal log delle modifiche
document_name	target.files.names	Mappato dal log delle modifiche
msg" and "reason	security_result.summary	Mappato dal log delle modifiche
original_value", "setting_new_value", "setting_old_value", and "new_value	target.resource.attribute.labels	Mappato dal log delle modifiche
page_involved", "site_involved", and "page_group_involved	target.resource.attribute.labels	Mappato dal log delle modifiche
total_thread_count", "daemon_thread_count", used_heap_space", "available_heap_space", "tenured_generation_usage_after_collection", "tenured_generation_used", "tenured_generation_available", "permanent_generation_used", and "permanent_generation_available	additional.fields	Mappato dal log delle modifiche
young_collection_count", "young_cllection_time", "tenured_collection_count", "tenured_collection_time", "cpu_core_count", "total_system_memory", "used_system_memory", "total_swap_space", "used_swap_space", "load_average", and "session_count	additional.fields	Mappato dal log delle modifiche
record_identifier", "record_type_url_stub", "view", "filters", "environment", and "site_url_stub	target.resource.attribute.labels	Mappato dal log delle modifiche
data_store", "entity", and "operation_type	additional.fields	Mappato dal log delle modifiche
operation_name", "prepare_time", "transform_time", and "execute_time	additional.fields	Mappato dal log delle modifiche
connectionid	network.session.id	Mappato dal log delle modifiche
minimum_execution_time", "execution_count", "status_code_1xx_count", "status_code_2xx_count", "status_code_3xx_count", "status_code_4xx_count", "status_code_5xx_count", "minimum_response_size", "maximum_response_time", "maximum_response_size", "mean_execution_time", and "maximum_response_size	security_result.detection_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.