Installing the connector

Based on the nature of your deployment, follow the procedures below to deploy the connector.

Docker swarm

To start this connector in a Docker Swarm deployment, follow the steps described below:

• Uncommment the following line in setup.sh file

setup.sh - #docker pull "openiamdocker/rexx-connector-rabbitmq:debian-${OPENIAM_VERSION_NUMBER}-${BUILD_ENVIRONMENT}

• Uncomment the following line in startup.sh file

#docker stack deploy --compose-file connectors/rexx/docker-compose.yaml --with-registry-auth rexx-connector

For the changes to take effect you will need to stop your OpenIAM containers and then run:

./setup.sh
./startup.sh

General information

Rexx connector allows to synchronize users from Rexx HR system to OpenIAM.

Configuring managed system

Rexx managed system should be configured as described below:

• Go to Webconsole -> Provisioning -> Managed System -> Rexx Managed system
• Configure fields according to your environment:
  • Host,
  • Password - authentication token you have for Rexx API
  • Test API Id - the numeric id for interface can be used for test calls
  • Export API Id - the numeric id for interface can be used for export users to Rexx
  • Import API Id - the numeric id for interface can be used for import users from Rexx
  • Unique Attribute - the name of Rexx attribute that must be unique for every user

Rexx provisioning

Provisioning to Rexx system is performed according to Rexx system requirement. OpenIAM send user data to Rexx system in csv file. Header of csv file includes names of attributes in policy map for Rexx managed system. During provisioning every user creates a new row in a file /tmp/Users_Export.csv. If we try to write information about user that already have an entry in file (it is recognized by Unique Attribute) old row will be deleted and new one will be added.

File is sending to Rexx HR system in 2 cases:

• every hour
• when header of csv file was changed - we made changes for policy map or order of attributes changed