UI Data Protection – Role based masking in Approve Purchase Orders app of SAPUI5

Introduction

In this blog post, we will learn how to mask “Supplier Name“, “Delivery Address“, “Price“, and “Gross Amount” fields in Approve Purchase Orders application of SAPUI5.

A PFCG Role will be used for the authorization check which will allow users with the specified role to view the field value. If a user does not have this role, it means the user is not authorized and data will be protected either through masking, clearing, or disabling the field.

The end result for unauthorized users will look like below:

Prerequisite

Product “UI data protection masking for SAP S/4HANA” is used in this scenario to protect sensitive data at field level and must be installed in the S/4HANA system.

The product is a cross-application product which can be used to mask/protect any field in SAP GUI, SAPUI5/SAP Fiori, CRM Web Client UI, and Web Dynpro ABAP.

Let’s begin

Configuration to achieve masking

Logical Attribute is a functional modelling of how any attribute such as Social Security Number, Bank Account Number, Amounts, Pricing information, Quantity etc. should behave with masking.

Configure Logical Attribute – Follow the given path:

SPRO -> SAP NetWeaver -> UI Data Protection Masking for SAP S/4HANA -> Maintain Metadata Configuration -> Maintain Logical Attributes

Maintain Field Level Security and Masking Configuration

Here, we will define how masking will behave with the logical attribute that we created in above step.

Follow the given path:

SPRO -> SAP NetWeaver -> UI Data Protection Masking for SAP S/4HANA -> Data Protection Configuration -> Maintain Field Level Security and Masking Configuration

Follow below mentioned steps:

• Click on “New Entries” button
• Enter “Sensitive Entity” as “LA_APPROV_PO” and press “Enter” key. “Description” and “Application Module” will get populated in corresponding fields
• Check “Enable Configuration” check-box
• Select “Role Based Authorization” option
• Enter “PFCG Role” as “/UISM/PFCG_ROLE”. In this example, we have used a blank role “/UISM/PFCG_ROLE”. Customers can use any role as per their requirement.
• Enter “Field Level Action” as “MASK_FIELD”
• Click on “Save” button

Maintain Technical Address

In this step, we will associate the Technical Address of the fields to be masked with the Logical Attributes.

To get the Technical Address of a SAPUI5/SAP Fiori field, refer Technical Trace blog post.

Follow the given path:

SPRO -> SAP NetWeaver -> UI Data Protection Masking for SAP S/4HANA -> Maintain Metadata Configuration -> Maintain Technical Address

Follow below mentioned steps:

Under “UI5/Fiori NetWeaver Gateway Field Mapping”, maintain technical address for following fields.

• Click on “New Entries” button
• Enter “Service Name” as “SEPMRA_PO_APV”
• Enter “Entity” as “PurchaseOrder”
• Enter “Property” as “SupplierName”
• Enter “Logical Attribute” as “LA_APPROV_PO”
• Enter “Description” as “Supplier Name”
• Click on “Save” button

• Click on “New Entries” button
• Enter “Service Name” as “SEPMRA_PO_APV”
• Enter “Entity” as “PurchaseOrder”
• Enter “Property” as “GrossAmount”
• Enter “Logical Attribute” as “LA_APPROV_PO”
• Enter “Description” as “Gross Amount”
• Click on “Save” button

• Click on “New Entries” button
• Enter “Service Name” as “SEPMRA_PO_APV”
• Enter “Entity” as “PurchaseOrder”
• Enter “Property” as “DeliveryAddress”
• Enter “Logical Attribute” as “LA_APPROV_PO”
• Enter “Description” as “Delivery Address”
• Click on “Save” button

• Click on “New Entries” button
• Enter “Service Name” as “SEPMRA_PO_APV”
• Enter “Entity” as “PurchaseOrderItem”
• Enter “Property” as “GrossAmount”
• Enter “Logical Attribute” as “LA_APPROV_PO”
• Enter “Description” as “Item Gross Amount”
• Click on “Save” button

• Click on “New Entries” button
• Enter “Service Name” as “SEPMRA_PO_APV”
• Enter “Entity” as “PurchaseOrderItem”
• Enter “Property” as “GrossAmount”
• Enter “Logical Attribute” as “LA_APPROV_PO”
• Enter “Description” as “Item Gross Amount”
• Click on “Save” button

Conclusion

In this blog post, we have learnt how Role-based masking is achieved in Approve Purchase Orders application of SAPUI5 for masking “Supplier Name“, “Delivery Address“, “Price“, and “Gross Amount” fields.