Hive Authorization

Disclaimer

Hive authorization is not completely secure. In its current form, the authorization scheme is intended primarily to prevent good users from accidentally doing bad things, but makes no promises about preventing malicious users from doing malicious things.

Prerequisites

In order to use Hive authorization, there are two parameters that should be set in hive-site.xml

...

Note that, by default, the hive.security.authorization.createtable.owner.grants are set to null, which would result in the creator of a table having no access to the table.

Users, Groups, and Roles

At the core of Hive's authorization system are users, groups, and roles. Roles allow administrators to give a name to a set of grants which can be easily reused. A role may be assigned to users, groups, and other roles. For example, consider a system with the following users and groups:

...

It is important to realize that Hive Metastore only controls authorization for metadata, and the underlying data is controlled by HDFS, so if permissions and privileges between the two systems are not in sync, users may have access to metadata, but not the physical data. If the user -> group mappings across the Metastore and Namenode are not in sync, as in the scenarios above, a user may have the privileges required to access a table according to the Metastore, but may not have permission to access the underlying files according to the Namenode. This could also happen due to administrator intervention, if permissions on the files were changed by hand, but Metastore grants had not been updated.

Creating/Dropping/Using Roles

Create/Drop Role

CREATE ROLE role_name

DROP ROLE role_name

Grant/Revoke Roles

GRANT ROLE role_name [, role_name] ...
TO principal_specification [, principal_specification] ...

REVOKE ROLE role_name [, role_name] ...
FROM principal_specification [, principal_specification] ...

principal_specification
  : USER user
  | GROUP group
  | ROLE role

Viewing Granted Roles

SHOW ROLE GRANT principal_specification

Privileges

The following privileges are supported in Hive:

• ALL - Gives users all privileges
• ALTER - Allows users to modify the metadata of an object
• UPDATE - Allows users to modify the physical data of an object
• CREATE - Allows users to create objects. For a database, this means users can create tables, and for a table, this means users can create partitions
• DROP - Allows users to drop objects
• INDEX - Allows users to create indexes on an object (Note: this is not currently implemented)
• LOCK - Allows users to lock or unlock tables when concurrency is enabled
• SELECT - Allows users to access data for objects
• SHOW_DATABASE - Allows users to view available databases

Grant/Revoke Privileges

GRANT
    priv_type [(column_list)]
      [, priv_type [(column_list)]] ...
    [ON object_type]
    TO principal_specification [, principal_specification] ...
    [WITH GRANT OPTION]

REVOKE
    priv_type [(column_list)]
      [, priv_type [(column_list)]] ...
    [ON object_type priv_level]
    FROM principal_specification [, principal_specification] ...

REVOKE ALL PRIVILEGES, GRANT OPTION
    FROM user [, user] ...

object_type:
    TABLE
  | DATABASE

priv_level:
    db_name
  | tbl_name

Viewing Granted Privileges

SHOW GRANT principal_specification
[ON object_type priv_level [(column_list)]]

Hive Operations and Required Privileges

As of the release of Hive 0.7, only these operations require permissions, according to org.apache.hadoop.hive.ql.plan.HiveOperation:

...