Informazioni di riferimento sul file Systemconfig.ini
Il file systemconfig.ini viene usato per configurare il comportamento dell'agente di raccolta dati. Le opzioni di configurazione vengono raggruppate in diverse sezioni. Questo articolo elenca le opzioni disponibili e fornisce una spiegazione delle opzioni.
Importante
La soluzione Microsoft Sentinel per le applicazioni SAP® usa il nuovo file systemconfig.json per le versioni dell'agente rilasciate il 22 giugno 2023. Per le versioni precedenti dell'agente, è comunque necessario usare il file systemconfig.ini .
Se si aggiorna la versione dell'agente, viene eseguita automaticamente la migrazione del file di configurazione.
Sezioni del file di configurazione systemconfig
Nome della sezione | Descrizione |
---|---|
Origine segreti | Questa sezione definisce dove vengono archiviate le credenziali. |
Istanza centrale ABAP | Questa sezione definisce le opzioni generali dell'istanza SAP a cui connettersi. |
Azure Credentials | Questa sezione definisce le credenziali per la connessione ad Azure Log Analytics. |
ABAP estrazione file | Questa sezione definisce i log e le credenziali estratti dal server ABAP usando l'interfaccia SAPControl. |
Java estrazione file | Questa sezione definisce i log e le credenziali estratti dal server JAVA usando l'interfaccia SAPControl. |
Registra lo stato di attivazione | Questa sezione definisce i log estratti da ABAP. |
Configurazione di Connessione or | Questa sezione definisce varie opzioni del connettore. |
Selettore tabella ABAP | Questa sezione definisce i log dei dati master utente estratti dal sistema ABAP. |
Sezione Origine segreti
secrets=AZURE_KEY_VAULT|DOCKER_FIXED
# Storage location of SAP credentials and Log Analytics workspace ID and key
# AZURE_KEY_VAULT - store in an Azure Key Vault. Requires keyvault option and intprefix option
# DOCKER_FIXED - store in systemconfig.ini file. Requires user, passwd, loganalyticswsid and publickey options
keyvault=<vaultname>
# Azure Keyvault name, in case secrets = AZURE_KEY_VAULT
intprefix=<prefix>
# intprefix - Prefix for variables created in Azure Key Vault
Sezione Istanza centrale ABAP
[ABAP Central Instance]
auth_type=PLAIN_USER_AND_PASSWORD|SNC_WITH_X509
# Authentication type - username/password authentication, or X.509 authentication
ashost=<hostname>
# FQDN, hostname, or IP address of the ABAP server
mshost=<hostname>
# FQDN, hostname, or IP address of the Message server
msserv=<portnumber>
# Port number, or service name (from /etc/services) of the message server
group=<logon group>
# Logon group of the message server
sysnr=<Instance number>
# Instance number of the ABAP server
sysid=<SID>
# System ID of the ABAP server
client=<Client Number>
# Client number of the ABAP server
user=<username>
# Username to use to connect to ABAP server. Used only when secrets setting in Secrets Source section is set to DOCKER_FIXED
passwd=<password>
# Password to use to connect to ABAP server. Used only when secrets setting in Secrets Source section is set to DOCKER_FIXED
snc_lib=<path to libsapcrypto>
# Full path, to the libsapcrypto.so
# Used when SNC is in use
# !!! Note: the path must be valid within the container!!!
snc_partnername=<distinguished name of the server certificate>
# p: -prefixed valid SAP server SNC name, which is equal to Distinguished Name(DN) of SAP server PSE
# Used when SNC is in use
snc_qop=<SNC protection level>
# More information available at https://docs.oracle.com/cd/E19509-01/820-5064/ggrpj/index.html
# Used when SNC is in use
snc_myname=<distinguished name of the client certificate>
# p: -prefixed valid client SNC name, which is equal to Distinguished Name(DN) of client PSE
# Used when SNC is in use
x509cert=<server certificate>
# Base64 encoded server certificate value in a single line (with leading ----BEGIN-CERTIFICATE--- and trailing ----END-CERTIFICATE---- removed)
Sezione Credenziali di Azure
[Azure Credentials]
loganalyticswsid=<workspace ID>
# Log Analytics workspace ID. Used only when secrets setting in Secrets Source section is set to DOCKER_FIXED
publickey=<publickey>
# Log Analytics workspace primary or secondary key. Used only when secrets setting in Secrets Source section is set to DOCKER_FIXED
Sezione ABAP estrazione file
[File Extraction ABAP]
osuser = <SAPControl username>
# Username to use to authenticate to SAPControl
ospasswd = <SAPControl password>
# Password to use to authenticate to SAPControl
appserver = <server>
#SAPControl server hostname/fqdn/IP address
instance = <instance>
#SAPControl instance name
abapseverity = <severity>
# 0 = All logs ; 1 = Warning ; 2 = Error
abaptz = <timezone>
# GMT FORMAT
# example - For OS Timezone = NZST (New Zealand Standard Time) use abaptz = GMT+12
Sezione JAVA estrazione file
[File Extraction JAVA]
javaosuser = <username>
# Username to use to authenticate to JAVA server
javaospasswd = <password>
# Password to use to authenticate to JAVA server
javaappserver = <server>
#JAVA server hostname/fqdn/IP address
javainstance = <instance number>
#JAVA instance number
javaseverity = <severity>
# 0 = All logs ; 1 = Warning ; 2 = Error
javatz = <timezone>
# GMT FORMAT
# example - For OS Timezone = NZST (New Zealand Standard Time) use abaptz = GMT+12
Sezione Stato attivazione log
[Logs Activation Status]
# The following logs are retrieved using RFC interface
# Specify True or False to configure whether log should be collected using the mentioned interface
ABAPAuditLog = <True/False>
ABAPJobLog = <True/False>
ABAPSpoolLog = <True/False>
ABAPSpoolOutputLog = <True/False>
ABAPChangeDocsLog = <True/False>
ABAPAppLog = <True/False>
ABAPWorkflowLog = <True/False>
ABAPCRLog = <True/False>
ABAPTableDataLog = <True/False>
# The following logs are retrieved using SAP Control interface and OS Login
ABAPFilesLogs = <True/False>
SysLog = <True/False>
ICM = <True/False>
WP = <True/False>
GW = <True/False>
# The following logs are retrieved using SAP Control interface and OS Login
JAVAFilesLogs = <True/False>
sezione Configurazione di Connessione or
extractuseremail = <True/False>
apiretry = <True/False>
auditlogforcexal = <True/False>
auditlogforcelegacyfiles = <True/False>
azure_resource_id = <Azure _ResourceId>
# Used to force a specific resource group for the SAP tables in Log Analytics, useful for applying RBAC on SAP data
# example - /subscriptions/1234568-qwer-qwer-qwer-123456789/resourcegroups/RESOURCE_GROUP_NAME/providers/microsoft.compute/virtualmachines/VIRTUAL_MACHINE_NAME
# for more information - https://learn.microsoft.com/azure/azure-monitor/logs/log-standard-columns#_resourceid.
timechunk = <value>
# Default timechunk value is 60 (minutes). For certain tables, the data connector retrieves data from the ABAP server using timechunks (collecting all events that occurred within a certain timestamp). On busy systems this may result in large datasets, so to reduce memory and CPU utilization footprint, consider configuring to a smaller value.
Sezione del selettore di tabella ABAP
[ABAP Table Selector]
# Specify True or False to configure whether table should be collected from the SAP system
AGR_TCODES_FULL = <True/False>
USR01_FULL = <True/False>
USR02_FULL = <True/False>
USR02_INCREMENTAL = <True/False>
AGR_1251_FULL = <True/False>
AGR_USERS_FULL = <True/False>
AGR_USERS_INCREMENTAL = <True/False>
AGR_PROF_FULL = <True/False>
UST04_FULL = <True/False>
USR21_FULL = <True/False>
ADR6_FULL = <True/False>
ADCP_FULL = <True/False>
USR05_FULL = <True/False>
USGRP_USER_FULL = <True/False>
USER_ADDR_FULL = <True/False>
DEVACCESS_FULL = <True/False>
AGR_DEFINE_FULL = <True/False>
AGR_DEFINE_INCREMENTAL = <True/False>
PAHI_FULL = <True/False>
AGR_AGRS_FULL = <True/False>
USRSTAMP_FULL = <True/False>
USRSTAMP_INCREMENTAL = <True/False>
SNCSYSACL_FULL = <True/False> (Preview)
USRACL_FULL = <True/False> (Preview)
Passaggi successivi
Altre informazioni sulla soluzione Microsoft Sentinel per le applicazioni SAP®:
- Distribuire la soluzione Microsoft Sentinel per le applicazioni SAP®
- Prerequisiti per la distribuzione della soluzione Microsoft Sentinel per le applicazioni SAP®
- Distribuire richieste di modifica SAP (CR) e configurare l'autorizzazione
- Distribuire il contenuto della soluzione dall'hub del contenuto
- Distribuire e configurare il contenitore che ospita l'agente del connettore dati SAP
- Distribuire microsoft Sentinel per il connettore dati SAP con SNC
- Monitorare l'integrità del sistema SAP
- Abilitare e configurare il controllo SAP
- Raccogliere i log di controllo di SAP HANA
Risoluzione dei problemi:
File di riferimento:
- Informazioni di riferimento sulla soluzione Microsoft Sentinel per i dati delle applicazioni SAP®
- Soluzione Microsoft Sentinel per le applicazioni SAP®: informazioni di riferimento sul contenuto di sicurezza
- Informazioni di riferimento sullo script Kickstart
- Informazioni di riferimento sullo script di aggiornamento
Per altre informazioni, vedere Soluzioni di Microsoft Sentinel.