SAP S/4 Hana

General information

The SAP S/4 Hana connector provides the ability to manage users, their attributes, and memberships (roles, profiles and groups) in the SAP system. The operations that can be performed by using OpenIAM include create, modify, remove, suspend and resume. This connector also supports connection with an older versions of SAP known as SAP R/3.

Requirements

The current version of the connector can be deployed to a Linux box as a JAR file. The Docker version of the connector is not available as of yet. Connection will be established on port 3300 -- please make sure it is available from the connector box.

Installation and connection to OpenIAM

Use an .sh script to start the connector. It is important is to provide the path to where the SAP library is stored. Example of a startup script:

#!/bin/bash
. /usr/local/openiam/env.conf
export LD_LIBRARY_PATH=/usr/local/openiam/conf/connectors/sap/
export LIBPATH=/usr/local/openiam/conf/connectors/sap/
export VAULT_CERTS="$HOME_DIR/vault/certs/"
export JAVA_HOME="$HOME_DIR/jdk"
setenforce 0
JAVA_OPTS="$2"
JAR_FILE="$1"
$JAVA_HOME/bin/java -Dlogging.level.root=WARN -Dlogging.level.org.openiam=INFO -Dspring.config.location=/usr/local/openiam/conf/connectors/sap/application.properties -Dconfpath=$HOME_DIR -jar $JAVA_OPTS $HOME_DIR/connectors/bin/saps4hana-connector-rabbitmq.jar > $HOME_DIR/logs/saps4hana-connector-rabbitmq.log &

Installation and connection to OpenIAM when OpenIAM is deployed in Docker

  • Open port 8200 in the vault container by adding in openiam-docker-compose/3.2/infrastructure/vault/docker-compose.yaml ports:"8200:8200"
  • Open port 5672 on rabbitmq container by uncommenting the ports configuration in openiam-docker-compose/3.2/infrastructure/rabbitmq/docker-compose.yaml
  • Restart OpenIAM. If the SAP connector will be deployed on other box, please make sure a firewall is not blocking these ports.
firewall-cmd --add-port=8200/tcp --permanent
firewall-cmd --add-port=5672/tcp --permanent
firewall-cmd --reload

Download the connector to a directory which, for this document, will be referred to as your_folder. In your_folder, create a file entitled sap_application.properties with the following contents:

org.openiam.connector.queue=SAP_Connector_1_Request
org.openiam.connector.queueResponseName=SAP_Connector_1_Response
org.openiam.connector.name=SAPS4HANA
org.openiam.connector.type=SAP Connector
org.openiam.connector.broadcast.binding.connector.key=52
spring.application.name=saps4hana-connector-rabbitmq
org.openiam.health.check.sweeptime=30000
management.health.elasticsearch.enabled=false
management.health.redis.enabled=false
spring.jmx.enabled=false
sap.property.date.format=yyyy-MM-dd
sap.general.checkIfUserHasPwdAlreadySet=false
CIPHER_sap.general.dummyPassword={rym2+zCJlbSuPzuFl2p2T4foDlleyNAL}

Install Java 11. Copy the vault certificate entitled vault.crt and import it. you can then can drop this file from the box.

keytool -noprompt -import -v -trustcacerts -alias vault_$(pwgen -s 13 1) -file path_to_vault.crt -keystore /usr/lib/jvm/java-11-openjdk-11.0.11.0.9-1.el7_9.x86_64/lib/security/cacerts -keypass changeit -storepass changeit

In your_folder we will add two files. The first will be entitled: rabbitmq.properties

spring.rabbitmq.host=rabbitmq_host_name
spring.rabbitmq.port=5672
org.openiam.rabbitmq.hosts=${spring.rabbitmq.host}:${spring.rabbitmq.port}
spring.rabbitmq.username=openiam
org.openiam.rabbitmq.concurrent.consumers=20
org.openiam.rabbitmq.max.concurrent.consumers=50
org.openiam.rabbitmq.prefetch.count=2
org.openiam.rabbitmq.channelTransacted=true
org.openiam.rabbitmq.channelCacheSize=10
org.openiam.mq.broker.encryption.key=ff808181670838e0016708610547001b

Next, create vault.properties

vault.uri=https://rabbitmq_host_name:8200
vault.authentication=CERT
vault.ssl.key-store=file://path_to_vault.jks
vault.ssl.key-store-password=passwd00

Create a directory entitled 'your_directory/conf/vault/client' in your_folder and put vault.jks (you have to grab it from the OpenIAM box) in it.

Download libsapjco3.so and add it to your_directory. Create a file entitled sap_startup.sh with the following content:

#!/bin/bash
kill -9 $(pgrep -f saps4hana-connector-rabbitmq)
export LD_LIBRARY_PATH=full path to your_directory
export LIBPATH=full path to your_directory
setenforce 0
/usr/bin/java -Dlogging.level.root=WARN -Dlogging.level.org.openiam=INFO -Dspring.config.location=sap_application.properties -Dconfpath=full path to your_directory -jar saps4hana-connector-rabbitmq.jar > saps4hana-connector-rabbitmq.log &

General usage

Service account information:

During the Managed System configuration you should provide login (service account username), password, host or IP address where SAP is hosted. We will also need the following SAP instance specific parameters:

Parameter nameDescription
JCO_CLIENTSpecifies the SAP client. Three-digit client number; preserve leading zeros if they appear in the number
JCO_LANGSpecifies the login language. ISO two-character language code (for example, EN, DE, FR), or SAP-specific single-character language code.
JCO_SYSNRIndicates the SAP system number.

Define attribute provisioning rules

The out-of-the-box configuration of the SAP managed system provides rules for writing into the following SAP fields of the user object:

  • USERNAME
  • BAPIPWD:PASSWORD
  • E_MAIL:ADDRESS
  • FIRSTNAME:ADDRESS
  • LASTNAME:ADDRESS
  • PROFILE:PROFILES
  • ROLE:ROLES

Synchronization

Instructions on how to set up synchronization is provided in a separate section. However, OpenIAM provides out-of-the-box sync configurations for SAP. An example of a search query: USERNAME LIKE 'TEST.USERSAP' or USERNAME LIKE '%'.

Connector troubleshooting and tips

Connector troubleshooting could be done by raising logging level to DEBUG mode: -Dlogging.level.org.openiam=DEBUG

Video tutorial