Referência do arquivo Systemconfig.json

O arquivo systemconfig.json é usado para configurar o comportamento do coletor de dados. As opções de configuração são agrupadas em várias seções. Este artigo lista as opções disponíveis e fornece uma explicação para as opções.

Importante

A solução Microsoft Sentinel para aplicativos SAP® usa o novo arquivo systemconfig.json para versões de agente lançadas em ou após 22 de junho de 2023. Para versões anteriores do agente, você ainda deve usar o arquivo systemconfig.ini.

Estrutura do arquivo

{ 

"<SID_GUID>": { 

    "secrets_source": {...},

    "abap_central_instance": {...},

    "azure_credentials": {...},

    "file_extraction_abap": {...},

    "file_extraction_java": {...},

    "logs_activation_status" {...},

    "connector_configuration": {...},

    "abap_table_selector":: {...}

...

}

Seções do arquivo de configuração systemconfig

Nome da seção	Descrição
Fonte de segredos	Esta seção define o local em que as credenciais são armazenadas.
Instância Central do ABAP	Esta seção define as opções gerais da instância do SAP à qual se conectar.
Credenciais do Azure	Esta seção define as credenciais para se conectar ao Azure Log Analytics.
Extração de Arquivos ABAP	Esta seção define logs e credenciais extraídos do servidor ABAP usando a interface SAPControl.
Extração de Arquivos JAVA	Esta seção define logs e credenciais extraídos do servidor JAVA usando a interface SAPControl.
Status de Ativação de Logs	Esta seção define quais logs são extraídos do ABAP.
Configuração do Conector	Esta seção define diversas opções de conector.
Seletor de Tabela ABAP	Esta seção define quais logs de Dados Mestres do Usuário são extraídos do sistema ABAP.

Seção Fonte de Segredos

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

"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

    },

Seção Instância Central do ABAP

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

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

Seção Credenciais do Azure

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

 "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

    },

Seção Extração de Arquivo ABAP

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

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

Seção Extração de Arquivo JAVA

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

"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

    },

Seção Status da Ativação de Logs

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

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

Seção Configuração do Conector

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

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

Seção Seletor de Tabela ABAP

Observação

Remova todos os comentários antes de você usar esse arquivo para configuração e implantação.

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

Próximas etapas

Saiba mais sobre as aplicações da Solução do Microsoft Sentinel para SAP®:

• Implante as aplicações da Solução do Microsoft Sentinel para SAP®
• Pré-requisitos para implantar as aplicações da Solução do Microsoft Sentinel para SAP®
• Implantar as CRs (solicitações de alteração) do SAP e configurar a autorização
• Implantar e configurar a hospedagem de contêiner do agente do conector de dados do SAP
• Implantar o conteúdo de segurança do SAP
• Implantar o conector de dados Microsoft Sentinel para SAP com SNC
• Monitorar a integridade do seu sistema SAP
• Habilitar e configurar a auditoria do SAP
• Coletar logs de auditoria do SAP HANA

Solucionar problemas:

• Solucionar problemas de implantação de solução de aplicativos com a Solução do Microsoft Sentinel para SAP®

Arquivos de referência:

• Referência de dados de aplicações da solução do Microsoft Sentinel para SAP®
• Aplicações da Solução do Microsoft Sentinel para SAP®: referência de conteúdo de segurança
• Referência de script de início rápido
• Atualizar referência de script

Para obter mais informações, confira Soluções do Microsoft Sentinel.