Field level security to control access
Applies to Dynamics 365 for Customer Engagement apps version 9.x
Applies to Dynamics 365 for Customer Engagement apps version 9.x (on-premises)
Record-level permissions are granted at the entity level, but you may have certain fields associated with an entity that contain data that is more sensitive than the other fields. For these situations, you use field level security to control access to specific fields.
The scope of field level security is organization-wide and applies to all data access requests including the following:
Data access requests from within a client application, such as web browser, mobile client, or Microsoft Dynamics 365 for Outlook.
Web service calls using the Dynamics 365 Customer Engagement Web Services (for use in plug-ins, custom workflow activities, and custom code)
Reporting (using Filtered Views)
Overview of field level security
Field level security is available for the default fields on most out-of-box entities, custom fields, and custom fields on custom entities. Field level security is managed by the security profiles. To implement field level security, a system administrator performs the following tasks.
Enable field security on one or more fields for a given entity.
Associate one more existing security profiles, or create one or more new security profiles to grant the appropriate access to specific users or teams.
A security profile determines the following:
Permissions to the secure fields
Users and Teams
A security profile can be configured to grant user or team members the following permissions at the field level:
Read. Read-only access to the field’s data.
Create. Users or teams in this profile can add data to this field when creating a record.
Update. Users or teams in this profile can update the field’s data after it has been created.
A combination of these three permissions can be configured to determine the user privileges for a specific data field.
Unless one or more security profiles are assigned to a security enabled field, only Dynamics 365 for Customer Engagement apps users with the system administrator security role will have access to the field.
Example for restricting the mobile phone field for the Contact entity
Imagine your company’s policy is that sales members should have different levels of access to contact mobile phone numbers as described here.
|User or Team||Access|
|Vice presidents||Full. Can create, update, and view mobile phone numbers for contacts.|
|Sales Managers||Read-only. Can only view mobile phone numbers for contacts.|
|Salespersons and all other Dynamics 365 for Customer Engagement apps users||None. Cannot create, update or view mobile phone numbers for contacts.|
To restrict this field, you would perform the following tasks.
Secure the field.
Go to Settings > Customizations.
Click Customize the System.
Click Entities > Contact > Fields.
Click mobilephone, click Edit.
Next to Field Security, click Enable, click Save and Close.
Publish the customization.
Configure the security profiles.
Create the field security profile for sales managers.
Go to Settings > Security.
Click Field Security Profiles.
Click New, enter a name, such as Sales Manager access contact mobile phone, and click Save.
Click Users, click Add, select the users that you want to grant read access to the mobile phone number on the contact form, and then click Add.
Instead of adding each user, create one or more teams that include all users that you want to grant read access.
Click Field Permissions, click mobilephone, click Edit, select Yes next to Allow Read, and then click OK.
Create the field security profiles for vice presidents.
Click New, enter a name, such as VP access contact mobile phone, and click Save.
Click Users, click Add, select the users that you want to grant full access to the mobile phone number on the contact form, and then click Add.
Click Field Permissions, click mobilephone, click Edit, select Yes next to Allow Read, Allow Update, and Allow Create, and then click OK.
Click Save and Close.
Any Dynamics 365 for Customer Engagement apps users not defined in the previously created field security profiles will not have access to the mobile phone field on contact forms or views. The field value displays ********, indicating that the field is secured.
Which fields can be secured?
Every field in the system contains a setting for whether field security is allowed. You can view this in the Customizations area of the web application.
There are thousands of attributes that can be secured, so there are two easier ways to look for this information. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the Metadata for Your Organization. You can also view the metadata for an uncustomized organization in the Office Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK. Download the Microsoft Dynamics 365 for Customer Engagement apps SDK
Best practices when you use field security
When you use calculated fields that include a field that is secured, data may be displayed in the calculated field to users that don’t have permission to the secured field. In this situation, both the original field and the calculated field should be secured.
Some data, such as addresses, are actually made up of multiple fields. Therefore, to completely secure data that includes multiple fields, such as addresses, you must secure and configure the appropriate field security profiles on multiple fields for the entity. For example, to completely secure addresses for an entity, secure all relevant address fields, such as address_line1, address_line2, address_line3, address1_city, address1_composite, and so on.
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.