Skip to content

Commit be5b2d4

Browse files
committed
adding new ui steps
1 parent a58412f commit be5b2d4

File tree

3 files changed

+43
-43
lines changed

3 files changed

+43
-43
lines changed

articles/sentinel/sap/deploy-data-connector-agent-container.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Content in this article is relevant for your **security**, **infrastructure**, a
3434

3535
:::image type="content" source="media/deployment-steps/deploy-data-connector-agentless.png" alt-text="Diagram of the SAP solution deployment flow, highlighting the Connect your SAP system step." border="false":::
3636

37-
Content in this article is relevant for your **security** team, using information provided by your **SAP BASIS** teams.
37+
Content in this article is relevant for your **security** team.
3838

3939
:::zone-end
4040

@@ -60,11 +60,11 @@ Before you connect your SAP system to Microsoft Sentinel:
6060

6161
:::zone pivot="connection-agentless"
6262

63-
- Make sure that you have the Microsoft Sentinel **SAP Agentless** solution [installed in your Microsoft Sentinel workspace](deploy-sap-security-content.md)
63+
- Make sure that you have the Microsoft Sentinel **SAP Agentless** solution [installed in your Microsoft Sentinel workspace](deploy-sap-security-content.md) <!--what is this solution's new name?-->
6464

6565
- Make sure that your SAP system is fully [prepared for the deployment](preparing-sap.md).
6666

67-
- Make sure your DCR is configured as described in [Install the solution from the content hub](deploy-sap-security-content.md#install-the-solution-from-the-content-hub).
67+
<!--removed- Make sure your DCR is configured as described in [Install the solution from the content hub](deploy-sap-security-content.md#install-the-solution-from-the-content-hub).-->
6868

6969
:::zone-end
7070

@@ -235,7 +235,7 @@ While deployment is also supported from the command line, we recommend that you
235235
236236
1. In Microsoft Sentinel, select **Configuration > Data connectors**.
237237
238-
1. In the search bar, enter *SAP*. Select **Microsoft Sentinel for SAP** from the search results and then **Open connector page**.
238+
1. In the search bar, enter *SAP*. Select **Microsoft Sentinel for SAP - agent-based** from the search results and then **Open connector page**.
239239
240240
1. In the **Configuration** area, select **Add new agent (Preview)**.
241241
@@ -348,11 +348,11 @@ At this stage, the system's **Health** status is **Pending**. If the agent is up
348348
349349
## Connect your agentless data connector
350350
351-
1. In Microsoft Sentinel, go to the **Configuration > Data connectors** page and locate the **SAP ABAP and S/4 via cloud connector (Preview)** data connector.
351+
1. In Microsoft Sentinel, go to the **Configuration > Data connectors** page and locate the **Microsoft Sentinel for SAP - agent-less (Preview) (Preview)** data connector.
352352
353-
1. In the **Configuration** area, under **Connect an SAP integration suite to Microsoft Sentinel**, select **Add connection**.
353+
1. In the **Configuration** area, scroll down and select **Add SAP client**.
354354
355-
1. In the **Agentless connection** side pane, enter the following details:
355+
1. In the **Connect to an SAP Client** side pane, enter the following details:
356356
357357
| Field | Description |
358358
|-------------------------------|---------------------------------------|
@@ -362,11 +362,13 @@ At this stage, the system's **Health** status is **Pending**. If the agent is up
362362
| **Authorization server URL** | The *tokenurlurl* value taken from the Process Integration Runtime service key JSON file. For example: `https://your-tenant.authentication.region.hana.ondemand.com/oauth/token` |
363363
| **Integration Suite Endpoint** | The *url* value taken from the Process Integration Runtime service key JSON file. For example: `https://your-tenant.it-account-rt.cfapps.region.hana.ondemand.com` |
364364
365+
1. Select **Connect**.
366+
365367
## Customize data connector behavior (optional)
366368
367369
If the agentless data connector's default functionality doesn't fit your organization's needs, customize it using SAP Integration Suite value mapping.
368370
369-
Also, due to database performance issues, ingesting Change Docs logs Sybase isn't supported. We recommend that customers using Sybase turn off ingestion for Change Docs logs in the iflow by configuring the **collect-changedocs-logs** parameter.
371+
Also, due to database performance issues, ingesting Change Docs logs running on Sybase isn't supported. We recommend that customers using Sybase turn off ingestion for Change Docs logs in the iflow by configuring the **collect-changedocs-logs** parameter.
370372
371373
For more information, see [Customize your SAP agentless data connector for Microsoft Sentinel](configure-agentless.md).
372374

articles/sentinel/sap/preparing-sap.md

Lines changed: 30 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -19,18 +19,32 @@ zone_pivot_groups: sentinel-sap-connection
1919

2020
This article describes how to prepare your SAP environment for connecting to the SAP data connector. Preparation differs, depending on whether you're using the containerized data connector agent. Select the option at the top of the page that matches your environment.
2121

22-
This article is part of the second step in deploying the Microsoft Sentinel solution for SAP applications.
22+
:::zone pivot="connection-agent"
23+
This article is part of the second step in deploying the Microsoft Sentinel solution for SAP applications.
24+
25+
:::image type="content" source="media/deployment-steps/prepare-sap-environment.png" alt-text="Diagram of the deployment flow for the Microsoft Sentinel solution for SAP applications, with the preparing SAP step highlighted." border="false":::
26+
27+
The procedures in this article are typically performed by your **SAP BASIS** team.
28+
:::zone-end
29+
30+
:::zone pivot="connection-agentless"
31+
This article is part of the second step in deploying the Microsoft Sentinel solution for SAP applications. While steps that are performed in Microsoft Sentinel require that the solution be installed first, other preparations in the SAP environment can happen in parallel. <!--need new images across-->
2332

2433
:::image type="content" source="media/deployment-steps/prepare-sap-environment.png" alt-text="Diagram of the deployment flow for the Microsoft Sentinel solution for SAP applications, with the preparing SAP step highlighted." border="false":::
2534

26-
The procedures in this article are typically performed by your **SAP BASIS** team. If you're using the agentless solution, you might also need to involve your **security** team.
35+
Many of the procedures in this article are typically performed by your **SAP BASIS** team. Some steps include your **security** team too.
36+
:::zone-end
2737

2838
> [!IMPORTANT]
2939
> Microsoft Sentinel's agentless data connector for SAP is currently in PREVIEW. The [Azure Preview Supplemental Terms](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) include additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
3040
3141
## Prerequisites
3242

3343
- Before you start, make sure to review the [prerequisites for deploying the Microsoft Sentinel solution for SAP applications](prerequisites-for-deploying-sap-continuous-threat-monitoring.md).
44+
:::zone pivot="connection-agentless"
45+
- If you're working with the agentless solution, some steps are performed in Microsoft Sentinel and require that the [solution be installed first](deploy-sap-security-content.md).
46+
47+
:::zone-end
3448

3549
## Configure the Microsoft Sentinel role
3650

@@ -85,11 +99,14 @@ Some installations of SAP systems might not have audit logging enabled by defaul
8599

86100
We recommend that you configure auditing for *all* messages from the audit log, instead of only specific logs. Ingestion cost differences are generally minimal and the data is useful for Microsoft Sentinel detections and in post-compromise investigations and hunting.
87101

102+
:::zone pivot="connection-agentless"
103+
For full monitoring coverage with the agentless solution, we recommend that you enable monitoring on all client IDs of your monitored SAP systems, including clients 000 and 066.
104+
:::zone-end
105+
88106
For more information, see the [SAP community](https://community.sap.com/t5/application-development-blog-posts/analysis-and-recommended-settings-of-the-security-audit-log-sm19-rsau/ba-p/13297094) and [Collect SAP HANA audit logs in Microsoft Sentinel](collect-sap-hana-audit-logs.md).
89107

90108
## Configure your system to use SNC for secure connections
91109

92-
93110
By default, the SAP data connector agent connects to an SAP server using a remote function call (RFC) connection and a username and password for authentication.
94111

95112
However, you might need to make the connection on an encrypted channel or use client certificates for authentication. In these cases, use Smart Network Communications (SNC) from SAP to secure your data connections, as described in this section.
@@ -172,6 +189,16 @@ For more information, see [Database Collector in Background Processing](https://
172189

173190
For more information, see the [SAP documentation](https://help.sap.com/docs/integration-suite/sap-integration-suite/initial-setup).
174191

192+
## Perform initial connector configuration
193+
194+
1. In Microsoft Sentinel, go to the **Configuration > Data connectors** page and locate the **Microsoft Sentinel for SAP - agent-less (Preview) (Preview)** data connector.
195+
196+
1. In the **Configuration** area, expand and follow the instructions in the **Initial connector configuration - Run the steps below once:** area. These steps will require a mixture of your Security and SAP BASIS teams.
197+
198+
If, after you deploy the Azure resources step 1, the values in the steps 2 and 3 aren't automatically populated, close and re-expand step 1 to refresh the values in steps 2 and 3.
199+
200+
1. Scroll further down in the **Configuration** area, and expand and follow the instructions in the **Add monitored SAP Systems - Run the steps below for each monitored SAP system:** area for each SAP system you want to monitor.
201+
175202
## Configure SAP Cloud Connector settings
176203

177204
1. Install the SAP Cloud Connector. For more information, see the [SAP documentation](https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/installation).
@@ -216,36 +243,6 @@ For more information, see the [SAP documentation](https://help.sap.com/docs/inte
216243

217244
- **Location**: Only required when you connect multiple Cloud Connectors to the same BTP subaccount. For more information, see the [SAP Documentation](https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/parameters-influencing-communication-behavior).
218245

219-
## Configure SAP Integration Suite settings
220-
221-
Create a new OAuth2 client credential to store the connection details for the Microsoft Entra ID app registration that you'd created [earlier](deploy-sap-security-content.md#deployment).
222-
223-
When creating the credential, enter the following details:
224-
225-
- **Name:** `LogIngestionAPI`
226-
227-
- **Token Service URL:** `https://login.microsoftonline.com/<your Microsoft Entra ID tenant ID>/oauth2/v2.0/token`
228-
229-
- **Client ID**: `<your app registration client ID>`
230-
231-
- **Client Authentication**: Send as body parameter
232-
233-
- **Scope**: `https://monitor.azure.com//.default`
234-
235-
- **Content Type**: `application/x-www-form-urlencoded`
236-
237-
## Import and deploy the Microsoft Sentinel solution for SAP package
238-
239-
1. Download the Microsoft Sentinel solution for SAP package from [https://aka.ms/SAPAgentlessPackage](https://aka.ms/SAPAgentlessPackage).
240-
1. Import the downloaded package to SAP Integration Suite.
241-
1. Open the Microsoft Sentinel solution for SAP package and browse to the artifacts.
242-
1. Select **Send security logs to Microsoft - application layer** artifact.
243-
1. Select **Configure** and then enter your DCR details:
244-
245-
- **LogsIngestionURL** the Ingestion URL from the DCR's DCE, as saved [earlier](deploy-sap-security-content.md#install-the-solution-from-the-content-hub).
246-
- **DCRImmutableId**: The DCR's immutable ID, as saved [earlier](deploy-sap-security-content.md#install-the-solution-from-the-content-hub).
247-
248-
1. Select **Deploy** to deploy the i-flow using SAP Cloud Integration as the runtime service.
249246

250247
:::zone-end
251248

articles/sentinel/sap/prerequisites-for-deploying-sap-continuous-threat-monitoring.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,15 +91,16 @@ Typically, Azure prerequisites are managed by your **security** teams.
9191
| Prerequisite | Description |Required/optional |
9292
| ---- | ----------- |----------- |
9393
| **Permissions to create Azure resources** | You must have: <br><br>- The necessary permissions to deploy solutions from the Microsoft Sentinel content hub. For more information, see [Prerequisites for deploying Microsoft Sentinel solutions](../sentinel-solutions-deploy.md#prerequisites) and [Microsoft Entra built-in roles](/entra/identity/role-based-access-control/permissions-reference#application-administrator). <br>Owner on the Microsoft Sentinel resource group , required for:<br><br>- Creation of data collection rule and data collection endpoint.<br><br>- Monitoring Metrics Publisher role assignment on data collection rule. |Required |
94-
| **Permissions in** **Microsoft Entra**|You must have permissions in Microsoft Entra ID required to create app registrations. This permission can be obtained through membership of built-in Microsoft Entra ID role:<br><br>- Application Developer.|Required |
94+
| **Read permissions to shared keys for the workspace** | TBD DESCRIPTION OF THIS. The linked bookmark doesn't go anywhere. For more information, see [Install Log Analytics agent on Windows computers](/azure/azure-monitor/platform/agent-windows#obtain-workspace-id-and-key). | Required |
95+
| **Permissions in Microsoft Entra**|You must have permissions in Microsoft Entra ID required to create app registrations. This permission can be obtained through membership of built-in Microsoft Entra ID role:<br><br>- Application Developer.|Required |
9596

9697
## SAP prerequisites for the agentless data connector
9798

9899
We recommend that your **SAP BASIS** team verify and ensure SAP system prerequisites. We strongly recommend that any management of your SAP system is carried out by an experienced SAP system administrator.
99100

100101
| Prerequisite | Description |
101102
| ---- | ----------- |
102-
| **Supported SAP versions** | The **Agentless** solution supports SAP NetWeaver systems with [SAP_BASIS versions 750](https://userapps.support.sap.com/sap(bD1kZSZjPTAwMQ==)/support/pam/pam.html?smpsrv=https%3a%2f%2fwebsmp201.sap-ag.de#ts=60&s=netweaver%207.5&o=most_viewed%7Cdesc&st=l&rpp=20&page=1&pvnr=73554900100900000414&pt=g%7Cd) and above. |
103+
| **Supported SAP versions** | The **Agentless** solution supports SAP NetWeaver systems with [SAP_BASIS versions 750](https://userapps.support.sap.com/sap(bD1kZSZjPTAwMQ==)/support/pam/pam.html?smpsrv=https%3a%2f%2fwebsmp201.sap-ag.de#ts=60&s=netweaver%207.5&o=most_viewed%7Cdesc&st=l&rpp=20&page=1&pvnr=73554900100900000414&pt=g%7Cd) and above. <br><br>Change Docs logs running on Sybase aren't supported. If you're using Sybase, we recommend that you customize your system to turn off ingestion for Change Docs logs. For more information, see [Customize your SAP agentless data connector for Microsoft Sentinel (Preview)](configure-agentless.md).|
103104
| **SAP environment** | Your SAP environment must have: <br><br> The **RSAU_API_GET_LOG_DATA** function module, remote enabled on your SAP System. For more information, see the [SAP documentation](https://me.sap.com/notes/3054326/E). <br>An SAP BTP Subaccount with following services enabled: <br> - SAP Integration Suite <br>- SAP Process Integration Runtime <br>- Cloud Foundry Runtime<br> For more information, see the [SAP documentation](https://help.sap.com/docs/sap-hana-spatial-services/onboarding/creating-subaccount-on-sap-business-technology-platform-sap-btp ). [Trial accounts](https://developers.sap.com/tutorials/hcp-create-trial-account.html) are supported.<br><br>The [SAP Cloud Connector](https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/installation?locale=en-US) deployed <br><br>SAP NetWeaver version 7.5 or higher|
104105
| **SAP roles and permissions** | You must have the following roles in your SAP systems: <br><br>**In SAP NetWeaver 7.5+**: SAP Netweaver Administrator <br><br>**In SAP BTP, all of the following roles**:<br>- Subaccount administrator <br>- Integration Provisioner <br>- PI_Administrator <br>- PI_Integration_Developer <br>- PI_Business_Expert|
105106

0 commit comments

Comments
 (0)