Skip to main content

Privacera Platform

Migration from Apache Ranger UserSync to Privacera UserSync
:

Privacera generally recommends using its own version of UserSync (called Privacera UserSync) over the open-source Apache Ranger UserSync. Privacera has rewritten the Ranger UserSync to improve performance and features.

By default, all PrivaceraCloud customers are provisioned to use Privacera Usersync for improved performance capabilities and feature availability over Ranger UserSync. Below are the steps for platform customers to migrate.

All customers must migrate to use Privacera Usersync by March 31, 2024.

Migration steps

For Privacera Platform customers seeking to transition from Apache Ranger UserSync to Privacera UserSync, there are required manual steps to change the configuration.

  1. Navigate to the privacera-manager/config/custom-vars folder.

    cd privacera-manager/config/custom-vars 
  2. Rename the vars.usersync.ldaps.yml file to have a different extension (e.g. vars.usersync.ldaps.yml.bak).

  3. Ensure that the Ranger UserSync POD/Image has stopped.

    ./privacera_manager.sh stop usersync
  4. Copy the following files:

    • ../sample-vars/vars.privacera-usersync.yml

    • ../sample-vars/vars.privacera-usersync.ldap.yml

  5. Edit the vars.privacera-usersync.ldap.yml file with the desired configurations.

    Ranger UserSync Variable

    Privacera UserSync Variable

    USERSYNC_SYNC_LDAP_URL

    LDAP_URL

    USERSYNC_SYNC_LDAP_BIND_DN

    LDAP_BIND_DN

    USERSYNC_SYNC_LDAP_BIND_PASSWORD

    LDAP_BIND_PASSWORD

    USERSYNC_SYNC_LDAP_SEARCH_BASE

    LDAP_SEARCH_BASE

    USERSYNC_SYNC_LDAP_USER_SEARCH_BASE

    LDAP_SEARCH_USER_BASE

    USERSYNC_SYNC_LDAP_USER_SEARCH_FILTER

    LDAP_SEARCH_USER_FILTER

    USERSYNC_SYNC_GROUP_SEARCH_BASE

    LDAP_SEARCH_GROUP_BASE

    USERSYNC_SYNC_LDAP_GROUP_SEARCH_FILTER

    LDAP_SEARCH_GROUP_FILTER

    USERSYNC_SYNC_LDAP_OBJECT_CLASS

    LDAP_OBJECT_USER_CLASS

    USERSYNC_SYNC_GROUP_OBJECT_CLASS

    LDAP_OBJECT_GROUP_CLASS

    USERSYNC_SYNC_LDAP_SSL_ENABLED

    PRIVACERA_USERSYNC_SYNC_LDAP_SSL_ENABLED

    USERSYNC_SYNC_LDAP_SSL_PM_GEN_TS

    PRIVACERA_USERSYNC_SYNC_LDAP_SSL_PM_GEN_TS

  6. Run PM update to deploy Privacera-UserSync:

    cd ~/privacera/privacera-manager 
    ./privacera-manager.sh update

For more information, see Privacera UserSync.