Configuring Kerberos authentication
As a Remedy Single Sign-On administrator, you can configure Remedy Single Sign-On server to authenticate only those users whose IP addresses are defined in a realm configured to use Kerberous authentication method.
When an end user tries to login through a realm, the Remedy SSO server checks if the IP of the user belongs to the range of IP addresses specified for this realm. If the IP address of the user exists in the configured range of IP addresses, then Remedy SSO server sends the user to login through this identity provider (IdP), else it skips this IdP and moves on to the next IdP in the authentication chain.
Kerberous authentication configuration process overview
To configure Kerberous authentication, perform the following tasks:
- As an Active Directory (AD) administrator, create a service account in Active Directory.
- As an AD administrator, add an SPN mapping for the service account.
- (Optional) As s a user who has access to the domain controller, generate a keytab file if you want to provide the credentials through a keytab file.
- As a Remedy SSO administrator, configure the Kerberos authentication.
- As a system administrator, configure a browser on the end users' computers, or provide instructions to end users how to configure their browser for Kerberous authentication. For information about configuring a browser, see Configuring a browser
Before you begin
- As an AD administrator, you must have the following information in place:
- The user name and password of the service account which will be used by Remedy SSO server to connect to the Domain Controller for authentication.
- The FQDN of the machine where Remedy SSO server is installed.
You must have administrative permissions to run the
As a Remedy SSO administrator, perform the following tasks:
- Service account name and service account password for Remedy SSO if you plan to use SPN credential type.
- Keytab file if you plan to use the keytab credential type.
To create a service account in Active Directory
- Go to the Active Directory.
- Right click Users > New > User.
- Enter the user name and the user logon name in the First name and User logon name fields.
- Click Next.
- Enter user password in the Password and Confirm password fields.
- Select the User cannot change password and Password never expires check boxes.
- Click Next.
- Click Finish.
To add a Service Principal Name mapping for the service account
In one of the directories on the Active Directory machine, run the following command:
setspn -S HTTP/<HOST> <USER>
The following table describes the command variables:
Fully qualified domain name of the host on which Remedy SSO server runs including the internet domain
|<user>||Logon name of the service account.|
setspn -S HTTP/access.bmc.com remedyssoservice
After you run the command, HTTP/<host> Service Principal Name (SPN) is automatically assigned to the user.
To generate a keytab file
Run the following command on the command line interface in an appropriate directory:
ktpass /out <FILE> /princ HTTP/<HOST>@<DOMAIN> /pass <PASSWORD> /crypto ALL /ptype KRB5_NT_PRINCIPAL /Target <DOMAIN> /kvno 0
The following table describes the command variables:
|<file>||Name of the keytab file that will be generated.|
Fully qualified domain name of the host on which Remedy SSO server runs including the internet domain.
|<domain>||The Active Directory domain name written in uppercase.|
|<password>||Password of the user.|
ktpass /out c:\remedyssoservice.keytab /princ HTTP/access.example.com /crypto ALL /pass RemedySs0service /ptype KRB5_NT_PRINCIPAL /Target RSSO.COM /kvno 0
A keytab contains the Service Principle Name (SPN) credentials for the Remedy SSO server to communicate with the Domain Controller. The clients use the SPN to request a service ticket during the authentication process.
In the left navigation panel of the Add Realm or Edit Realm page, click Authentication.
In the Authentication Type field, click KERBEROS.
Enter the required Kerberos details:
Name of the Kerberos real. You must enter the realm in upper case.
Service Principal Name (SPN)
- If keytab is used, provide the full form of the SPN. For example, HTTP/access.bmc.com.
- If keytab is not used, specify the login name of the integration user.
Credential type to be used by Remedy SSO server to log on to. Select one of the following:
- SPN Password
- Keytab File
SPN Password Password for the service account. This field is available only if you select SPN Password in the Credential Type field. Keytab File
Path to the keytabfile. This field is available only if you select Keytab File in the Credential Type field.
In Remedy SSO server cluster environment, each Remedy SSO server node must contain the samekeytabfile andkeytabfile path.
Select one of the following formats from the list to transform the user id after a successful login.
- user - Retains the User ID
- user@domain - User ID with the Kerberos domain as suffix
- domain\user - User ID preceded by the domain
User ID Transformation Options to transform the login IDs provided by the authentication provider to match the user IDs available in the user store. For more information, see Transforming User ID to match Login ID. Included IP Range(s)
The IP address for Kerberos authentication. You can also specify a range of IP addresses separated by a comma .
Only the clients whose IP address match with the IP addresses configured in this field are authenticated by Kerberos authentication. All other requests coming from the IP addresses that are not configured in this field are passed on to the next IdP in the authentication chain.
If you do not specify any IP address, Remedy SSO server authenticates all the IP addresses using Kerberos authentication.
The following table provides some of the examples of IP addresses that you can configure:
Example Description 127.0.0.1 Single IP address. 127 Value for IP address 0.0.0127. 127.0.0.* All IPs from 127.0.0.1 to 127.0.0.255, such as 127.0.0.1, 127.0.0.2, and so on. 127.0.0.1-255 A range of IP addresses from 127.0.0.1 to 127.0.0.255. 127.0.0.1/8 All IPs from 127.0.0.1 to 127.255.255.255. IPv6 2620:0:2d0:200::7/32 All IPs from 2620:0:0:0:0:0:0 to 2620:0:ffff:ffff:ffff:ffff:ffff:ffff.
- Click Test to verify the settings.
- (Optional) Select the Enable AR authentication for bypass check box to enable bypass URL to authenticate against AR. For more information about enabling BMC Remedy AR System authentication for bypass, see .
- (Optional) Click Enable Chaining Mode to enable authentication chaining and perform the following steps. For more information about the authentications that you can chain with LDAP, see Authentication chaining.
- Click Add Authentication.
- Select the required authentication type and enter the authentication details.
- Repeat Step a through Step b to add more authentications for the realm.
Configuring a browser
After you have configured the Active Directory and Kerberos authentication settings, you must make sure that the browser on an end user's system is configured to support Kerberos authentication.
To configure Internet Explorer
- Navigate to Tools > Internet Options > Advanced.
- On the Advanced tab and in the Security section, select Enable Integrated Windows Authentication (requires restart).
- On the Security tab, select Local Intranet.
- Click Custom Level.
- In the User Authentication/Logon section, select Automatic logon only in Intranet zone.
- Click OK.
- Click Sites and select all check boxes.
- Click Advanced and add Remedy SSO service website to the local zone (the website might be already added). For example, sample.bmc.com.
- Click Add.
- Click OK for all pop-ups.
To configure Google Chrome
Google Chrome also supports Kerberos authentication. If you have configured Internet Explorer, then no additional settings are required for Google Chrome because it uses Internet Explorer settings.
To configure Mozilla Firefox
- In the browser window, enter the following URL: about:config.
- Click I accept the risk!
Search for network.negotiate-auth.trusted-uris by the Preference Name, and double click it.
Type a FQDN of the Remedy SSO server, for example, sample.bmc.com.
- Search for network.automatic-ntlm-auth.trusted-uris by the Preference Name, and double click it.
- Type a FQDN of the Remedy SSO server, for example, sample.bmc.com.
- Click OK.