This section describes how to ensure that the is configured correctly to connect to Hive when Ranger is enabled for Hive. Ranger provides role-based authorization for Hive and other Hadoop components on the Hortonworks platform.
- This documentation was last validated for the Ranger version included with HDP 2.3.x.
Ranger effectively functions as a whitelist of URI's; by default, access is denied for any object in Hive. When a URI is requested, Ranger checks HDFS for permissions for the authenticated user. If HDFS denies access, then Ranger checks its defined set of URI's for the permission and, if a match is found, grants access for the authenticated user.
Before you begin, please verify that your enterprise has deployed both Hive and Ranger according to recommended configuration practices. For more information, please consult the documentation that was provided with your Hadoop distribution.
Secure Impersonation with and Hive with Ranger
Secure impersonation ensures consistent and easily traceable security access to the data stored within your Hadoop cluster.
NOTE: Although not required, secure impersonation is highly recommended for connecting the platform with Hive.
Since secure impersonation for the combination of Hive Server 2 and Ranger is not supported by Ranger, you must apply the following additional configuration changes to the to enable secure impersonation in the environment:
- Enable the platform with secure impersonation. See Configure for secure impersonation for details.
- Add the hive service user
hive to the Unix or LDAP group .
Set the following parameter:
"hdfs.permissions.userUmask" = 027
- Ensure that the Unix or LDAP group has read access to the Hive warehouse directory, as described in the following section. For more information, see http://hortonworks.com/blog/best-practices-for-hive-authorization-using-apache-ranger-in-hdp-2-2/.
Users and Groups for Ranger
When the is enabled with secure impersonation and submits requests to Hive, the following steps occur:
- The platform authenticates as the user through Kerberos.
The Hive server authorizes access to the underlying table through Ranger as the Hadoop principal user assigned to .
NOTE: This Hadoop principal is the user that should be configured through policies in Ranger to have the appropriate privileges.
- The Hive server executes access to the physical data file on HDFS as the Unix user
hive, which should be part of the group .
NOTE: In UNIX environments, usernames and group names are case-sensitive. Please verify that you are using the case-sensitive names for users and groups in your Hadoop configuration and .
Policies in Ranger
In Ranger, you can configure access through policies. A Ranger policy is a combination of:
- Specified database, table, or tabled column
- Permissions associated with that specified object.
- Assignment of permissions to individual users or groups
NOTE: In general, to manage access through Ranger, permissions to underlying Hadoop components such as HDFS or Hive should be minimized within those components. All permissions in Ranger are additive, which means that you should be careful about overlapping users and groups.
The following components require these permissions at a minimum to be assigned to the Hadoop principal:
|HDFS||Read, Write, Execute|
Create (for Hive publishing)
NOTE: The following configuration is required for integration of HDP 2.6 with Hive publishing when Ranger is enabled.
- In the Ambari console, navigate to the following: HDFS -> Configs -> Advanced -> Advanced ranger-hdfs-plugin-properties.
Set the following to
true: Enable Ranger for HDFS.
Set the following to
true: Enable Ranger for Hive.
- Restart the HDP cluster.
- Open Ranger.
In the policies area, create the following two policies:
- Set the following properties on these policies:
- Policy Type:
- Resource path:
trifacta_policies, set this value to either of the following values:
hive_warehouse, set this value to the location of the Hive warehouse. The following is the default value:
NOTE: Policies must be recursive.
Save the policies.
After you have completed your configuration changes, you should restart the platform. See Start and Stop the Platform.
To verify platform operations, run a simple job. For more information, see Verify Operations.