Skip to content

Commit 64a0da0

Browse files
committed
fixing workspace references
1 parent 747d36b commit 64a0da0

12 files changed

+37
-44
lines changed

articles/sentinel/sap/cross-workspace.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.collection: usx-security
1818

1919
When you set up your Log Analytics workspace enabled for Microsoft Sentinel, you have [multiple architecture options](/azure/azure-monitor/logs/workspace-design?toc=/azure/sentinel/TOC.json&bc=/azure/sentinel/breadcrumb/toc.json) and factors to consider. Taking into account geography, regulation, access control, and other factors, you might choose to have multiple workspaces in your organization.
2020

21-
When working with SAP, your SAP and SOC teams might need to work in spearate workspaces to maintain security boundaries. You might not want the SAP team to have visibility into all other security logs across your organization. However, the SAP BASIS team plays a critical role in successfully implementing and maintaining the Microsoft Sentinel solution for SAP applications. Their technical knowledge is essential for effectively monitoring SAP systems, configuring security settings, and ensuring that proper incident response procedures are in place. For this reason, the SAP BASIS team must have access to the Microsoft Sentinel workspace, allowing them to collaborate with the SOC team while focusing specifically on SAP-related security monitoring.
21+
When working with SAP, your SAP and SOC teams might need to work in spearate workspaces to maintain security boundaries. You might not want the SAP team to have visibility into all other security logs across your organization. However, the SAP BASIS team plays a critical role in successfully implementing and maintaining the Microsoft Sentinel solution for SAP applications. Their technical knowledge is essential for effectively monitoring SAP systems, configuring security settings, and ensuring that proper incident response procedures are in place. For this reason, the SAP BASIS team must have access to the Log Analytics workspace enabled for Microsoft Sentinel, allowing them to collaborate with the SOC team while focusing specifically on SAP-related security monitoring.
2222

2323
This article discusses how to work with the Microsoft Sentinel solution for SAP applications in multiple workspaces, with improved flexibility for:
2424

articles/sentinel/sap/deploy-command-line.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -109,9 +109,9 @@ This procedure describes how to create a new agent and connect it to your SAP sy
109109

110110
You'll use the name of the docker container in the next step.
111111
112-
1. Deploying the SAP data connector agent requires that you grant your agent's VM identity with specific permissions to the Microsoft Sentinel workspace, using the **Microsoft Sentinel Business Applications Agent Operator** and **Reader** roles.
112+
1. Deploying the SAP data connector agent requires that you grant your agent's VM identity with specific permissions to the Log Analytics workspace enabled for Microsoft Sentinel, using the **Microsoft Sentinel Business Applications Agent Operator** and **Reader** roles.
113113

114-
To run the command in this step, you must be a resource group owner on your Microsoft Sentinel workspace. If you aren't a resource group owner on your workspace, this procedure can also be performed later on.
114+
To run the command in this step, you must be a resource group owner on the Log Analytics workspace enabled for Microsoft Sentinel. If you aren't a resource group owner on your workspace, this procedure can also be performed later on.
115115
116116
Assign the **Microsoft Sentinel Business Applications Agent Operator** and **Reader** roles to the VM's identity:
117117

@@ -136,9 +136,9 @@ This procedure describes how to create a new agent and connect it to your SAP sy
136136
|Placeholder |Value |
137137
|---------|---------|
138138
|`<OBJ_ID>` | Your VM identity object ID. <br><br> To find your VM identity object ID in Azure: <br>- **For a managed identity**, the object ID is listed on the VM's **Identity** page. <br>- **For a service principal**, go to **Enterprise application** in Azure. Select **All applications** and then select your VM. The object ID is displayed on the **Overview** page. |
139-
|`<SUB_ID>` | Your Microsoft Sentinel workspace subscription ID |
140-
|`<RESOURCE_GROUP_NAME>` | Your Microsoft Sentinel workspace resource group name |
141-
|`<WS_NAME>` | Your Microsoft Sentinel workspace name |
139+
|`<SUB_ID>` | The subscription ID for you Log Analytics workspace enabled for Microsoft Sentinel |
140+
|`<RESOURCE_GROUP_NAME>` | The resource group name for your Log Analytics workspace enabled for Microsoft Sentinel |
141+
|`<WS_NAME>` | The name of your Log Analytics workspace enabled for Microsoft Sentinel |
142142
|`<AGENT_IDENTIFIER>` | The agent ID displayed after running the command in the [previous step](#agent-id-managed). |
143143
144144
1. To configure the Docker container to start automatically, run the following command, replacing the `<container-name>` placeholder with the name of your container:
@@ -192,9 +192,9 @@ Azure Key Vault is the recommended method to store your authentication credentia
192192
193193
You'll use the name of the docker container in the next step.
194194
195-
1. Deploying the SAP data connector agent requires that you grant your agent's VM identity with specific permissions to the Microsoft Sentinel workspace, using the **Microsoft Sentinel Business Applications Agent Operator** and **Reader** roles.
195+
1. Deploying the SAP data connector agent requires that you grant your agent's VM identity with specific permissions to the Log Analytics workspace enabled for Microsoft Sentinel, using the **Microsoft Sentinel Business Applications Agent Operator** and **Reader** roles.
196196
197-
To run the commands in this step, you must be a resource group owner on your Microsoft Sentinel workspace. If you aren't a resource group owner on your workspace, this step can also be performed later on.
197+
To run the commands in this step, you must be a resource group owner on your workspace. If you aren't a resource group owner on your workspace, this step can also be performed later on.
198198
199199
Assign the **Microsoft Sentinel Business Applications Agent Operator** and **Reader** roles to the VM's identity:
200200
@@ -219,9 +219,9 @@ Azure Key Vault is the recommended method to store your authentication credentia
219219
|Placeholder |Value |
220220
|---------|---------|
221221
|`<OBJ_ID>` | Your VM identity object ID. <br><br> To find your VM identity object ID in Azure: For a managed identity, the object ID is listed on the VM's **Identity** page. For a service principal, go to **Enterprise application** in Azure. Select **All applications** and then select your VM. The object ID is displayed on the **Overview** page. |
222-
|`<SUB_ID>` | Your Microsoft Sentinel workspace subscription ID |
223-
|`<RESOURCE_GROUP_NAME>` | Your Microsoft Sentinel workspace resource group name |
224-
|`<WS_NAME>` | Your Microsoft Sentinel workspace name |
222+
|`<SUB_ID>` | The subscription ID for your Log Analytics workspace enabled for Microsoft Sentinel |
223+
|`<RESOURCE_GROUP_NAME>` | The resource group name for your Log Analytics workspace enabled for Microsoft Sentinel |
224+
|`<WS_NAME>` | The name of your Log Analytics workspace enabled for Microsoft Sentinel |
225225
|`<AGENT_IDENTIFIER>` | The agent ID displayed after running the command in the [previous step](#agent-id-file). |
226226
227227
1. Run the following command to configure the Docker container to start automatically.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -296,7 +296,7 @@ While deployment is also supported from the command line, we recommend that you
296296
297297
:::image type="content" source="media/deploy-data-connector-agent-container/finish-agent-deployment-role.png" alt-text="Screenshot of the Copy icon for the command from step 1.":::
298298
299-
To find your VM identity object ID in Azure: <!--confirm this with Dvir-->
299+
To find your VM identity object ID in Azure:
300300
301301
- For a managed identity, the object ID is listed on the VM's **Identity** page.
302302
@@ -348,7 +348,7 @@ While deployment is also supported from the command line, we recommend that you
348348
349349
When you're done, select **Next: Authentication**.
350350
351-
For example: <!--can we get a screenshot with an example?-->
351+
For example:
352352
353353
:::image type="content" source="media/deploy-data-connector-agent-container/create-system.png" alt-text="Screenshot of the Add new system area's System settings tab.":::
354354

articles/sentinel/sap/deploy-sap-security-content.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Install the Microsoft Sentinel solution for SAP applications
3-
description: Learn how to install the Microsoft Sentinel solution for SAP applications from the content hub to your Microsoft Sentinel workspace.
3+
description: Learn how to install the Microsoft Sentinel solution for SAP applications from the content hub to your Log Analytics workspace enabled for Microsoft Sentinel.
44
author: batamig
55
ms.author: bagol
66
ms.topic: how-to
@@ -16,7 +16,7 @@ ms.collection: usx-security
1616

1717
# Install the Microsoft Sentinel solution for SAP applications
1818

19-
The Microsoft Sentinel solution for SAP applications includes the SAP data connector, which collects logs from your SAP systems and sends them to your Microsoft Sentinel workspace, and out-of-the-box security content, which helps you gain insight into your organization's SAP environment and detect and respond to security threats. Installing your solution is a required step before you can configure your data connector agent container.
19+
The Microsoft Sentinel solution for SAP applications includes the SAP data connector, which collects logs from your SAP systems and sends them to your Log Analytics workspace enabled for Microsoft Sentinel, and out-of-the-box security content, which helps you gain insight into your organization's SAP environment and detect and respond to security threats. Installing your solution is a required step before you can configure your data connector agent container.
2020

2121
:::image type="content" source="media/deployment-steps/install-solution.png" alt-text="Diagram of the SAP solution deployment flow, highlighting the Install solution content step." border="false":::
2222

@@ -27,23 +27,23 @@ Content in this article is relevant for your **security** team.
2727
To deploy the Microsoft Sentinel solution for SAP applications from the content hub, you need:
2828

2929
- A Log Analytics workspace enabled for Microsoft Sentinel.
30-
- Read and write permissions to the workspace. For more information, see [Roles and permissions in Microsoft Sentinel](../roles.md). <!--make them all like this-->
30+
- Read and write permissions to the workspace. For more information, see [Roles and permissions in Microsoft Sentinel](../roles.md).
3131

3232
Make sure that you also review the [prerequisites for deploying Microsoft Sentinel solution for SAP applications](prerequisites-for-deploying-sap-continuous-threat-monitoring.md), especially [Azure prerequisites](prerequisites-for-deploying-sap-continuous-threat-monitoring.md#azure-prerequisites).
3333

3434
## Install the solution from the content hub
3535

3636
Installing the Microsoft Sentinel solution for SAP applications makes the Microsoft Sentinel for SAP data connector available for you in as a Microsoft Sentinel data connector. The solution also deploys security content, such as the **SAP - System Applications and Products** workbook and SAP-related analytics rules.
3737

38-
1. In the Microsoft Sentinel **Content hub**, search for the **SAP applications** solution and install it on your Microsoft Sentinel workspace.
38+
1. In the Microsoft Sentinel **Content hub**, search for the **SAP applications** solution and install it on your Log Analytics workspace enabled for Microsoft Sentinel.
3939

4040
1. On the **Microsoft Sentinel solution for SAP applications** page, select **Create** to define deployment settings. For example:
4141

4242
:::image type="content" source="./media/deploy-sap-security-content/sap-solution.png" alt-text="Screenshot that shows the Microsoft Sentinel solution for SAP applications solution pane." lightbox="./media/deploy-sap-security-content/sap-solution.png":::
4343

4444
1. On the **Basics** tab, under **Project details**, select the **Subscription** and **Resource group** where you want to install the solution.
4545

46-
1. Under **Instance details**, select the **Microsoft Sentinel workspace** where you want to install the solution.
46+
1. Under **Instance details**, select the Log Analytics workspace enabled for Microsoft Sentinel where you want to install the solution.
4747

4848
If you're working with [the Microsoft Sentinel solution for SAP applications in multiple workspaces](cross-workspace.md), select **Some of the data is on a different workspace**, and then define your target workspace, your SOC workspace, and SAP workspace. For example:
4949

@@ -53,7 +53,7 @@ Installing the Microsoft Sentinel solution for SAP applications makes the Micros
5353

5454
1. Select **Review + create** or **Next** to browse through the solution components. When you're ready, select **Create**
5555

56-
The deployment process can take a few minutes. After the deployment is finished, you can view the deployed content in your Microsoft Sentinel workspace.
56+
The deployment process can take a few minutes. After the deployment is finished, you can view the deployed content in Microsoft Sentinel.
5757

5858
> [!TIP]
5959
> If you want the SAP and SOC data to be kept on the same workspace with no additional access controls, do not select **Some of the data is on a different workspace**. In such cases, for more information, see [SAP and SOC data maintained in the same workspace](cross-workspace.md#sap-and-soc-data-maintained-in-the-same-workspace).

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Typically, Azure prerequisites are managed by your **security** teams.
2727

2828
| Prerequisite | Description |Required/optional |
2929
| ---- | ----------- |----------- |
30-
| **Access to Microsoft Sentinel** | Make a note of your Microsoft Sentinel *workspace ID* and *primary key*.<br>You can find these details in Microsoft Sentinel: from the navigation menu, select **Settings** > **Workspace settings** > **Agents management**. Copy the *Workspace ID* and *Primary key* and paste them aside for use during the deployment process. |Required |
30+
| **Access to Microsoft Sentinel** | Make a note of your *workspace ID and *primary key* for your Log Analytics workspace enabled for Microsoft Sentinel.<br>You can find these details in Microsoft Sentinel: from the navigation menu, select **Settings** > **Workspace settings** > **Agents management**. Copy the *Workspace ID* and *Primary key* and paste them aside for use during the deployment process. |Required |
3131
| **Permissions to create Azure resources** | At a minimum, you must have 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). |Required |
3232
| **Permissions to create an Azure key vault or access an existing one** | Use Azure Key Vault to store secrets required to connect to your SAP system. For more information, see [Assign key vault access permissions](deploy-data-connector-agent-container.md#assign-key-vault-access-permissions). |Required if you plan to store the SAP system credentials in Azure Key Vault. <br><br>Optional if you plan to store them in a configuration file. For more information, see [Create a virtual machine and configure access to your credentials](deploy-data-connector-agent-container.md#create-a-virtual-machine-and-configure-access-to-your-credentials).|
3333
| **Permissions to assign a privileged role to the SAP data connector agent** | Deploying the SAP data connector agent requires that you grant your agent's VM identity with specific permissions to the Microsoft Sentinel workspace, using the **Microsoft Sentinel Business Applications Agent Operator** role. To grant this role, you need **Owner** permissions on the resource group where your Microsoft Sentinel workspace resides. <br><br>For more information, see [Connect your SAP system by deploying your data connector agent container](deploy-data-connector-agent-container.md). | Required. <br> If you don't have **Owner** permissions on the resource group, the relevant step can also be performed by another user who does have the relevant permissions, separately after the agent is fully deployed.|

articles/sentinel/sap/sap-audit-controls-workbook.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ Before you can start using the **SAP - Security Audit log and Initial Access** w
3535

3636
- The Microsoft Sentinel solution for SAP applications solution installed and a data connector agent deployed. For more information, see [Deploy Microsoft Sentinel solution for SAP applications](deployment-overview.md).
3737

38-
- The **SAP Audit Controls** workbook installed in your Microsoft Sentinel workspace. For more information, see and [Visualize and monitor your data by using workbooks in Microsoft Sentinel](../monitor-your-data.md).
38+
- The **SAP Audit Controls** workbook installed in your Log Analytics workspace enabled for Microsoft Sentinel. For more information, see and [Visualize and monitor your data by using workbooks in Microsoft Sentinel](../monitor-your-data.md).
3939

40-
- At least one incident in your Microsoft Sentinel workspace, with at least one entry available in the `SecurityIncident` table. This doesn't need to be an SAP incident, and you can generate a demo incident using a basic analytics rule if you don't have another one.
40+
- At least one incident in your workspace, with at least one entry available in the `SecurityIncident` table. This doesn't need to be an SAP incident, and you can generate a demo incident using a basic analytics rule if you don't have another one.
4141

4242
## View a demo
4343

articles/sentinel/sap/sap-audit-log-workbook.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Before you can start using the **SAP - Security Audit log and Initial Access** w
3232

3333
- The Microsoft Sentinel solution for SAP applications solution installed and a data connector agent deployed. For more information, see [Deploy Microsoft Sentinel solution for SAP applications](deployment-overview.md).
3434

35-
- The **SAP - Security Audit log and Initial Access** workbook installed in your Microsoft Sentinel workspace. For more information, see [Visualize and monitor your data by using workbooks in Microsoft Sentinel](../monitor-your-data.md).
35+
- The **SAP - Security Audit log and Initial Access** workbook installed in your Log Analytics workspace enabled for Microsoft Sentinel. For more information, see [Visualize and monitor your data by using workbooks in Microsoft Sentinel](../monitor-your-data.md).
3636

3737
> [!IMPORTANT]
3838
> The **SAP - Security Audit log and Initial Access** workbook is hosted by the workspace where the Microsoft Sentinel solution for SAP applications were installed. By default, both the SAP and the SOC data is assumed to be on the workspace that hosts the workbook.

articles/sentinel/sap/sap-deploy-troubleshoot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ The change takes effect approximately two minutes after you save the file. You d
152152
1. Verify whether messages arrive and exist in the SAP **SM20** or **RSAU_READ_LOG**, without any special errors appearing on the connector log.
153153

154154

155-
### Incorrect Microsoft Sentinel workspace ID or key in key vault
155+
### Incorrect workspace ID or key in key vault
156156

157157
If you realize that you've entered an incorrect workspace ID or key in your deployment script, update the credentials stored in Azure key vault.
158158

articles/sentinel/sap/sap-solution-deploy-alternate.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,8 +141,8 @@ This procedure describes how to deploy the Microsoft Sentinel for SAP data conne
141141
# env.list template for Credentials
142142
SAPADMUSER=<SET_SAPCONTROL_USER>
143143
SAPADMPASSWORD=<SET_SAPCONTROL_PASS>
144-
LOGWSID=<SET SENTINEL WORKSPACE id>
145-
LOGWSPUBLICKEY=<SET SENTINEL WORKSPACE KEY>
144+
LOGWSID=<SET MICROSOFT SENTINEL WORKSPACE ID>
145+
LOGWSPUBLICKEY=<SET MICROSOFT SENTINEL WORKSPACE KEY>
146146
ABAPUSER=SET_ABAP_USER>
147147
ABAPPASS=<SET_ABAP_PASS>
148148
JAVAUSER=<SET_JAVA_OS_USER>

0 commit comments

Comments
 (0)