By default, Workbench authenticates itself to the Endeca Configuration Repository using the JCR repository's administrator credentials.

Workbench uses Oracle Wallet, a file-based credential store, to safely store administrator authentication credentials. The credential store is represented as cwallet.sso and is located at ToolsAndFrameworks\<version>\server\workspace\credential_store. The administrator credential in the store is composed of a user name and password that is uniquely identified by a map name and a credentials key combination. Therefore, one set of credentials containing a map name and a credentials key maps to one set of a username and a password pair. This map name and credentials key for the administrator user are stored as properties in the WorkbenchConfig.xml file.

<custom-bean id="csfManager" class="com.endeca.soleng.eac.toolkit.util.CSFManager">
      <property name="jpsConfigPath" value="C:\Endeca\ToolsAndFrameworks\11.2.0\server\workspace\credential_store\jps-config.xml" />
      <property name="mapName" value="endecaToolsAndFrameworks"/>
</custom-bean>

    <custom-component id="IFCR" host-id="ITLHost" class="com.endeca.soleng.eac.toolkit.component.IFCRComponent">
      <properties>
        <property name="repositoryUrl" value="http://@@HOST@@:@@WORKBENCH_PORT@@/ifcr" />
        <property name="numExportBackups" value="3" />
        <property name="credentialsKey" value="ifcr"/>
      </properties>
      <custom-bean ref="csfManager"/>
    </custom-component>

To specify the Workbench authentication credentials for the Endeca Configuration Repository:

  1. Change the administrator password in the Endeca Configuration Repository and update the administrator credentials used by Deployment Template scripts to connect to the Endeca Configuration Repository. Workbench stores these credentials in the Oracle Wallet credentials store.

    1. Navigate to the <installation path>\ToolsAndFrameworks\<version>\credential_store\bin directory.

    2. Run the manage_credentials script using this format

      manage_credentials.bat/sh add [--config path] [--mapName map_name] 
      [–-user user_id] [--key key_name] 
      [--ecrBaseUrl http://localhost:8006/ifcr/system/userManager/user/admin.changePassword.json] 
      [--type (password|generic)]

      For example,

      manage_credentials.bat add --user admin --key ifcr 
      --ecrBaseUrl http://localhost:8006/ifcr/system/userManager/user/admin.changePassword.json

      The config, mapName, and type flags are not specified and the corresponding default values are used.

    3. Since the credential already exists, you are prompted to replace it. Enter yes.

    4. When you are prompted for your new password, enter and confirm the password that you want to use.

      The credentials store is updated with the new administrator password.

  2. Update the credentials that Workbench uses to connect to the Endeca Configuration Repository.

For further information about Sling user management, consult the Apache documentation.


Copyright © Legal Notices