Skip to content

Commit d6fd6fb

Browse files
author
ecfan
committed
Update SNC screenshots and remove ISE screenshots
1 parent de8278e commit d6fd6fb

File tree

8 files changed

+35
-23
lines changed

8 files changed

+35
-23
lines changed
Binary file not shown.
Binary file not shown.
14.2 KB
Loading
Binary file not shown.
-18.7 KB
Loading
Binary file not shown.
19.9 KB
Loading

articles/logic-apps/connectors/sap.md

Lines changed: 35 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -527,43 +527,41 @@ For more information about SNC, see [Getting started with SAP SNC for RFC integr
527527
528528
1. In the [Azure portal](https://portal.azure.com), open your Consumption logic app and workflow in the designer.
529529
530-
1. Add or edit an SAP managed connector operation.
530+
1. Add an SAP managed connector operation or edit the connection for an existing operation.
531531
532-
1. In the SAP connection information box, provide the following [required information](/connectors/sap/#default-connection). The **Authentication Type** that you select changes the available options.
533-
534-
![Screenshot showing SAP connection settings for Consumption.](./media/sap/sap-connection-consumption.png)
532+
1. In the SAP connection information box, provide the [required information](/connectors/sap/#default-connection), based on the **Authentication Type** that you select.
535533
536534
> [!NOTE]
537535
>
538536
> The **SAP Username** and **SAP Password** fields are optional. If you don't provide a username
539537
> and password, the connector uses the client certificate provided in a later step for authentication.
540538
541-
1. To enable SNC, in the SAP connection information box, provide the following required information instead:
539+
:::image type="content" source="media/sap/sap-connection.png" alt-text="Screenshot shows SAP connection parameters in Consumption workflows.":::
542540
543-
![Screenshot showing SAP connection settings for SNC enabled for Consumption.](./media/sap/sap-connection-snc-consumption.png)
541+
1. To enable SNC, in the SAP connection information box, provide the following required information instead:
544542
545543
| Parameter | Description |
546544
|-----------|-------------|
547-
| **Use SNC** | Select the checkbox. |
545+
| **Use SNC** | Select this option. |
548546
| **SNC Library** | Enter one of the following values: <br><br>- The name for your SNC library, for example, **sapsnc.dll** <br>- The relative path to the NCo installation location, for example, **.\security\sapsnc.dll** <br>- The absolute path to the NCo installation location, for example, **c:\security\sapsnc.dll** |
549547
| **SNC SSO** | Select either **Logon using the SNC identity** or **Logon with the username/password provided on RFC level**. <br><br>Typically, the SNC identity is used to authenticate the caller. You can choose to authenticate with a username and password instead, but this parameter value is still encrypted. |
550548
| **SNC My Name** | In most cases, you can omit this value. The installed SNC solution usually knows its own SNC name. In the case where your solution supports multiple identities, you might have to specify the identity to use for this particular destination or server. |
551549
| **SNC Partner Name** | Enter the name for the backend SNC, for example, **p:CN=DV3, OU=LA, O=MS, C=US**. |
552550
| **SNC Quality of Protection** | Select the quality of service to use for SNC communication with this particular destination or server. The default value is defined by the backend system. The maximum value is defined by the security product used for SNC. |
553551
| **SNC Certificate** | Enter the base64-encoded *public* key for the certificate to use for identifying your client to SAP. <br><br>**Note**: - Don't include the PEM header or footer. <br><br>- Don't enter the private key for the client certificate here. Your Personal Security Environment (PSE) must contain the matching private key for this certificate and might contain other private certificates. For more information, review the next parameter. |
554-
| **PSE** | Enter your SNC Personal Security Environment (PSE) as a base64-encoded binary. <br><br>- Your PSE must contain the private key for the client certificate where the thumbprint matches the public key for the client certificate in the **SNC Certificate** parameter. <br><br>- Although your PSE might contain multiple client certificates, to use different client certificates, create separate workflows instead. <br><br>- If you're using more than one SNC client certificate for your Standard logic app resource, you must provide the same PSE for all connections. Your PSE must contain the matching private key for the client certificate for each and all the connections. You must set the **SNC Certificate** parameter to match the specific private certificate for each connection. |
555-
556-
1. To finish creating your connection, select **Create**.
552+
| **PSE** | Enter your SNC Personal Security Environment (PSE) as a base64-encoded binary. <br><br>- Your PSE must contain the private key for the client certificate where the thumbprint matches the public key for the client certificate in the **SNC Certificate** parameter. <br><br>- Although your PSE might contain multiple client certificates, to use different client certificates, create separate workflows instead. |
557553
558-
If the parameters are correct, the connection is created. If there's a problem with the parameters, the connection creation dialog displays an error message. To troubleshoot connection parameter issues, you can use the on-premises data gateway installation and the gateway's local logs.
554+
![Screenshot shows SAP connection parameters with SNC enabled for Consumption workflow.](./media/sap/sap-connection-snc-consumption.png)
559555
556+
1. To finish creating your connection, select **Create new**.
560557
558+
If the parameters are correct, the connection is created. If there's a problem with the parameters, the connection creation dialog displays an error message. To troubleshoot connection parameter issues, you can use the on-premises data gateway installation and the gateway's local logs.
561559
562560
### [Standard](#tab/standard)
563561
564-
For a Standard workflow that runs in single-tenant Azure Logic Apps, you can enable SNC for authentication. Before you start, make sure that you met all the necessary [prerequisites](sap.md?tabs=single-tenant#prerequisites) and [SNC prerequisites for single-tenant](sap.md?tabs=single-tenant#snc-prerequisites).
562+
For a Standard workflow that runs in single-tenant Azure Logic Apps, you can enable SNC for authentication. Before you start, make sure that you met all the necessary [prerequisites](sap.md?tabs=single-tenant#prerequisites) and [SNC prerequisites for single-tenant](sap.md?tabs=single-tenant#snc-prerequisites). For more information about SNC, see [Getting started with SAP SNC for RFC integrations - SAP blog](https://community.sap.com/t5/enterprise-resource-planning-blogs-by-members/getting-started-with-sap-snc-for-rfc-integrations/ba-p/13983462).
565563
566-
For more information about SNC, see [Getting started with SAP SNC for RFC integrations - SAP blog](https://community.sap.com/t5/enterprise-resource-planning-blogs-by-members/getting-started-with-sap-snc-for-rfc-integrations/ba-p/13983462).
564+
#### Set up your SNC personal security environment and password
567565
568566
1. In the [Azure portal](https://portal.azure.com), open your Standard logic app resource.
569567
@@ -575,30 +573,44 @@ For more information about SNC, see [Getting started with SAP SNC for RFC integr
575573
576574
| Name | Value | Description |
577575
|------|-------|-------------|
578-
| **SAP_PSE** | <*PSE-value*> | Enter your SNC Personal Security Environment (PSE) as a base64-encoded binary. <br><br>- Your PSE must contain the private key for the client certificate where the thumbprint matches the public key for the client certificate in the **SNC Certificate** parameter. <br><br>- Although your PSE might contain multiple client certificates, to use different client certificates, create separate workflows instead. <br><br>- The PSE must have no PIN. If necessary, set the PIN to empty using the SAPGENPSE utility. |
576+
| **SAP_PSE** | <*PSE-value*> | Enter your SNC Personal Security Environment (PSE) as a base64-encoded binary. <br><br>- Your PSE must contain the private key for the client certificate where the thumbprint matches the public key for the client certificate in the SAP connection's **SNC Certificate** parameter that is available when you create the connection. <br><br>- Although your PSE might contain multiple client certificates, to use different client certificates, create separate workflows instead. <br><br>- The PSE must have no PIN. If necessary, set the PIN to empty using the SAPGENPSE utility. |
579577
| **SAP_PSE_PASSWORD** | <*PSE-password*> | The password, also known as PIN, for your PSE |
580578
581-
1. Now, either create or open the workflow you want to use in the designer. On your logic app resource menu, under **Workflows**, select **Workflows**.
579+
#### Create a connection with the SAP built-in connector
582580
583-
1. In the designer, add or edit an SAP *built-in* connector operation.
581+
Follow these steps for the SAP *built-in* connector. To create a connection with the SAP managed connector, see the [steps to enable SNC for an SAP connection in a Consumption workflow](sap.md?tabs=consumption#enable-secure-network-communications).
584582
585-
1. In the SAP connection information box, provide the following [required information](/azure/logic-apps/connectors/built-in/reference/sap/#authentication). The **Authentication Type** that you select changes the available options.
583+
1. On your logic app resource menu, under **Workflows**, select **Workflows**.
586584
587-
![Screenshot showing SAP built-in connection settings for Standard workflow with Basic authentication.](./media/sap/sap-connection-standard.png)
585+
1. Add a new empty Standard workflow or open an existing workflow.
588586
589-
1. To enable SNC, in the SAP connection information box, provide the [required information instead](/azure/logic-apps/connectors/built-in/reference/sap/#authentication).
587+
1. In the workflow designer, add an SAP built-in connector operation or edit the connection for an existing operation.
590588
591-
![Screenshot showing SAP built-in connection settings for Standard workflow with SNC enabled.](./media/sap/sap-connection-snc-standard.png)
589+
1. In the SAP connection information box, provide the [required information](/azure/logic-apps/connectors/built-in/reference/sap/#authentication), based on the **Authentication Type** that you select.
590+
591+
> [!NOTE]
592+
>
593+
> If you plan to enable SNC, continue to the next step
594+
> after you provide the connection name and SAP client ID.
595+
596+
:::image type="content" source="media/sap/sap-connection.png" alt-text="Screenshot shows SAP built-in connection parameters in Standard workflows.":::
597+
598+
1. To enable SNC, in the SAP connection information box, from the **Authentication Type** list, select **Logon Using SNC**, and provide the relevant [required information](/azure/logic-apps/connectors/built-in/reference/sap/#authentication):
592599
593600
| Parameter | Description |
594601
|-----------| ------------|
595-
| **Authentication Type** | Select **Logon Using SNC**. |
602+
| **SNC My Name** | In most cases, you can omit this value. The installed SNC solution usually knows its own SNC name. In the case where your solution supports multiple identities, you might have to specify the identity to use for this particular destination or server. |
596603
| **SNC Partner Name** | Enter the name for the backend SNC, for example, **p:CN=DV3, OU=LA, O=MS, C=US**. |
597604
| **SNC Quality of Protection** | Select the quality of service to use for SNC communication with this particular destination or server. The default value is defined by the backend system. The maximum value is defined by the security product used for SNC. |
598605
| **SNC Type** | Select the SNC authentication to use. |
599-
| **SNC Certificate** | Enter your SNC client's public certificate in base64-encoded format. <br><br>**Note**: - Don't include the PEM header or footer. <br><br>- Don't enter the private certificate here because the PSE might contain multiple private certificates. However, this **SNC Certificate** parameter identifies the certificates that this connection must use. |
606+
| **Certificate User** | Enter the user to connect when you have a certificate that's assigned to multiple users. |
607+
| **SNC Certificate** | Enter your SNC client's public certificate in base64-encoded format. This parameter specifies the certificates that this connection must use. <br><br>**Note**: - Don't include the PEM header or footer. <br><br>- Don't enter the private certificate here because the Personal Security Environment (PSE) might contain multiple private certificates. You specify this PSE using the **SAP_PSE** app setting for your Standard logic app resource. <br><br>- If you're using more than one SNC client certificate for your logic app resource, you must provide the same PSE for all connections. |
608+
609+
:::image type="content" source="media/sap/sap-connection-snc-standard.png" alt-text="Screenshot shows SAP built-in connection parameters with SNC enabled for Standard workflows.":::
610+
611+
1. To finish creating your connection, select **Create new**.
600612
601-
1. To finish creating your connection, select **Create**.
613+
If the parameters are correct, the connection is created. If there's a problem with the parameters, the connection creation dialog displays an error message.
602614
603615
---
604616

0 commit comments

Comments
 (0)