Supplemental Lesson - Implement Dynamic Security by Using Row Filters
APPLIES TO:SQL Server Analysis Services (starting with 2016)Azure Analysis Services
In this supplemental lesson, you will create an additional role that implements dynamic security. Dynamic security provides row-level security based on the user name or login id of the user currently logged on. To learn more, see Roles.
To implement dynamic security, you must add a table to your model containing the Windows user names of those users that can create a connection to the model as a data source and browse model objects and data. The model you create using this tutorial is in the context of Adventure Works Corp.; however, in order to complete this lesson, you must add a table containing users from your own domain. You will not need the passwords for the user names that will be added. To create an EmployeeSecurity table, with a small sample of users from your own domain, you will use the Paste feature, pasting employee data from an Excel spreadsheet. In a real-world scenario, the table containing user names you add to a model would typically use a table from an actual database as a data source; for example, a real DimEmployee table.
In order to implement dynamic security, you will use two new DAX functions: USERNAME Function (DAX) and LOOKUPVALUE Function (DAX). These functions, applied in a row filter formula, are defined in a new role. Using the LOOKUPVALUE function, the formula specifies a value from the EmployeeSecurity table and then passes that value to the USERNAME function, which specifies the user name of the user logged on belongs to this role. The user can then browse only data specified by the role’s row filters. In this scenario, you will specify that sales employees can only browse Internet sales data for the sales territories in which they are a member.
In order to complete this supplemental lesson, you will complete a series of tasks. Those tasks that are unique to this Adventure Works tabular model scenario, but would not necessarily apply to a real-world scenario are identified as such. Each task includes additional information describing the purpose of the task.
Estimated time to complete this lesson: 30 minutes
This supplemental lesson topic is part of a tabular modeling tutorial, which should be completed in order. Before performing the tasks in this supplemental lesson, you should have completed all previous lessons.
Add the DimSalesTerritory table to the AW Internet Sales Tabular Model Project
In order to implement dynamic security for this Adventure Works scenario, you must add two additional tables to your model. The first table you will add is DimSalesTerritory (as Sales Territory) from the same AdventureWorksDW database. You will later apply a row filter to the SalesTerritory table that defines the particular data the logged on user can browse.
To add the DimSalesTerritory table
In SSDT, click the Model menu, and then click Existing Connections.
In the Existing Connections dialog box, verify the Adventure Works DB from SQL data source connection is selected, and then click Open.
If the Impersonation Credentials dialog box appears, type the impersonation credentials you used in Lesson 2: Add Data.
On the Choose How to Import the Data page, leave Select from a list of tables and views to choose the data to import selected, and then click Next.
On the Select Tables and Views page, select the DimSalesTerritory table.
Click Preview and Filter.
Deselect the SalesTerritoryAlternateKey column, and then click Ok.
On the Select Tables and Views page, click Finish.
The new table will be added to the model workspace. Objects and data from the source DimSalesTerritory table are then imported into your AW Internet Sales Tabular Model.
After the table has been imported, click Close.
Add a table with user name data
Because the DimEmployee table in the AdventureWorksDW sample database contains users from the AdventureWorks domain, and those user names do not exist in your own environment, you must create a table in your model that contains a small sample (three) of actual users from your organization. You will then add these users as members to the new role. You do not need the passwords for the sample user names, but you will need actual Windows user names from your own domain.
To add an EmployeeSecurity table
Open Microsoft Excel, creating a new worksheet.
Copy the following table, including the header row, and then paste it into the worksheet.
|EmployeeId|SalesTerritoryId|FirstName|LastName|LoginId| |---------------|----------------------|--------------|-------------|------------| |1|2|<user first name>|<user last name>|\<domain\username>| |1|3|<user first name>|<user last name>|\<domain\username>| |2|4|<user first name>|<user last name>|\<domain\username>| |3|5|<user first name>|<user last name>|\<domain\username>|
Replace the first name, last name, and domain\username with the names and login ids of three users in your organization. Put the same user on the first two rows, for EmployeeId 1. This will show this user belongs to more than one sales territory. Leave the EmployeeId and SalesTerritoryId fields as they are.
Save the worksheet as SampleEmployee.
In the worksheet, select all of the cells with employee data, including the headers, then right-click the selected data, and then click Copy.
In SSDT, click the Edit menu, and then click Paste.
If Paste is grayed out, click any column in any table in the model designer window, and try again.
In the Paste Preview dialog box, in Table Name, type EmployeeSecurity.
In Data to be pasted, verify the data includes all of the user data and headers from the SampleEmployee worksheet.
Verify Use first row as column headers is checked, and then click Ok.
A new table named EmployeeSecurity with employee data copied from the SampleEmployee worksheet is created.
Create relationships between FactInternetSales, DimGeography, and DimSalesTerritory table
The FactInternetSales, DimGeography, and DimSalesTerritory table all contain a common column, SalesTerritoryId. The SalesTerritoryId column in the DimSalesTerritory table contains values with a different Id for each sales territory.
To create relationships between the FactInternetSales, DimGeography, and the DimSalesTerritory table
In the model designer, in Diagram View, in the DimGeography table, click and hold on the SalesTerritoryId column, then drag the cursor to the SalesTerritoryId column in the DimSalesTerritory table, and then release.
In the FactInternetSales table, click and hold on the SalesTerritoryId column, then drag the cursor to the SalesTerritoryId column in the DimSalesTerritory table, and then release.
Notice the Active property for this relationship is False, meaning it's inactive. This is because the FactInternetSales table already has another active relationship that is used in measures.
Hide the EmployeeSecurity Table from client applications
In this task, you will hide the EmployeeSecurity table, keeping it from appearing in a client application’s field list. Keep in-mind that hiding a table does not secure it. Users can still query EmployeeSecurity table data if they know how. In order to secure the EmployeeSecurity table data, preventing users from being able to query any of its data, you will apply a filter in a later task.
To hide the EmployeeSecurity table from client applications
- In the model designer, in Diagram View, right-click the Employee table heading, and then click Hide from Client Tools.
Create a Sales Employees by Territory user role
In this task, you will create a new user role. This role will include a row filter defining which rows of the DimSalesTerritory table are visible to users. The filter is then applied in the one-to-many relationship direction to all other tables related to DimSalesTerritory. You will also apply a simple filter that secures the entire EmployeeSecurity table from being queryable by any user that is a member of the role.
The Sales Employees by Territory role you create in this lesson restricts members to browse (or query) only sales data for the sales territory to which they belong. If you add a user as a member to the Sales Employees by Territory role that also exists as a member in a role created in Lesson 11: Create Roles, you will get a combination of permissions. When a user is a member of multiple roles, the permissions, and row filters defined for each role are cumulative. That is, the user will have the greater permissions determined by the combination of roles.
To create a Sales Employees by Territory user role
In SSDT, click the Model menu, and then click Roles.
In Role Manager, click New.
A new role with the None permission is added to the list.
Click on the new role, and then in the Name column, rename the role to Sales Employees by Territory.
In the Permissions column, click the dropdown list, and then select the Read permission.
Click on the Members tab, and then click Add.
In the Select User or Group dialog box, in Enter the object named to select, type the first sample user name you used when creating the EmployeeSecurity table. Click Check Names to verify the user name is valid, and then click Ok.
Repeat this step, adding the other sample user names you used when creating the EmployeeSecurity table.
Click on the Row Filters tab.
For the EmployeeSecurity table, in the DAX Filter column, type the following formula.
This formula specifies that all columns resolve to the false Boolean condition; therefore, no columns for the EmployeeSecurity table can be queried by a member of the Sales Employees by Territory user role.
For the DimSalesTerritory table, type the following formula.
='Sales Territory'[Sales Territory Id]=LOOKUPVALUE('Employee Security'[Sales Territory Id], 'Employee Security'[Login Id], USERNAME(), 'Employee Security'[Sales Territory Id], 'Sales Territory'[Sales Territory Id])
In this formula, the LOOKUPVALUE function returns all values for the DimEmployeeSecurity[SalesTerritoryId] column, where the EmployeeSecurity[LoginId] is the same as the current logged on Windows user name, and EmployeeSecurity[SalesTerritoryId] is the same as the DimSalesTerritory[SalesTerritoryId].
The set of sales territory IDs returned by LOOKUPVALUE is then used to restrict the rows shown in the DimSalesTerritory table. Only rows where the SalesTerritoryID for the row is in the set of IDs returned by the LOOKUPVALUE function are displayed.
In Role Manager, click Ok.
Test the Sales Employees by Territory User Role
In this task, you will use the Analyze in Excel feature in SSDT to test the efficacy of the Sales Employees by Territory user role. You will specify one of the user names you added to the EmployeeSecurity table and as a member of the role. This user name will then be used as the effective user name in the connection created between Excel and the model.
To test the Sales Employees by Territory user role
In SSDT, click the Model menu, and then click Analyze in Excel.
In the Analyze in Excel dialog box, in Specify the user name or role to use to connect to the model, select Other Windows User, and then click Browse.
In the Select User or Group dialog box, in Enter the object name to select, type one of the user names you included in the EmployeeSecurity table, and then click Check Names.
Click Ok to close the Select User or Group dialog box, and then click Ok to close the Analyze in Excel dialog box.
Excel will open with a new workbook. A PivotTable is automatically created. The PivotTable Fields list includes most of the data fields available in your new model.
Notice the EmployeeSecurity table is not visible in the PivotTable Fields list. This is because you chose to hide this table from client tools in a previous task.
In the Fields list, in ∑ Internet Sales (measures), select the InternetTotalSales measure. The measure will be entered into the Values fields.
Select the SalesTerritoryId column from the DimSalesTerritory table. The column will be entered into the Row Labels fields.
Notice Internet sales figures appear only for the one region to which the effective user name you used belongs. If you select another column; for example, City, from the DimGeography table as Row Label field, only cities in the sales territory to which the effective user belongs are displayed.
This user cannot browse or query any Internet sales data for territories other than the one they belong because the row filter defined for the Sales Territory table in the Sales Employees by Territory user role effectively secures data for all data related to other sales territories.