Skip to content

Commit 0abc144

Browse files
committed
Update with SNC required files download
1 parent 3953b5e commit 0abc144

File tree

1 file changed

+86
-59
lines changed

1 file changed

+86
-59
lines changed

articles/logic-apps/logic-apps-using-sap-connector.md

Lines changed: 86 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -171,11 +171,11 @@ The preview SAP built-in connector trigger named **Register SAP RFC server for t
171171

172172
The SAP system requires network connectivity from the host of the SAP .NET Connector (NCo) library:
173173

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.
175175

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.
177177

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.
179179

180180
The SAP system-required network connectivity includes the following servers and services:
181181

@@ -208,7 +208,7 @@ For more information about SAP services and ports, review the [TCP/IP Ports of A
208208

209209
### SAP NCo client library prerequisites
210210

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:
212212

213213
* Version:
214214

@@ -226,22 +226,31 @@ The following list describes the prerequisites for the SAP NCo client library th
226226

227227
* 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"**.
228228

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:
230230

231231
1. In the [Azure portal](https://portal.azure.com), open your Standard logic app.
232+
232233
1. On the logic app resource menu, under **Settings**, select **Configuration**.
234+
233235
1. On the **Configuration** pane, under **Platform settings**, check whether the **Platform** value is set to 64-bit or 32-bit.
236+
234237
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).
235238

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+
236245
* 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.
237246

238247
* 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**.
239248

240249
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.
241250

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
243252

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.
245254

246255
The following relationships exist between the SAP NCo client library, the .NET Framework, the .NET runtime, and the data gateway:
247256

@@ -257,6 +266,8 @@ The following relationships exist between the SAP NCo client library, the .NET F
257266

258267
### [Consumption](#tab/consumption)
259268

269+
<a name="snc-prerequisites-consumption"></a>
270+
260271
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.
261272

262273
* 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
281292

282293
### [Standard](#tab/standard)
283294

295+
<a name="snc-prerequisites-standard"></a>
296+
284297
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).
285298

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+
<a name="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+
286357
### [ISE](#tab/ise)
287358

288359
<a name="snc-prerequisites-ise"></a>
@@ -410,61 +481,17 @@ For a Consumption workflow in multi-tenant Azure Logic Apps, the SAP managed con
410481
411482
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.
412483
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):
461485
486+
- **libicudecnumber.dll**
487+
- **sapnco.dll**
488+
- **sapnco_utils.exe**
462489
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):
467491
492+
- **sapcrypto.dll**
493+
- **sapgenpse.exe**
494+
- **slcryptokernal.dll**
468495
469496
#### Upload assemblies to Azure portal
470497

0 commit comments

Comments
 (0)