You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/logic-apps/connectors/sap.md
+35-23Lines changed: 35 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -527,43 +527,41 @@ For more information about SNC, see [Getting started with SAP SNC for RFC integr
527
527
528
528
1. In the [Azure portal](https://portal.azure.com), open your Consumption logic app and workflow in the designer.
529
529
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.
531
531
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
-

532
+
1. In the SAP connection information box, provide the [required information](/connectors/sap/#default-connection), based on the **Authentication Type** that you select.
535
533
536
534
> [!NOTE]
537
535
>
538
536
> The **SAP Username** and **SAP Password** fields are optional. If you don't provide a username
539
537
> and password, the connector uses the client certificate provided in a later step for authentication.
540
538
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.":::
542
540
543
-

541
+
1. To enable SNC, in the SAP connection information box, provide the following required information instead:
544
542
545
543
| Parameter | Description |
546
544
|-----------|-------------|
547
-
| **Use SNC** | Select the checkbox. |
545
+
| **Use SNC** | Select this option. |
548
546
| **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** |
549
547
| **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. |
550
548
| **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. |
551
549
| **SNC Partner Name** | Enter the name for the backend SNC, for example, **p:CN=DV3, OU=LA, O=MS, C=US**. |
552
550
| **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. |
553
551
| **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. |
557
553
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
+

559
555
556
+
1. To finish creating your connection, select **Create new**.
560
557
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.
561
559
562
560
### [Standard](#tab/standard)
563
561
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).
565
563
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
567
565
568
566
1. In the [Azure portal](https://portal.azure.com), open your Standard logic app resource.
569
567
@@ -575,30 +573,44 @@ For more information about SNC, see [Getting started with SAP SNC for RFC integr
575
573
576
574
| Name | Value | Description |
577
575
|------|-------|-------------|
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. |
579
577
| **SAP_PSE_PASSWORD** | <*PSE-password*> | The password, also known as PIN, for your PSE |
580
578
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
582
580
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).
584
582
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**.
586
584
587
-

585
+
1. Add a new empty Standard workflow or open an existing workflow.
588
586
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.
590
588
591
-

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):
592
599
593
600
| Parameter | Description |
594
601
|-----------| ------------|
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. |
596
603
| **SNC Partner Name** | Enter the name for the backend SNC, for example, **p:CN=DV3, OU=LA, O=MS, C=US**. |
597
604
| **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. |
598
605
| **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**.
600
612
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.
0 commit comments