Help Center>Foundation Help

Applies to:

Configuring Winshuttle SAP Integration Server for X509 certificate-based SAP Netweaver SSO logon

The X509 certificate-based SAP Netweaver SSO logon method does not include the ‘RunWithSapCreds’ method when consuming a Web service. Only one authentication method is used.

On this page

X509 certificate-based SAP SSO logon involves two types of certificates:

  • SAP server certificate
  • User client certificate.

Each SAP user must install the client certificate on their machine.

For Winshuttle Server, multiple users can access SAP server simultaneously. However, installing a client certificate for each SAP user on every machine where Winshuttle Worker is installed is impractical -- so there are 2 options for using X509 certificate-based SAP SSO with Winshuttle Server:

  • System Post: Only one SAP user is responsible for uploading downloading data to/from SAP. The client certificate for this user only needs to be installed on the Winshuttle Worker machine along with the SAP server certificate.
  • Extended SNC Name: Each user in SAP must have the same extended SNC name along with their normal SNC names. Only one client certificate is required for the extended SNC name, and it needs to be installed on the Winshuttle Worker machines along with the SAP server certificate.

In this section, we have used following naming conventions:

  • C:\SLL – The folder that contains all DLLs required for X509 certificate based logon.
  • secgss.dll – DLL responsible for X509 certificate based logon. This name can be different according to the user’s environment.
  • SAP_Server.p12 – SAP server side certificate. Name can be different in user’s environment.
  • Common_Cert.p12 – Client certificate for the common user. That can be a system post user or an extended SNC name. Name can be different in user’s environment.

Creating an extended SNC name

Back to top
  1. Open the required SAP server in SAP GUI.
  2. Enter transaction code SM30.
  3. Enter table as USRACLEXT.
  4. Click Display.
  5. Enter the extended SNC name for each user.

Configuring Winshuttle Server for X509 SSO

Back to top

To enable X509 certificate-based SSO Login, do the following:

  1. Open the Server Administrator Tool.
  2. Under Integrated Logon, select Enabled.
  3. Select X509 SSO.
  4. In the SNC MyName field, type the SNC MyName parameter (Note: This does not apply to Server 10.6.1)

    Note: SNC MyName field is obsolete in 10.6. This setting is now controlled by application server settings in Winshuttle Central.

  5. Click Apply Changes.

Configuring 32-bit Worker and FormWorker SAP SSO

Back to top

To configure SAP SSO on a 32-bit Winshuttle Worker machine, do the following. (Note that the same will be required for configuring SAP SSO for FormWorker because Winshuttle FormWorker is available only in a 32-bit configuration.)

Note: The SNC_LIB file name in the following screenshots is for reference only. The name can differ in your environment.

  1. Deploy SAP SSO logon on the machine where Winshuttle Worker or FormWorker is deployed.
  2. The SAP SSO logon deployment creates an environment variable named ‘SNC_LIB’ for users environment variable.
  3. Create the same environment variable in ‘System Variables’. (Winshuttle Worker is a windows service and services use System environment variables).
  4. Restart the machine.

Configuring 64-bit Worker and FormWorker

Back to top
winshuttle-server-environment-variables-64bit
  1. Copy required DLLs for certificate-based SSO logon to the folder C:\SLL.
  2. Create an environment variable named SNC_LIB in both user variables and system variables.
  3. Set its value to the path of 64-bit secgss.dll as shown at right.

    Note: A 32-bit specific user variable is used by Winshuttle FormWorker and SAP GUI. If the system only has 64-bit Winshuttle Worker and does not have FormWorker or SAP GUI, then 32-bit DLLs are not required. You need to set the path of 64-bit DLL in system variable only.

  4. Create a folder C:\SECUDIR.
  5. Copy user and SAP server certificates to C:\SECUDIR.
  6. Create a system environment variable SECUDIR and set its value to C:\SECUDIR.
  7. Open a command prompt.
  8. Type CD C:\SLL\64-bit to change to the C:\SLL\64-bit directory.
  9. Run the following commands from the command prompt:

    snc crtpse

    Creates a .ZIP file named PSE.

    snc register –f C:\SECUDIR\SAP_SERVER.p12

    Registers the SAP server certificate.

    snc register –f C:\SECUDIR\Common_Cert.p12

    Registers a common SNC certificate for all users.

    snc status –v

    Verifies that all certificates are registered

  10. Grant full permission to C:\SLL and C:\SECUDIR folders to the user that represents the identity of the WinshuttleWorker service (by default it is Network Service). For FormWorker, it is the identity of logged-in user.
  11. Restart the machine.