Using Kerberos with Docker Image | Teradata Vantage Modules for Jupyter - Using Kerberos with the Docker Image - Teradata Vantage Modules for Jupyter

Teradata Vantageā„¢ Modules for Jupyter Installation Guide

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Lake
Product
Teradata Vantage Modules for Jupyter
Release Number
4.0
Published
March 2025
ft:locale
en-US
ft:lastEdition
2025-12-05
dita:mapPath
nuw1535116212598.ditamap
dita:ditavalPath
oqt1542232706976.ditaval
dita:id
nuw1535116212598
Product Category
Teradata Vantage
PrerequisiteMake sure the Kerberos configuration is working fine in the system.
  1. Check with your IT administrator for details about your Kerberos configuration, and create/generate krb5.conf and Keytab files.
    To create the krb5.conf file:
    1. Update the following krb5.conf with the details for your Kerberos configuration:
      [libdefaults]
          ticket_lifetime = 24h
          renew_lifetime = 7d
          default_realm = KRB5JUPYTER.TDAT
          clockskew = 13000
          checksum_type=2
          allow_weak_crypto = true
       
       
      [realms]
       KRB5JUPYTER.TDAT = {
              kdc = mykrbhost.krb5jupyter.tdat:88
              default_domain = KRB5JUPYTER.TDAT
           }
       
      [domain_realm]
          krb5jupyter = {
              .krb5jupyter = KRB5JUPYTER.TDAT
              krb5jupyter = KRB5JUPYTER.TDAT
              .mykrbhost.krb5jupyter.tdat = KRB5JUPYTER.TDAT
           }
       
      [logging]
          kdc = FILE:/var/log/krb5/krb5kdc.log
          admin_server = FILE:/var/log/krb5/kadmind.log
          default = SYSLOG:NOTICE:DAEMON
      
    2. Set the ticket_lifetime to an appropriate value.

      When the ticket expires, you can continue to access the Analytics Database on existing connections. To establish new connections, you need to restart the Docker container.

    To generate the Keytab file:

    Use the tools supported by your local platform to generate a Keytab file for your username.

  2. Load the krb5.conf file and the keytab file for your username to the Docker image.
  3. Set the KRB_USER environment variable with your username.

For example:

The krb5.conf file and the keytab file for the user "testuser" are in the directory ~/kerberos on the local machine. To start your docker image, run:
docker run -e "accept_license=y" -p 8888:8888 -v teradata-vol:/home/jovyan/JupyterLabRoot -v ~/kerberos/krb5.conf:/etc/krb5.conf -v ~/kerberos/testkrb.keytab:/etc/testuser.keytab -e KRB_USER=testuser <image name>