Referens för Kickstart-distributionsskript för Data Connector-agenten för Microsoft Sentinel för SAP-program
Den här artikeln innehåller en referens till de konfigurerbara parametrar som är tillgängliga i kickstart-skriptet som används för att distribuera Data Connector-agenten för Microsoft Sentinel för SAP-program.
Mer information finns i Ansluta DITT SAP-system till Microsoft Sentinel.
Innehållet i den här artikeln är avsett för dina SAP BASIS-team .
Hemlig lagringsplats
Parameternamn: --keymode
Parametervärden: kvmi
, kvsi
, cfgf
Obligatoriskt: Nej. kvmi
antas som standard.
Beskrivning: Anger om hemligheter (användarnamn, lösenord, logganalys-ID och delad nyckel) ska lagras i en lokal konfigurationsfil eller i Azure Key Vault. Styr även om autentisering till Azure Key Vault görs med hjälp av den virtuella datorns Azure-systemtilldelade hanterade identitet eller en Microsoft Entra-registrerad programidentitet.
Om värdet kvmi
är inställt på används Azure Key Vault för att lagra hemligheter, och autentisering till Azure Key Vault görs med hjälp av den virtuella datorns Azure-systemtilldelade hanterade identitet.
Om värdet kvsi
är inställt på används Azure Key Vault för att lagra hemligheter, och autentisering till Azure Key Vault görs med hjälp av en Microsoft Entra-registrerad programidentitet. Användning av kvsi
läge kräver --appid
, --appsecret
och --tenantid
värden.
Om värdet cfgf
är inställt på används konfigurationsfilen som lagras lokalt för att lagra hemligheter.
Anslutningsläge för ABAP-server
Parameternamn: --connectionmode
Parametervärden: abap
, mserv
Obligatoriskt: Nej. Om det inte anges är abap
standardvärdet .
Beskrivning: Definierar om datainsamlaragenten ska ansluta till ABAP-servern direkt eller via en meddelandeserver. Använd abap
för att låta agenten ansluta direkt till ABAP-servern, vars namn du kan definiera med hjälp av parametern --abapserver
. Om du inte definierar namnet i förväg uppmanas du att ange det i skriptet. Använd mserv
för att ansluta via en meddelandeserver, i vilket fall du måste ange parametrarna --messageserverhost
, --messageserverport
och --logongroup
.
Plats för konfigurationsmapp
Parameternamn: --configpath
Parametervärden: <path>
Obligatoriskt: Nej, /opt/sapcon/<SID>
antas om det inte anges.
Beskrivning: Som standard initierar kickstart konfigurationsfilen, metadataplatsen till /opt/sapcon/<SID>
. Om du vill ange en alternativ plats för konfiguration och metadata använder du parametern --configpath
.
ABAP-serveradress
Parameternamn: --abapserver
Parametervärden: <servername>
Obligatoriskt: Nej. Om parametern inte har angetts och om parametern ABAP-serveranslutningsläge är inställd abap
på uppmanas du av skriptet att ange serverns värdnamn/IP-adress.
Beskrivning: Används endast om anslutningsläget är inställt på abap
, den här parametern innehåller det fullständigt kvalificerade domännamnet (FQDN), kortnamnet eller IP-adressen för ABAP-servern att ansluta till.
Systeminstansnummer
Parameternamn: --systemnr
Parametervärden: <system number>
Obligatoriskt: Nej. Om det inte anges uppmanas användaren att ange systemnumret.
Beskrivning: Anger det SAP-systeminstansnummer som ska anslutas till.
System-ID
Parameternamn: --sid
Parametervärden: <SID>
Obligatoriskt: Nej. Om det inte anges uppmanas användaren att ange system-ID:t.
Beskrivning: Anger det SAP-system-ID som ska anslutas till.
Klientnummer
Parameternamn: --clientnumber
Parametervärden: <client number>
Obligatoriskt: Nej. Om det inte anges uppmanas användaren att ange klientnumret.
Beskrivning: Anger det klientnummer som ska anslutas till.
Meddelandeservervärd
Parameternamn: --messageserverhost
Parametervärden: <servername>
Obligatoriskt: Ja, om ABAP-serveranslutningsläget är inställt på mserv
.
Beskrivning: Anger värdnamnet/ip-adressen för meddelandeservern som ska anslutas till. Kan bara användas om ABAP-serveranslutningsläget är inställt på mserv
.
Meddelandeserverport
Parameternamn: --messageserverport
Parametervärden: <portnumber>
Obligatoriskt: Ja, om ABAP-serveranslutningsläget är inställt på mserv
.
Beskrivning: Anger tjänstnamnet (porten) för meddelandeservern som ska anslutas till. Kan bara användas om ABAP-serveranslutningsläget är inställt på mserv
.
Inloggningsgrupp
Parameternamn: --logongroup
Parametervärden: <logon group>
Obligatoriskt: Ja, om ABAP-serveranslutningsläget är inställt på mserv
.
Beskrivning: Anger den inloggningsgrupp som ska användas när du ansluter till en meddelandeserver. Kan endast användas om ABAP-serveranslutningsläget är inställt på mserv
. Om namnet på inloggningsgruppen innehåller blanksteg bör de skickas med dubbla citattecken, som i exemplet --logongroup "my logon group"
.
Användarnamn för inloggning
Parameternamn: --sapusername
Parametervärden: <username>
Obligatoriskt: Nej. Om det inte anges uppmanas användaren att ange användarnamnet om de inte använder SNC (X.509) för autentisering.
Beskrivning: Användarnamn som används för att autentisera till ABAP-servern.
Inloggningslösenord
Parameternamn: --sappassword
Parametervärden: <password>
Obligatoriskt: Nej. Om det inte anges uppmanas användaren att ange lösenordet om de inte använder SNC (X.509) för autentisering. Lösenordsindata är maskerade.
Beskrivning: Lösenord som används för att autentisera till ABAP-servern.
NetWeaver SDK-filplats
Parameternamn: --sdk
Parametervärden: <filename>
Obligatoriskt: Nej. Skriptet försöker hitta filen nwrfc*.zip i den aktuella mappen. Om den inte hittas uppmanas användaren att ange en giltig NetWeaver SDK-arkivfil.
Beskrivning: NetWeaver SDK-filsökväg. Ett giltigt SDK krävs för att datainsamlaren ska fungera. Mer information finns i KRAV för SAP.
Företagsprogram-ID
Parameternamn: --appid
Parametervärden: <guid>
Obligatoriskt: Ja, om den hemliga lagringsplatsen är inställd på kvsi
.
Beskrivning: När autentiseringsläget för Azure Key Vault är inställt på kvsi
utförs autentisering till nyckelvalvet med hjälp av en företagsappsidentitet (tjänstens huvudnamn). Den här parametern anger program-ID:t.
Företagsprogramhemlighet
Parameternamn: --appsecret
Parametervärden: <secret>
Obligatoriskt: Ja, om den hemliga lagringsplatsen är inställd på kvsi
.
Beskrivning: När autentiseringsläget för Azure Key Vault är inställt på kvsi
utförs autentisering till nyckelvalvet med hjälp av en företagsappsidentitet (tjänstens huvudnamn). Den här parametern anger programhemligheten.
Klientorganisations-ID
Parameternamn: --tenantid
Parametervärden: <guid>
Obligatoriskt: Ja, om den hemliga lagringsplatsen är inställd på kvsi
.
Beskrivning: När autentiseringsläget för Azure Key Vault är inställt på kvsi
utförs autentisering till nyckelvalvet med hjälp av en företagsappsidentitet (tjänstens huvudnamn). Den här parametern anger Klient-ID för Microsoft Entra.
Namn på Key Vault
Parameternamn: --kvaultname
Parametervärden: <key vaultname>
Obligatoriskt: Nej. Om Den hemliga lagringsplatsen är inställd på kvsi
eller kvmi
uppmanas skriptet att ange värdet om det inte anges.
Beskrivning: Om den hemliga lagringsplatsen är inställd på kvsi
eller kvmi
ska nyckelvalvets namn (i FQDN-format) anges här.
Log Analytics-arbetsytans ID
Parameternamn: --loganalyticswsid
Parametervärden: <id>
Obligatoriskt: Nej. Om det inte anges frågar skriptet efter arbetsyte-ID:t.
Beskrivning: Log Analytics-arbetsyte-ID där datainsamlaren skickar data till. Om du vill hitta arbetsytans ID letar du upp Log Analytics-arbetsytan i Azure Portal: öppna Microsoft Sentinel, välj Inställningar i avsnittet Konfiguration, välj Inställningar för arbetsyta och välj sedan Agenthantering.
Log Analytics-nyckel
Parameternamn: --loganalyticskey
Parametervärden: <key>
Obligatoriskt: Nej. Om det inte anges frågar skriptet efter arbetsytenyckeln. Indata är maskerade.
Beskrivning: Primär eller sekundär nyckel för Log Analytics-arbetsytan där datainsamlaren skickar data till. Leta reda på arbetsytans primära eller sekundära nyckel genom att leta upp Log Analytics-arbetsytan i Azure Portal: öppna Microsoft Sentinel, välj Inställningar i avsnittet Konfiguration, välj Inställningar för arbetsyta och välj sedan Agenthantering.
Använda X.509 (SNC) för autentisering
Parameternamn: --use-snc
Parametervärden: Ingen
Obligatoriskt: Nej. Om det inte anges används användarnamnet och lösenordet för autentisering. Om det anges --cryptolib
krävs , --sapgenpse
, kombination av antingen --client-cert
och --client-key
, eller --client-pfx
samt --client-pfx-passwd
--server-cert
, och i vissa fall --cacert
växlar.
Beskrivning: Anger att X.509-autentisering används för att ansluta till ABAP-servern i stället för autentisering med användarnamn/lösenord. Mer information finns i Konfigurera systemet att använda SNC för säkra anslutningar.
Sökväg till sap-kryptografiskt bibliotek
Parameternamn: --cryptolib
Parametervärden: <sapcryptolibfilename>
Obligatoriskt: Ja, om --use-snc
har angetts.
Beskrivning: Plats och filnamn för SAP Cryptographic Library (libsapcrypto.so).
SAPGENPSE-verktygssökväg
Parameternamn: --sapgenpse
Parametervärden: <sapgenpsefilename>
Obligatoriskt: Ja, om --use-snc
har angetts.
Beskrivning: Plats och filnamn för sapgenpse-verktyget för skapande och hantering av PSE-filer och SSO-autentiseringsuppgifter.
Sökväg till offentlig nyckel för klientcertifikat
Parameternamn: --client-cert
Parametervärden: <client certificate filename>
Obligatoriskt: Ja, om --use-snc
och certifikatet är i .crt/.key base-64-format.
Beskrivning: Plats och filnamn för det offentliga base-64-klientcertifikatet. Om klientcertifikatet är i .pfx-format använder du --client-pfx
växeln i stället.
Sökväg till privat nyckel för klientcertifikat
Parameternamn: --client-key
Parametervärden: <client key filename>
Obligatoriskt: Ja, om --use-snc
anges och nyckeln är i .crt/.key base-64-format.
Beskrivning: Plats och filnamn för den privata base-64-klientens nyckel. Om klientcertifikatet är i .pfx-format använder du --client-pfx
växeln i stället.
Certifikat för utfärdande/rotcertifikatutfärdare
Parameternamn: --cacert
Parametervärden: <trusted ca cert>
Obligatoriskt: Ja, om --use-snc
anges och certifikatet utfärdas av en företagscertifikatutfärdare.
Beskrivning: Om certifikatet är självsignerat har det ingen utfärdande certifikatutfärdare, så det finns ingen förtroendekedja som behöver verifieras.
Om certifikatet utfärdas av en företagscertifikatutfärdare måste certifikatutfärdarcertifikatet och eventuella certifikat på högre nivå verifieras. Använd separata instanser av växeln --cacert
för varje certifikatutfärdare i förtroendekedjan och ange fullständiga filnamn för de offentliga certifikaten för företagscertifikatutfärdarna.
Klient-PFX-certifikatsökväg
Parameternamn: --client-pfx
Parametervärden: <pfx filename>
Obligatoriskt: Ja, om --use-snc
och nyckeln är i .pfx/.p12-format.
Beskrivning: Plats och filnamn för pfx-klientcertifikatet.
Lösenord för KLIENT-PFX-certifikat
Parameternamn: --client-pfx-passwd
Parametervärden: <password>
Obligatoriskt: Ja, om --use-snc
det används är certifikatet i .pfx/.p12-format och certifikatet skyddas av ett lösenord.
Beskrivning: PFX/P12-fillösenord.
Servercertifikat
Parameternamn: --server-cert
Parametervärden: <server certificate filename>
Obligatoriskt: Ja, om --use-snc
används.
Beskrivning: Fullständig sökväg och namn för ABAP-servercertifikatet.
URL för HTTP-proxyserver
Parameternamn: --http-proxy
Parametervärden: <proxy url>
Obligatoriskt: Nej
Beskrivning: Containrar som inte kan upprätta en anslutning till Microsoft Azure-tjänster direkt och som kräver en anslutning via en proxyserver kräver också en --http-proxy
växel för att definiera proxy-URL:en för containern. Formatet för proxy-URL:en är http://hostname:port
.
Värdbaserat nätverk
Parameternamn: --hostnetwork
Obligatoriskt: Nej.
Beskrivning: Om växeln hostnetwork
anges använder agenten en värdbaserad nätverkskonfiguration. Detta kan lösa interna DNS-matchningsproblem i vissa fall.
Bekräfta alla frågor
Parameternamn: --confirm-all-prompts
Parametervärden: Ingen
Obligatoriskt: Nej
Beskrivning: Om växeln --confirm-all-prompts
har angetts pausar skriptet inte för några användarbekräftelser och frågar bara om användarens indata krävs. Använd växeln --confirm-all-prompts
för en zero-touch-distribution.
Använda förhandsversion av containern
Parameternamn: --preview
Parametervärden: Ingen
Obligatoriskt: Nej
Beskrivning: Som standard distribuerar kickstartskriptet för containerdistribution containern med taggen :latest
. Offentliga förhandsgranskningsfunktioner publiceras till taggen :latest-preview
. Om du vill att containerdistributionsskriptet ska använda den offentliga förhandsversionen av containern anger du växeln --preview
.
Relaterat innehåll
Mer information finns i: