Configure Kerberos Single Sign-On (SSO) Settings

This applies to: Visual Data Discovery

Kerberos is an enterprise authentication protocol that uses the concept of tickets and three-way authentication to enable users and computers to identify themselves and secure access to resources.

Symphony supports Kerberos as a Single Sign On (SSO) mechanism. Using Kerberos SSO, users can seamlessly log into Symphony and administrators can completely externalize and centrally manage users or group memberships using their existing Kerberos infrastructure. You can learn more about Kerberos here.

How It Works

When using Kerberos with Symphony, the workflow is as follows:

A user logs in to his company domain (for example, logging into his windows workstation) and is authenticated with Kerberos. In the case of Windows environments, this is likely Active Directory.
In a browser window, a user visits the Symphony application and Symphony then leverages the user's Kerberos identity to automatically log them into Symphony. If this is a users first visit to Symphony, then Symphony will auto-provision them as a new user in the Symphony environment.
Kerberos authentication is often paired with LDAP to look up a user's authorization or group membership. Symphony will look up the user's group membership. For more information, see the topic on Use Lightweight Directory Access Protocol (LDAP) With Symphony .

Prerequisites

Before you start configuring settings for Symphony to use Kerberos, you must:

Create a Kerberos Principal. For more information on how to create a Kerberos Principal, refer to Kerberos documentation.
Create the keytab file on the instance where KDC runs and upload it to Symphony Server.

If you have Kerberos enabled, you must use a static context path for the Symphony login URL. Multiple or dynamic context paths are not supported at this time.

How to Generate the Keytab File

To generate the .keytab file for existing AD users, run the following command on AD server:

ktpass   
-out <file_name>.keytab   
-princ <HTTP/zoomdata_host> @<realm>   
-mapUser <user_name>	
–pass <user_password>	
-crypto RC4-HMAC   
-pType KRB5_NT_PRINCIPAL

To generate the .keytab file for existing MIT LDAP user, run the following command on LDAP server side:

$kadmin   
kadmin: xst -e "rc4-hmac" -k <file_name>.keytab <HTTP/zoomdata_host> @<realm>

Configure General Settings

To configure the Kerberos settings for Symphony Server, complete the following steps:

Enable the Kerberos SSO service on the Security Services tab. Keep in mind, that if you have SAML or x509 authentication enabled, you will have to disable them first to use Kerberos.
Restart the Symphony server by running the following command:
```
sudo service zoomdata restart
```
Log in as a supervisor and select Security. Navigate to the Kerberos Settings tab.
Slide the Enable Kerberos switch on (to the right).
Specify the Kerberos Service Principal.
Select Upload Kerberos Keytab File and upload the .keytab file, that you have generated before.
Select the Include Kerberos realm/domain name in auto provisioned Symphony username if you want to have the user name in the following format: username@realm.
Save your settings.

Configure the Settings on the Client Side

Perform the steps listed below on the client instance that will connect to kerberized Symphony.

Install the Kerberos command line tools:

sudo yum install krb5-workstation   
sudo yum install krb5-libs

Navigate to the krb5.conf file and specify the host on which Symphony server runs:

[libdefaults]   
default_realm = ZOOMDATA.LOCAL   
[realms]   
ZOOMDATA.LOCAL = {   
kdc = <composer_host>.local   
admin_server = <composer_host>.local   
}   
[logging]  
default = FILE:/var/log/krb5.log
kdc = FILE:/var/log/krb5.log
[domain_realm]  
.zoomdata.local = ZOOMDATA.LOCAL 
zoomdata.local = ZOOMDATA.LOCAL

List all the Kerberos tickets available on the current instance:
```
klist
```
Remove all the Kerberos tickets (if there are any):
```
kdestroy -A
```
Obtain a Kerberos ticket for a user (the realm is not required if there is a default one specified in krb5.conf):
```
kinit user@ZOOMDATA.LOCAL
```
Configure your browser to support Kerberos SSO to Symphony.

To authenticate a user with a Kerberos ticket in Symphony, you must either enable LDAP autoprovisioning or create a user with the same name in Symphony.