Kerberos Driver Guide

  • Last update:October 20, 2025
  • Overview

    Application Scenario

    For Kerberos authentication, you need to change the database driver and URL according to this document.

    Notes

    This document introduces how to configure the driver for Kerberos authentication in common environments.


    You can refer to this document when the Kerberos authentication fails, or when the unified Kerberos configuration is required across different platforms or Kerberos versions. If the environment is built in and supports direct authentication, you do not need to use the drivers introduced in this document.

    Driver Overview

    Database Driver
    URL FormatDriver DownloadNote

    Transwarp   Inceptor

    jdbc:hive2://IP address:Port number/database;principal=hive/service@REALM;authentication=kerberos;kuser=principal;keytab=keytab   path

    transwrap.zip

    principal in the URL:

    • The value of principal is composed of three parts: xxx/xxx@xxx.

    • The value of service is not an IP address, but a computer name.

    • The value of principal needs to meet the rules in the hive-site.xml file.

    Spark

    jdbc:hive2://IP address:Port number/database;principal=hive/service@REALM

    Universal

    Hive version: hive

    Hive 2.X version: hive2.x

    Hive 3.X version:final

    Hive (single node)

    jdbc:hive2://IP address:Port number/database;principal=hive/service@REALM

    Apache   Impala

    jdbc:impala://IP address:Port number/database;AuthMech=1;KrbHostFQDN=quickstart.cloudera;KrbServiceName=impala

    Impala

    Ensure that the principal name formed by combining the KrbHostFQDN and KrbServiceName parameters can pass authentication.

    FusionInsight   HD

    jdbc:hive2://zkhost:Port number/,zkhost:Port number,zkhost:Port number/;serviceDiscoveryMode=zooKeeper;zooKeeperNamespace=hiveserver2;principal=hive/service@REALM

    ZooKeeper

    • You can confirm if ZooKeeper requires Kerberos authentication by checking the version of the ZooKeeper JAR package.

    • Ensure that the used ZooKeeper JAR package is a built-in one in a database.

    • Check the relevant configuration of ZooKeeper.

    Hive   (ZooKeeper format; commonly used in clusters)

    Phoenix

    jdbc:phoenix:quorum:Port number/database:principal:keytabPath

    Phoenix

    • You are advised to include principal and keytab in the URL.

    • Confirm whether ZooKeeper needs to be authenticated. If no authentication is required, set the zookeeper.sasl.client system parameter to false. If SASL authentication is required, ensure that the principal name is correct.

    • If the value of hbase.zookeeper.quorum is a hostname, you need to configure the corresponding mapping in the hosts file.

    HBase

    jdbc:phoenix:quorum:Port number/database:principal:keytabPath

    hbase.zip

     

    附件列表


    主题: Data Center
    Previous
    Next
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy