Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

NOTE: CustomerID versions older than 6.1 are not compatible with SSO 9.1. So before proceeding with this step after SSO installation you need to download the respective CustomerID installation package from Identity Server 2022.2 release.

Ubisecure CustomerID package includes the CustomerID SSO Adapter extension to SSO (it was previously called Ubisecure CustomerID Authorizer). It needs to be installed so that role based policies can be utilized in CustomerID. It also includes functionality related to user driven federations.

...

  1. After upgrading SSO (as instructed in page  Upgrading SSO in Windows ), prior to removing the temporary ubilogin-sso-old folder, go to the folder containing the old configuration files:

    Code Block
    languagetext
    cd /D "%PROGRAMFILES%\Ubisecure\ubilogin-sso-old\ubilogin\webapps\uas\WEB-INF\"


  2. Copy the existing configuration files to the new installation folder: 

    Code Block
    languagetext
    copy 
    attribute-prefix.index
    eidm2-authorizer.properties 
    
    to
    %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\


    Note

    NOTE: If you are upgrading from an installation where the previous CustomerID SSO Adapter has been from a CustomerID version older than 5.0.x then you need to check the attribute-prefix.index configuration file contents. The value for the eimd property has changed from com.ubisecure.customerid.authorizer.EIDM2Authorizer to com.ubisecure.customerid.authorizer.CidAuthorizer.


  3. Define UBILOGIN_HOME environment variable for the SSO server so that it points to the SSO installation path: %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin 

    Code Block
    languagetext
    set UBILOGIN_HOME=%PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin


  4. Transfer the cid-sso-adapter-package-x.x.x-windows.zip file to the SSO server and extract it for example under the following folder: %PROGRAMFILES%\Ubisecure
  5. Run the CustomerID SSO Adapter update script: 

    Code Block
    languagetext
    cd /D "%PROGRAMFILES%\Ubisecure\cid-sso-adapter"
    update.cmd

    The CustomerID SSO Adapter jar files will be integrated to the SSO installation.

  6. Remove older versions of duplicate jar files from SSO: %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\lib

    Note

    NOTE: If you are upgrading from an installation where the previous CustomerID SSO Adapter has been from a CustomerID version older than 5.0.x then you need to remove old CustomerID Authorizer files. The files that need to be removed are: commons-lang.jar, eidm2-authorizer.jar, eidmutil.jar, json-simple.jar and jsr305.jar. Remove the files from these folders: %PROGRAMFILES%\Ubisecure\ubilogin-sso\tomcat\webapps\uas\WEB-INF\lib and %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\lib


    Note

    NOTE: If you are upgrading from an installation where the previous CustomerID SSO Adapter has been from a CustomerID version 5.0.x or newer then you may need to remove old versions of CustomerID SSO Adapter related jar files. The files that need to be checked are: cid-model-x.x.x.jar, cid-sso-adapter-x.x.x.jar, cid-util-x.x.x.jar, commons-lang3-x.x.jar, guava-x.x.jar and json-simple-x.x.x.jar. Remove the old versions of these files from these folders: %PROGRAMFILES%\Ubisecure\ubilogin-sso\tomcat\webapps\uas\WEB-INF\lib and %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\lib. The removal should be done after running the update.cmd script.


  7. Run update on SSO in order to finalize the installation of the CustomerID SSO Adapter. This can be done with the following command: 

    Code Block
    languagetext
    "%PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\config\tomcat\update.cmd"

    Ensure that the SSO diagnostics diagnostic log (uas3sso_diag.year-month-day.log, which is by default located at %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\logs) contains the following rows (with the current time): 

    Code Block
    languagetext
    20162022-0910-0206 1307:5725:4925,021711 uas init INFO CustomerID Authorizer started
    20162022-0910-0206 1307:5725:4925,021711 uas authz INFO eidm.authorizer: CidAuthorizer init started.
    20162022-0910-0206 1307:5725:4926,209083 uas init INFO CustomerID SQL: customeriddb PostgreSQL x12.x.x8
    20162022-0910-0206 1307:5725:4926,224130 uas authz INFO eidm.authorizer: CidAuthorizer init done.
    20162022-0910-0206 1307:5725:4926,224130 uas init INFO eidm: com.ubisecure.customerid.authorizer.CidAuthorizer: started