Installing The Sapcrypto Library and Starting The Saprouter
Installing The Sapcrypto Library and Starting The Saprouter
Installing The Sapcrypto Library and Starting The Saprouter
Contents
This section describes the necessary steps to download and install the sapcrypto library for use with saprouter. The saprouter must be started with the
options described later in this section.
The license for the sapcrypto library covers ONLY saprouter connections between saprouters at SAP and the first saprouter on
customer sites. For all other purposes the library CANNOT be used!
1. Login to the SAP Service Marketplace with the Service Marketplace USERID which is assigned to your installation.
2. Change to the alias SAPROUTER-SNCADD. Before you can download the software components two preconditions must be met.
a. You must have been allowed to download the software. This authorization is added as soon as SAP has received a positive statement from the
"Bundesausfuhramt". This procedure is necessary since the software falls under EU regulations.
b. For more information on how to obtain authorization if download is not possible see note 397175.
c. You must accept that you must follow the regulations imposed by the EU on the use and distribution of the cryptographic software
components downloaded from the SAP Service Marketplace.
3. The acceptance of the terms and conditions is logged with your USERID and stored for reporting purposes to the "Bundesausfuhramt".
4. Accepting with the button on the web-based form takes you to the folder where you can download the Software components.
These are packed into a single CAR file sapcrypto.car
5. Copy the file to the direcory where the saprouter executable is located
6. You can get the file car.exe/sapcar.exe, which is necessary to unpack the archive from any Installation Kernel CD.
Executing the command car -xvf SAPCRYPTO.CAR will unpack the following files:
[lib]sapcrypto.[dll|so|sl]
sapgenpse[.exe]
ticket
2. Go to the Trust Center Service - Download Area and get the "Distinguished Name" for your SAProuter from the list of SAProuters registered for your
installation.
5. Display the output file "certreq" and with copy&paste insert the certificate request into the text area of the same form on the SAP Service
Marketplace from which you copied the Distinguished Name
6. In response you will receive the certificate signed by the CA in the Service Marketplace, cut&paste the text to a local file named srcert
7. With this in turn you can install the certificate in your saprouter by calling
sapgenpse import_own_cert -c srcert -p local.pse
8. now you will have to create the credentials for the SAProuter with the same program (if you omit -O <user>, the credentials are created for the
logged in user account)
sapgenpse seclogin -p local.pse -O <user_for _saprouter>
For increased security please check that the file can only be accessed by the user running the SAProuter.
Do not allow any other access (not even from the same group)!
https://www012.sap-ag.de/~sapidb/011000358700000866032001E/SNNEWIO.HTM 14/02/2002
Installing the sapcrypto library and starting the SAProuter Page 2 of 3
On UNIX this will mean permissions being set to 600 or even 400!
On NT check that the permissions are granted only to the user the service is running as!
10. Check if the certificate has been imported correctly
sapgenpse get_my_name -v -n Issuer
The name of the Issuer should be: CN=SAProuter CA, OU=SAProuter, O=SAP, C=DE
11. If this is not the case, delete the files cred_v2, local.pse and start over at Item 4. If the output still does not match please open a customer message
in component XX-SER-NET-OSS stating the actions you have taken so far and the output of the commands
4.,7.,8. and 10.
1. The environment variable SNC_LIB needs to be set for the user account SAProuter is running under.
SNC_LIB has the form
UNIX <path_to_libsecude>/<name_of_sapcrypto_library>
Windows NT, Windows 2000 <drive>:\<path_to_libsecude>\<name_of_sapcrypto_library>
2. Check if the environment of the user running saprouter contains the environment variable SNC_LIB
UNIX printenv
Windows NT System environment variable
the corresponding file ./saprouttab should contain at least the following entries
Example
For a SNC encrypted connection to the SAPRouter on sapserv2 (194.39.131.34), the saprouttab should contain the following entries:
https://www012.sap-ag.de/~sapidb/011000358700000866032001E/SNNEWIO.HTM 14/02/2002
Installing the sapcrypto library and starting the SAProuter Page 3 of 3
https://www012.sap-ag.de/~sapidb/011000358700000866032001E/SNNEWIO.HTM 14/02/2002