Dokumentacja pliku Systemconfig.json

Plik systemconfig.json służy do konfigurowania zachowania modułu zbierającego dane. Opcje konfiguracji są pogrupowane w kilka sekcji. W tym artykule wymieniono dostępne opcje i wyjaśniono opcje.

Ważne

Rozwiązanie Microsoft Sentinel dla aplikacji SAP® używa nowego pliku systemconfig.json dla wersji agenta wydanych w dniu 22 czerwca 2023 r. lub po 22 czerwca 2023 r. W przypadku poprzednich wersji agenta należy nadal używać pliku systemconfig.ini.

Struktura plików

{ 

"<SID_GUID>": { 

    "secrets_source": {...},

    "abap_central_instance": {...},

    "azure_credentials": {...},

    "file_extraction_abap": {...},

    "file_extraction_java": {...},

    "logs_activation_status" {...},

    "connector_configuration": {...},

    "abap_table_selector":: {...}

...

}

Sekcje pliku konfiguracji systemu

Nazwa sekcji	opis
Źródło wpisów tajnych	W tej sekcji opisano miejsce przechowywania poświadczeń.
Wystąpienie centralne usługi ABAP	W tej sekcji zdefiniowano ogólne opcje wystąpienia SAP do nawiązania połączenia.
Azure Credentials	W tej sekcji zdefiniowano poświadczenia umożliwiające nawiązanie połączenia z usługą Azure Log Analytics.
Wyodrębnianie plików ABAP	W tej sekcji zdefiniowano dzienniki i poświadczenia wyodrębnione z serwera ABAP przy użyciu interfejsu SAPControl.
Wyodrębnianie plików JAVA	W tej sekcji zdefiniowano dzienniki i poświadczenia wyodrębnione z serwera JAVA przy użyciu interfejsu SAPControl.
Rejestruje stan aktywacji	W tej sekcji opisano, które dzienniki są wyodrębniane z protokołu ABAP.
Konfiguracja Połączenie or	W tej sekcji zdefiniowano różne opcje łącznika.
Selektor tabeli ABAP	W tej sekcji zdefiniowano, które dzienniki danych wzorca użytkownika są wyodrębniane z systemu ABAP.

Sekcja Źródło wpisów tajnych

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"secrets_source": {
  "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

    },

Sekcja wystąpienia centralnego abAP

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"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 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)
    },

Sekcja Poświadczenia platformy Azure

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

 "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

    },

Sekcja wyodrębniania plików ABAP

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"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 number

      "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
    },

Sekcja Wyodrębnianie plików JAVA

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"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

    },

Sekcja Stan aktywacji dzienników

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"logs_activation_status": {
      # GMT FORMAT
      # example - For OS Timezone = NZST (New Zealand Standard Time) use abaptz = GMT+12
      "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>",

Sekcja konfiguracji Połączenie or

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"connector_configuration": {
      "extractuseremail": "<True/False>",
      "apiretry": "<True/False>",
      "auditlogforcexal": "<True/False>",
      "auditlogforcelegacyfiles": "<True/False>",
      "azure_resource_id": "<Azure _ResourceId>",
      "timechunk": "<value>"
    },

Sekcja selektora tabel ABAP

Uwaga

Usuń wszystkie komentarze przed użyciem tego pliku do konfiguracji i wdrożenia.

"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>",
      "USRACL_FULL": "<True/False>"
    }

Następne kroki

Dowiedz się więcej o rozwiązaniu Microsoft Sentinel dla aplikacji SAP®:

• Wdrażanie rozwiązania Microsoft Sentinel dla aplikacji SAP®
• Wymagania wstępne dotyczące wdrażania rozwiązania Microsoft Sentinel dla aplikacji SAP®
• Wdrażanie żądań zmian (CRS) sap i konfigurowanie autoryzacji
• Wdrażanie i konfigurowanie kontenera hostowania agenta łącznika danych SAP
• Wdrażanie zawartości zabezpieczeń sap
• Wdrażanie usługi Microsoft Sentinel dla łącznika danych SAP za pomocą protokołu SNC
• Monitorowanie kondycji systemu SAP
• Włączanie i konfigurowanie inspekcji sap
• Zbieranie dzienników inspekcji oprogramowania SAP HANA

Rozwiązywanie problemów:

• Rozwiązywanie problemów z rozwiązaniem Microsoft Sentinel na potrzeby wdrażania rozwiązań SAP® Applications

Pliki referencyjne:

• Dokumentacja danych aplikacji SAP® dla rozwiązania Microsoft Sentinel
• Rozwiązanie Microsoft Sentinel dla aplikacji SAP®: dokumentacja zawartości zabezpieczeń
• Dokumentacja skryptu Kickstart
• Aktualizowanie odwołania do skryptu

Aby uzyskać więcej informacji, zobacz Rozwiązania usługi Microsoft Sentinel.