Permissions on the Default Column Family

If a JSON document field is in the HPE Data Fabric Database JSON default column family, you must have readperm and writeperm permissions to perform read and write operations on the field. To mask data fields, you must have the defaultunmaskedreadperm or the unmaskedreadperm permission. You either receive the permissions from the default column family, inherit them from the field's parent field, or have the permissions from an explicit grant on the field.

The following diagram shows a JSON document where all fields are in the default column family.

Granting Read and Write Permissions on Field c

To perform both read and write operations on field c, when it is in the default column family, you must have both readperm and writeperm access on field c:

  • If you have readperm and writeperm permissions on the default column family, then you have access to field c.
  • If you have readperm and writeperm permissions on field b, then you have access to field c. You do not need any further permissions. Field c inherits your readperm and writeperm permissions from field b.
  • If you have readperm and writeperm permissions on the default column family but either field a or b denied you permissions:
    • You must have traverseperm permission granted to you on the field that denied you access (field a or b).
    • You must have readperm and writeperm permissions explicitly granted to you on field c.
  • If you do not have readperm and writeperm permissions on the default column family:
    • You must have traverseperm permission granted to you on either the default column family or field b.
    • You must have readperm and writeperm permissions explicitly granted to you on field c.

The following are examples of commands that grant these permissions: 

/opt/mapr/bin/maprcli table cf colperm set 
  -path <path to JSON table > 
  -cfname default 
  -name a.b 
  -traverseperm u:<user ID> | <existing ACE for this field>             
/opt/mapr/bin/maprcli table cf colperm set 
  -path <path to JSON table > 
  -cfname default 
  -name a.b.c 
  -readperm u:<user ID> | <existing ACE for this field> 
  -writeperm u:<user ID> | <existing ACE for this field>
/opt/mapr/bin/maprcli table cf edit 
  -path <path to JSON table > 
  -cfname default 
  -traverseperm u:<user ID> | <existing ACE for this field>        
/opt/mapr/bin/maprcli table cf colperm set 
  -path <path to JSON table > 
  -cfname default 
  -name a.b.c 
  -readperm u:<user ID> | <existing ACE for this field> 
  -writeperm u:<user ID> | <existing ACE for this field>

Granting Read or Write Permission on Field c

To perform either read or write operations on field c, when it is in the default column family, you must have either readperm or writeperm access on field c:

  • If you have the same permission (readperm or writeperm) on the default column family, then you have access to field c.
  • If you have the same permission (readperm or writeperm) on field b, then you have access to field c. You do not need any further permissions. Field c inherits your readperm or writeperm permission from field b.
  • If you have the same permission (readperm or writeperm) on the default column family but either field a or b denied you permission:
    • You must have traverseperm permission granted to you on the field that denied you access (field a or b).
    • You must have readperm or writeperm permission explicitly granted to you on field c.
  • If you do not have the same permission (readperm or writeperm) on the default column family:
    • You must have the traverseperm permission granted to you on either the default column family or field b.
    • You must have readperm or writeperm permission explicitly granted to you on field c.

The following example grants traverseperm permission:

/opt/mapr/bin/maprcli table cf colperm set 
  -path <path to JSON table> 
  -cfname default 
  -name a.b 
  -traverseperm u:<user ID> | <existing ACE for this field>

The following example grants readperm permission: 

/opt/mapr/bin/maprcli table cf colperm set 
  -path <path to JSON table> 
  -cfname default 
  -name a.b.c 
  -readperm u:<user ID> | <existing ACE for this field>

Permissions for Dynamic Data Masking

In addition to the existing readperm, writeperm and traverseperm database permissions, there are two new database permissions to support Dynamic Data Masking:

  • The defaultunmaskedreadperm permission, when set at the table level, applies to all column families within that table unless otherwise overridden by the unmaskedreadperm setting at the CF or column level.

  • The unmaskedreadperm permission, when applied at the CF or column level, specifies the users who can retrieve unmasked values for the specified database column. Users with regular readperm privileges but without unmaskedreadperm privileges will only be able to view the masked data. This permission is only applicable to columns that have the dynamic data mask attribute set. Specifying this permission on an unmasked column will have no effect.

In the following example, only user mapr can read column Creditcard from the default CF of table /table1 unmasked. User user1 can read the Creditcard column, but it will be masked: 
maprcli table cf colperm set -path /table1 -cfname default \ 
  -name Creditcard -readperm "u:user1|u:mapr" -unmaskedreadperm "u:mapr" \ 
  -writeperm "u:mapr" 

maprcli table cf column securitypolicy set -path /table1 -cfname default \ 
  -name Creditcard -securitypolicy pci 

maprcli table cf column datamask set -path /table1 -cfname default \ 
  -name Creditcard -datamask mrddm_last4 

maprcli table cf column list -path /table1 -cfname default -json 

{ 

  "timestamp":1612303576139, 

  "timeofday":"2021-02-02 02:06:16.139 GMT-0800 PM", 

  "status":"OK", 

  "total":1, 

  "data":[ 

    { 

      "name":"Creditcard", 

      "aces": { 

        "readperm":"u:user1|u:mapr", 

        "unmaskedreadperm":"u:mapr", 

        "writeperm":"u:mapr" 

      }, 

      "securitypolicy":"pci", 

      "datamask":"mrddm_last4" 

    } 

  ] 

}