Kerberos authentication

Overview


Domino supports Kerberos authentication, allowing users to authenticate as themselves when connecting to Kerberos-secured systems.

Users can enable Kerberos authentication at the project-level or user-level by uploading a Kerberos keytab and principal into Domino. Once set up, Runs started by Kerberos-enabled users or in Kerberos-enabled projects in Domino will automatically run kinit and retrieve the ticket to be able to authenticate.

 

 

 

 

 

Contents


 

 

 

 

 

Adding your Kerberos configuration file to Domino


There are two ways to add your krb5.conf file to Domino.

  1. Add it to your project in a folder named kerberos:

    Screen_Shot_2019-02-04_at_8.48.07_PM.png


  2. Add it to your environment at /etc/krb5.conf:

    RUN echo "[libdefaults]" >> /etc/krb5.conf && \
        echo "    default_realm = [YOUR-DEFAULT-REALM]" >> /etc/krb5.conf && \
        echo "    default_tkt_enctypes = des3-hmac-sha1 des-cbc-crc" >> /etc/krb5.conf && \
        echo "    default_tgs_enctypes = des3-hmac-sha1 des-cbc-crc" >> /etc/krb5.conf && \
        echo "    dns_lookup_kdc = true" >> /etc/krb5.conf && \
        echo "    dns_lookup_realm = false" >> /etc/krb5.conf && \
        echo "" >> /etc/krb5.conf && \
        echo "[realms]" >> /etc/krb5.conf && \
        echo "    EXAMPLE.COM = {" >> /etc/krb5.conf && \
        echo "        kdc = kerberos.example.com" >> /etc/krb5.conf && \
        echo "        admin_server = kerberos.example.com" >> /etc/krb5.conf && \
        echo "    }" >> /etc/krb5.conf
    

 

 

 

 

 

Adding Kerberos credentials to your user


To add a keytab and principal that will be used for Runs started by your user, open your Account Settings and click Kerberos Integration from the settings menu.

Click Keytab file based authentication, supply your keytab and principal, then click Save.

 

Screen_Shot_2019-02-04_at_8.39.59_PM.png

 

 

 

 

 

Adding Kerberos credentials to your project


To add a keytab and principal that will be used for Runs started by a specific project, open the project Settings and click to open the Integrations tab.

In the Kerberos panel, click Keytab file based authentication, supply your keytab and principal, then click Save.

 

Screen_Shot_2019-02-04_at_8.39.59_PM.png

Was this article helpful?
0 out of 0 found this helpful