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/logic-apps-using-sap-connector.md
+86-59Lines changed: 86 additions & 59 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -171,11 +171,11 @@ The preview SAP built-in connector trigger named **Register SAP RFC server for t
171
171
172
172
The SAP system requires network connectivity from the host of the SAP .NET Connector (NCo) library:
173
173
174
-
* For logic app workflows in multi-tenant Azure Logic Apps, the on-premises data gateway hosts the SAP .NET Connector (NCo) library. If you use an on-premises data gateway cluster, all nodes of the cluster require network connectivity to the SAP system.
174
+
* For Consumption logic app workflows in multi-tenant Azure Logic Apps, the on-premises data gateway hosts the SAP .NET Connector (NCo) library. If you use an on-premises data gateway cluster, all nodes of the cluster require network connectivity to the SAP system.
175
175
176
-
* For logic app workflows in an ISE, the ISE virtual network hosts the SAP .NET Connector (NCo) library.
176
+
* For Standard logic app workflows in single-tenant Azure Logic Apps, the logic app resource hosts the SAP .NET Connector (NCo) library. So, the logic app resource itself must enable virtual network integration, and that virtual network must have network connectivity to the SAP system.
177
177
178
-
* For logic app workflows in single-tenant Azure Logic Apps, the logic app resource hosts the SAP .NET Connector (NCo) library. So, the logic app resource itself must enable virtual network integration, and that virtual network must have network connectivity to the SAP system.
178
+
* For Consumption logic app workflows in an ISE, the ISE virtual network hosts the SAP .NET Connector (NCo) library.
179
179
180
180
The SAP system-required network connectivity includes the following servers and services:
181
181
@@ -208,7 +208,7 @@ For more information about SAP services and ports, review the [TCP/IP Ports of A
208
208
209
209
### SAP NCo client library prerequisites
210
210
211
-
The following list describes the prerequisites for the SAP NCo client library that you're using with the SAP connector:
211
+
To use the SAP connector, you'll need the SAP NCo client library named [SAP Connector (NCo 3.0) for Microsoft .NET 3.0.25.0 compiled with .NET Framework 4.0 - Windows 64-bit (x64)](https://support.sap.com/en/product/connectors/msnet.html). The following list describes the prerequisites for the SAP NCo client library that you're using with the SAP connector:
212
212
213
213
* Version:
214
214
@@ -226,22 +226,31 @@ The following list describes the prerequisites for the SAP NCo client library th
226
226
227
227
* After you upgrade the SAP server environment, you get the following exception message: **"The only destination <some-GUID> available failed when retrieving metadata from <SAP-system-ID> -- see log for details"**.
228
228
229
-
* For Standard logic app workflows, you can use the 32-bit version for the SAP NCo client library, but make sure that you install the version that matches the configuration in your Standard logic app resource. To check this version, follow these steps:
229
+
* For Standard logic app workflows, you can use the 32-bit or 64-bit version for the SAP NCo client library, but make sure that you install the version that matches the configuration in your Standard logic app resource. To check this version, follow these steps:
230
230
231
231
1. In the [Azure portal](https://portal.azure.com), open your Standard logic app.
232
+
232
233
1. On the logic app resource menu, under **Settings**, select **Configuration**.
234
+
233
235
1. On the **Configuration** pane, under **Platform settings**, check whether the **Platform** value is set to 64-bit or 32-bit.
236
+
234
237
1. Make sure to install the matching version of the [SAP Connector (NCo 3.0) for Microsoft .NET 3.0.25.0 compiled with .NET Framework 4.0](https://support.sap.com/en/product/connectors/msnet.html).
235
238
239
+
1. To use the SAP connector, you need the following files from the SAP NCo client library and have them ready to upload to your logic app resource.
240
+
241
+
-**libicudecnumber.dll**
242
+
-**sapnco.dll**
243
+
-**sapnco_utils.exe**
244
+
236
245
* From the client library's default installation folder, copy the assembly (.dll) files to another location, based on your scenario as follows. Or, optionally, if you're using only the SAP managed connector, when you install the SAP NCo client library, select **Global Assembly Cache registration**. The ISE zip archive and SAP built-in connector currently doesn't support GAC registration.
237
246
238
247
* For a Consumption workflow that runs in multi-tenant Azure Logic Apps and uses your on-premises data gateway, copy the assembly (.dll) files to the on-premises data gateway installation folder, for example, **C:\Program Files\On-Premises Data Gateway**.
239
248
240
249
Make sure that you copy the assembly files to the data gateway's *installation folder*. Otherwise, your SAP connection might fail with the error message, **Please check your account info and/or permissions and try again**. You can troubleshoot further issues using the [.NET assembly binding log viewer](/dotnet/framework/tools/fuslogvw-exe-assembly-binding-log-viewer). This tool lets you check that your assembly files are in the correct location.
241
250
242
-
* For a Consumption workflow in an ISE, follow the [ISE prerequisites](#ise-prerequisites) instead.
251
+
* For Standard workflows, copy the assembly (.dll) files to a location from where you can upload them to your logic app resource or project where you're building your workflow, either in the Azure portal or locally in Visual Studio Code, respectively
243
252
244
-
* For Standard workflows, copy the assembly (.dll) files to a location from where you can upload them to location where you're building your workflow, either in the Azure portal or locally in Visual Studio Code.
253
+
* For a Consumption workflow in an ISE, follow the [ISE prerequisites](#ise-prerequisites) instead.
245
254
246
255
The following relationships exist between the SAP NCo client library, the .NET Framework, the .NET runtime, and the data gateway:
247
256
@@ -257,6 +266,8 @@ The following relationships exist between the SAP NCo client library, the .NET F
257
266
258
267
### [Consumption](#tab/consumption)
259
268
269
+
<aname="snc-prerequisites-consumption"></a>
270
+
260
271
For Consumption workflows in multi-tenant Azure Logic Apps that use the on-premises data gateway, and optionally SNC, you must also configure the following settings.
261
272
262
273
* Make sure that your SNC library version and its dependencies are compatible with your SAP environment. To troubleshoot any library compatibility issues, you can use your on-premises data gateway and data gateway logs.
@@ -281,8 +292,68 @@ For more information about enabling SNC, review [Enable Secure Network Communica
281
292
282
293
### [Standard](#tab/standard)
283
294
295
+
<aname="snc-prerequisites-standard"></a>
296
+
284
297
The SAP built-in connector supports only SNC X.509 authentication, not single sign-on (SSO) authentication. Make sure that you install the SNC and common crypto library assemblies as part of your [single-tenant prerequisites](#single-tenant-prerequisites) and [network connectivity prerequisites](#network-prerequisites). For more information about enabling SNC, review [Enable Secure Network Communications (SNC)](#enable-secure-network-communications).
285
298
299
+
For SNC from SAP, you'll need to download the following files and have them ready to upload to your logic app resource. You can find these files in the **CommonCryptoLib.sar** package available from the [**SAP for Me, Software Download Center**](https://me.sap.com/softwarecenter)(SAP sign-in required). For more information, see [Download **CommonCryptoLib.sar**](#download-common-crypto).
300
+
301
+
-**sapcrypto.dll**
302
+
-**sapgenpse.exe**
303
+
-**slcryptokernal.dll**
304
+
305
+
> [!NOTE]
306
+
>
307
+
> If you use a different SNC implementation, these library files might have different names.
308
+
> In any case, **sapgenpse.exe** is required to use SNC with the SAP built-in connector.
309
+
310
+
<aname="download-common-crypto"></a>
311
+
312
+
#### Download CommonCryptoLib.sar
313
+
314
+
To get the required assemblies and other files for SNC from SAP, you can find these files in the **CommonCryptoLib.sar** package available from the [**SAP for Me, Software Download Center**](https://me.sap.com/softwarecenter)(SAP sign-in required). You can use any currently supported **CommonCryptoLib** library implementation, based on compatible versions specific to your SAP environment. However, Microsoft recommends that you use the latest version for the **CommonCryptoLib** library available from SAP, assuming that version is compatible with your SAP environment.
315
+
316
+
To download the current **CommonCryptoLib** package, follow these steps:
317
+
318
+
1. Sign in to the [**SAP for Me, Software Download Center**](https://me.sap.com/softwarecenter).
319
+
320
+
1. On the **Download Software** page, select the **Installation & Upgrades** tab, expand **By Alphabetical Index (A-Z)**, and select **C** > **SAP Cryptographic Software** > **Downloads** tab > **SapCryptoLib** > **Downloads** tab > **CommonCryptoLib 8** > **Downloads** tab.
321
+
322
+
1. From the **Items Available to Download** list, select **Windows on x64 Bit** or **Windows on x32 Bit (IA32)**, whichever matches Standard logic app platform configuration.
323
+
324
+
Microsoft recommends the 64-bit version.
325
+
326
+
1. From the list, select the highest level patch.
327
+
328
+
The current patch number varies based on the selected Windows version.
329
+
330
+
1. If you don't have the [`SAPCAR` utility](https://help.sap.com/docs/Convergent_Charging/d1d04c0d65964a9b91589ae7afc1bd45/467291d0dc104d19bba073a0380dc6b4.html) to extract the .sar file, follow these steps:
331
+
332
+
1. In the [**SAP for Me, Software Download Center**](https://me.sap.com/softwarecenter), on the **Download Software** page, select the **Support Packages & Patches** tab, expand **By Alphabetical Index (A-Z)**, and select **S** > **SAPCAR** > **Downloads** tab.
333
+
334
+
1. From the **Items Available to Download** list, select your operating system, and the **sapcar.exe** file for the **SAPCAR** utility.
335
+
336
+
> [!TIP]
337
+
>
338
+
> If you're unfamiliar with the **SAPCAR** utility, review the following SAP blog post,
339
+
> [Easily extract SAR files](https://blogs.sap.com/2004/11/18/easily-extract-sar-files/).
340
+
341
+
The following batch file is an improved version that extracts archives to a subdirectory with the same name:
342
+
343
+
```text
344
+
@echo off
345
+
cd %~dp1
346
+
mkdir %~n1
347
+
sapcar.exe -xvf %~nx1 -R %~n1
348
+
pause
349
+
```
350
+
351
+
1. Include all the extracted .dll and .exe files, which the following list shows for the current SAP **CommonCryptoLib** package:
352
+
353
+
-**sapcrypto.dll**
354
+
-**sapgenpse.exe**
355
+
-**slcryptokernal.dll**
356
+
286
357
### [ISE](#tab/ise)
287
358
288
359
<aname="snc-prerequisites-ise"></a>
@@ -410,61 +481,17 @@ For a Consumption workflow in multi-tenant Azure Logic Apps, the SAP managed con
410
481
411
482
For a Standard workflow in single-tenant Azure Logic Apps, use the preview SAP *built-in* connector to directly access resources that are protected by an Azure virtual network. You can also use other built-in connectors that let workflows directly access on-premises resources without having to use the on-premises data gateway.
412
483
413
-
#### Required assemblies and other files
414
-
415
-
To use the SAP built-in connector, you'll need to download the following files and have them ready to upload to your logic app resource. To get these files, see how to [download and install the latest SAP NCo client library](#sap-client-library-prerequisites).
416
-
417
-
- **libicudecnumber.dll**
418
-
- **sapnco.dll**
419
-
- **sapnco_utils.exe**
420
-
421
-
For SNC from SAP, you'll need download the following files and have them ready to upload to your logic app resource. To get these files, you can find them in the **CommonCryptoLib** software component available from the [**SAP for Me, Software Download Center**](https://me.sap.com/softwarecenter)(SAP sign-in required). You can use any currently supported **CommonCryptoLib** library implementation, based on compatible versions specific to your SAP environment. However, Microsoft recommends that you use the latest version for the **CommonCryptoLib** library available from SAP, assuming that version is compatible with your SAP environment.
422
-
423
-
424
-
- **sapcrypto.dll**
425
-
- **sapgenpse.exe**
426
-
- **slcryptokernal.dll**
427
-
428
-
by following the steps below:
429
-
430
-
431
-
432
-
To download the current **CommonCryptoLib**, follow these steps:
433
-
434
-
1. Sign in to the [**SAP for Me, Software Download Center**](https://me.sap.com/softwarecenter).
435
-
1. Select the **Installation & Upgrades** > **by Alphabetical Index (A-Z)
436
-
• C
437
-
• SAP Cryptographic Software
438
-
• SAPCRYPTOLIB
439
-
• COMMONCRYPTOLIB 8
440
-
• Select the Windows 32 Bit (IA32) or Windows 64 Bit (x64) matching your workflow application platform configuration. We recommend 64 bit.
441
-
• Pick the highest patch level from the list (current number will vary).
442
-
443
-
444
-
An improved version of the batch that extract archives to a sub-directory of the same name is:
445
-
446
-
```
447
-
@echo off
448
-
cd %~dp1
449
-
mkdir %~n1
450
-
sapcar.exe -xvf %~nx1 -R %~n1
451
-
pause
452
-
```
453
-
454
-
Include all the extracted .dll and .exe files. For the current version of SAP common crypto lib, that list is:
455
-
456
-
• sapcrypto.dll
457
-
• sapgenpse.exe
458
-
• slcryptokernel.dll
459
-
460
-
If you are using a different implementation of SNC, the library files may be named differently. In any case, sapgenpse.exe is required for use of SNC with built-in SAP connector.
484
+
1. To use the SAP connector, you need to download the following files and have them read to upload to your Standard logic app resource. For more information, see [SAP NCo client library prerequisites](#sap-client-library-prerequisites):
461
485
486
+
- **libicudecnumber.dll**
487
+
- **sapnco.dll**
488
+
- **sapnco_utils.exe**
462
489
463
-
> [!NOTE]
464
-
>
465
-
> If you don't already have the `SAPCAR` command to extract the SAR file content, in the SAP for Me, Software Download Center, find the `SAPCAR` keyword, which appears under **Downloads** as a Software Component.
466
-
If you're unfamiliar with the `SAPCAR` command, consider following the SAP blog post at Easily extract SAR files
490
+
1. To SNC from SAP, you need to download the following files and have them ready to upload to your logic app resource. For more information, see [SNC prerequisites](#snc-prerequisites-standard):
0 commit comments