Setting up Kerberos authentication in Remedy SSO

Before you begin

• You must have installed and configured the Remedy SSO to work with the Presentation Server and its component products. For details, see Planning to deploy Remedy SSO and Installing Remedy Single Sign-On.

• You must have created an equivalent local user(and its associated local usergroup) for every Kerberos user that needs to log into the Presentation Server. This is required because the Remedy SSO server cannot obtain usergroup information from the Kerberos identity provider for the successfully logged in Kerberos user. Therefore, you need to create an equivalent local user with the exact name as the Kerberos user and associate that local user with the desired local usergroup. For details on creating local users and usergroups in Remedy SSO using the import utility, perform the Migrating internal user data from Atrium SSO to Remedy SSO procedure.

• You must have added a non-default tenant (realm) in addition to the default * tenant (realm). Configuring-tenants-for-the-Presentation-Server-in-Remedy-SSO.

• You must have configured a multi-tenant environment by enabling the msp parameter. For enabling multi-tenancy, see To enable multi-tenancy in Presentation Server.

  Note

  Kerberos cannot be configured using the * (default realm) tenant.

• Create a service account in Active Directory and configure the Service Principal Name (SPN)
• Obtain the following information:
  • Host name of the Key Distribution Center (KDC)
  • Kerberos realm created for Remedy SSO on Key Distribution Center
  • Service account name for Remedy SSO
  • Service account password if SPN credential type is to be used
  • Keytab file if keytab credential type is to be used

Configuring Active Directory 

Creating a service account in Active Directory 

1. Go to Active Directory.
2. Right-click Users > New > User.
3. Enter the user name and the user logon name in the First name and User logon name fields.
4. Click Next.
5. Enter user password in the Password and Confirm password fields.
6. Select the User cannot change password and Password never expires check boxes.
7. Click Next.
8. Click Finish.

Adding an SPN mapping for the service account 

• Before you begin
• To add an SPN mapping

Before you begin

• Ensure that you have the user name and password for the service account.
• Ensure that you have the machine name where Remedy SSO server runs.

To add an SPN mapping

• <HOST>: Fully qualified domain name of the host on which Remedy SSO server runs including the internet domain.
• <REALM>: Name of the Kerberos realm.
• <USER>: Logon name of the service account.

(Optional) Generating a keytab file 

• Before you begin
• To generate a keytab file

Before you begin

• Obtain the user name and password for the service account.
• Obtain the machine name where Remedy SSO server runs.
• Ensure that you have appropriate administrative permissions to run the ktpass command.

To generate a keytab file

• <FILE>: Name of the keytab file that is to be generated.
• <HOST>: Fully qualified domain name of the host on which Remedy SSO server runs including the internet domain.
• <DOMAIN>: Active Directory domain name written in uppercase.
• <PASSWORD>: Password of the user.

Configuring Kerberos authentication in Remedy SSO for the TrueSight Presentation Server

Perform the following procedures to configure the Kerberos authentication for TrueSight Presentation Server:

• To configure the Kerberos authentication in Remedy SSO for the TrueSight Presentation Server
• To create or edit an authorization profile with Kerberos users in the Presentation Server

To configure the Kerberos authentication in Remedy SSO for the TrueSight Presentation Server

1. Log in to the Remedy SSO Admin console.
2. In the left navigation panel of the Add Realm or Edit Realm page, click Authentication.
3. In the Authentication Type field, click KERBEROS.

4. Enter the Kerberos details. For more information on parameters, see Kerberos authentication parameters.

   Important

   When you configure the Kerberos authentication parameters for the Presentation Server, you must set the User ID Transformation field. For example, if your User ID Format value is domain\user or user@domain, you must set the User ID Transformation to RemoveDomain.

5. Click Test to verify the settings.
6. Click Save.
7. In the left navigation panel of the Add Realm or Edit Realm page, click Authentication.
8. In the Authentication Type field, click Kerberos and click Enable Chaining Mode.
9. Click Add Authentication.
10. In the Authentication Type field, click LOCAL.
11. Enter the LOCAL details. For more information on parameters, see LOCAL authentication parameters.
12. Create users and user groups for the LOCAL authentication. 
    The users in LOCAL should be exactly same as the users in Kerberos identity provider.
    Alternatively, the users can also be created using import script under the migration utility.
13. Associate users to the user groups.
14. Click Save.

To create or edit an authorization profile with Kerberos users in the Presentation Server

1. Log in to the TrueSight console as a Super Admin.
2. Navigate to Administration>Authorization Profiles.
3. Create a new authorization profile or edit an existing authorization profile to associate the user groups.

4. Select a tenant other than the * (asterisk) tenant that you configured in Remedy Single Sign-On for Kerberos users and select Edit under User Groups. 

   Note

   Do not select the * (asterisk) tenant for the Kerberos users.

   

5. Click Add and select the Kerberos user group from the list of user groups.
6. Select the required roles from the list roles.
7. (Optional) Select the required objects from the list of object.
8. Select OK and then Save.
9. Select Yes to confirm changes to the authorization profile.
10. Log out of the TrueSight console.
11. Configure the browsers for Kerberos authentication to work.
12. Log in to the TrueSight console as a Kerberos user.
    A two-step authentication screen is displayed.
13. Type the Kerberos realm Application Domain name and click Submit.
    The Kerberos login screen is displayed.
14. Type the Kerberos login credentials and click Login.
    The TrueSight console is displayed.

Configuring the browsers

After you have configured the Active Directory and Kerberos authentication settings, you must make sure that the browser on a user's system is configured to use Kerberos authentication. Ensure that the browser is not on the same computer on which you have installed Remedy SSO server.

• Configuring Internet Explorer
• Configuring Mozilla Firefox

Configuring Internet Explorer

1. Navigate to Tools > Internet Options > Advanced.
2. On the Advanced tab and in the Security section, select Enable Integrated Windows Authentication (requires restart).
3. On the Security tab, select Local Intranet.
4. Click Custom Level.
5. In the User Authentication/Logon section, select Automatic logon only in Intranet zone.
6. Click OK.
7. Click Sites and select all check boxes.
8. Click Advanced and add the Remedy SSO service website to the local zone (the website might be already added). For example, sample.bmc.com.
9. Click Add.
10. Click OK for all pop-ups.

Configuring Mozilla Firefox

1. Enter the following URL: about:config.
2. Click I'll be careful, I promise!
3. Double-click the Preference Name: network.negotiate-auth.trusted-uris.
4. Add the Fully Qualified Domain Name (FQDN) of the host, for example, sample.bmc.com.
5. Double-click the Preference Name:  network.automatic-ntlm-auth.trusted-uris.
6. Add the fully qualified domain name (FQDN) of the host, for example, sample.bmc.com.
7. Click OK.

Related topics

Kerberos authentication workflowUser ID transformationTroubleshooting authentication issues