Mapping the BMC Remedy AR System users to the chat server
There are two ways to map the BMC Remedy AR System users to the chat server:
To use the Openfire AR Authentication plugin (arauth.jar) for mapping
The Openfire AR Authentication plugin allows BMC Remedy AR System users to get authenticated automatically on the Openfire server.
Follow the steps given below to install the Openfire AR Authentication plugin:
- Stop the Openfire process.
Go to https://communities.bmc.com/communities/docs/DOC-19158 and copy the arauth.jar to the OpenfireInstallDir/libdirectory.
The BMC Remedy AR System Authenticator Plugin is tested with Openfire 3.7.1.
- Copy the arapi<version-number>.jar, and the arutil<version-number>.jar files from <mid tier installation directory>\WEB-INF\lib to the OpenfireInstallDir/lib directory.
- Start the Openfire Server.
- Open the Openfire Administration Console (
) and go to Server > System Properties.
- Click the Edit icon for the
provider.auth.classNameproperty and change the value to
- Click Save Propertyand add the following properties under the Add new property section:
- (When using third-party applications) To connect to the Openfire server on behalf of BMC Remedy AR System user, add the following AR Server entries under the Add new property section:
<Remedy-App-Service-Password property value in the ar.cfg file of that server>
You can add multiple servers if you are using the same Openfire server for other BMC Remedy AR System servers.
- Click the Edit icon for the
Stop and restart the Openfire server and ensure that you are able to log on to Openfire Administration Console using Openfire admin credentials. Then, log on to Openfire server by using the BMC Remedy AR System user name and password with external chat clients. For example, pidgin.
If the Openfire server has installed this AR Authentication Plugin, change the value of the
XMPPServerHasARAuthPluginproperty to true in the ChatConfig Definition Name as specified in the Configuring the BMC Remedy AR System server to work with the chat server section.
If you are unable to log on to the Openfire Administration Console using Openfire administrator credentials, try the following step to resolve the issue. Log on to the database which you have configured with the Openfire server and open the ofProperty table. Change the value of propValue column to org.jivesoftware.openfire.auth.DefaultAuthProvider in the row where name column value is provider.auth.className. After making these changes, log on to the Openfire Administration Console using Openfire admin credentials and carefully examine existing properties from step 5 above and make necessary corrections.
To use the AR System Chat User Mapping form for mapping
Using the AR System Chat User Mapping form, you can create the Openfire users manually (or use existing users) and map them to the BMC Remedy AR system users. The mapped user is used to log on to the Openfire server.
When BMC Remedy AR System users are mapped to the Openfire users, do not install the AR Authentication plugin on the Openfire server.
For mapping the BMC Remedy AR System user names that are not XMPP compliant to the Chat user names, open the AR System Chat User Mapping form in a browser.
The user names that do not contain spaces, capital letters, or a combination of letters from a to z and numbers from 0 to 9 are XMPP compliant. For the BMC Remedy AR System user names that are not XMPP complaint, provide the appropriate XMPP compliant user name, so that this mapped user name can be used for logging on to BMC Remedy AR System from external clients.
Provide the required information in the AR System Chat User Mapping form as follows:
AR System Chat User Mapping form fields
AR User ID
Manually type the BMC Remedy AR System user ID.
Ensure that the ID is a valid XMPP ID that contains no white spaces and consists of only a-z lowercase letters and 1-9 digits.
Chat User ID
The chat server user ID.
The chat user password.
A reference field for future use. For the current version, set the value to Openfire (or any other XMPP chat server that you are using).
- Save the form.