Configuring SSL communication for SAP and docuflow Content Server

the content server communication with sap can optionally have an ssl port enabled which also requires some certificates to be adjusted so that communication with sap can be secure the following example uses the command line tool called openssl there are various ways to generate certificates so this example is just one way getting the openssl utility installed in your environment is not part of this guide this example also generates what are known as self signed certificates generating signed certificates from certificate authorities is outside the scope of this document first you’ll need to get a private key and convert it to the appropriate format required by the docuflow enterprise connector generate an encrypted private key using openssl openssl genrsa aes256 out my private key pem 2048 this generates an rsa private key using aes256 encryption (other types of encryption are possible if aes256 is deemed insecure by your organization it will prompt you to enter in a passphrase for the encryption, make sure to choose something that you will remember the format of this certificate should be human readable since it is in the pem format the 2048 at the end of the command tells this key to be 2048 bits long (you could also use something like 4096 here instead of 2048) convert the private key to the pkcs8 structure openssl pkcs8 topk8 inform pem in my private key pem outform pem nocrypt out ewave private key pkcs8 pem this command takes the input file generated in the previous step and converts it into the pkcs8 structure used by the enterprise connector note that the nocrypt command here also unencrypts the private key since this could allow vulnerabilities you may wish to restrict who has access to the folder where the certificates are stored just make sure that the windows server that runs the docuflow enterprise connector has access to the folder by creating a logon user for the service if need be store the private key in the config directory under the installation folder change the private key name to be ewave private key pkcs8 pem if you chose a different name in the previous steps if you wish to keep the name that you originally chose you can optionally adjust the config properties file found under the config directory under the installation folder to point to the new private key fie you have created you will need to adjust the content pem file to be the name of the file you have chosen ex content pem file=my private key pkcs8 pem (if you chose my private key pkcs8 pem as the output file when converting to the pkcs8 structure generate a public certificate from the private key using openssl make sure that the common name matches the host used in the oac0 archivelink configuration (ip or hostname) openssl req new x509 key my private key pem out ewave public cer days 3650 this command creates a new self signed certificate that is valid for 3,650 days it will prompt you to enter the passphrase you chose earlier for your private key then it will ask you to enter in a country designation, state or province, and city next enter in your company name and an optional organizational unit from within your company (this can be left blank) for the common name make sure to enter the ip address or hostname you used or will use when configuring the archivelink repository under oac0 you can optionally enter in an email address as well store the public certificate in the config directory under the installation folder change the public certificate name to be ewave public cer if you chose a different name in the previous steps if you wish to keep the name that you originally chose you can optionally adjust the config properties file found under the the config directory under the installation folder to point to the new public certificate you have created you will need to adjust the content cer file to be the name of the file you have chosen ex content cer file=my public cer (if you chose my public cer as the output file when creating the certificate) store the public certificate in sap using the transaction strust this lets sap know that calls out to the content server using this public certificate are trusted execute transaction strust double click on the ssl system client ssl client on the left hand side (note there may be two variants of the system ssl client so repeat the process for both ssl clients) verify that the right hand side says “ssl system client ssl client” at the top on the bottom certificate section on the right hand side click on the import certificate button found in the lower left select the certificate file that was previously generated and upload the certificate verify that the certificate details get loaded up into the screen finally click on the “add to certificate list” verify that the certificate list in the middle of the right hand side now contains an entry for the newly created public certificate (you may have to scroll down through the list of certificates) repeat the process if there was more than one ssl system client adjust the content server information in the defaultconfig ini that will be using ssl communication by adding an ssl port number to configuration ensure ssl is enabled make sure that the same port number is configured in the archivelink repository that will be used with this configuration via transaction oac0 make sure to save configuration to the active profile and restart the docuflow enterprise connector windows service for the changes to take effect in order to verify that the ssl configuration is correct you will need to attempt to store and retrieve (view) a business document that is associated with the archivelink repository configured to use ssl note that testing the connection to the archivelink repository does not test the ssl connection since that information is sent over the non ssl port this also means that archivelink repository configurations must have both an ssl port and a regular port configured note for testing purposes in oac0 enter %https in the transaction when in the context of a content repository to enforce https on that content id the dropdowns will appear only then