Export (0) Print
Expand All

Audit user access

Applies To: CRM 2015 on-prem, CRM Online

Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online 2015 Update support the ability to audit user access. The information that is recorded includes when the user started accessing Microsoft Dynamics CRM and if access originated from the Microsoft Dynamics CRM web application, CRM for Outlook, or SDK calls to the web services.

Auditing of user access is enabled at the organization level. To enable or disable user access auditing, you must retrieve the target organization’s record, and update the Organization.IsUserAccessAuditEnabled attribute value for the organization. Global auditing on the organization must also be enabled by setting the Organization.IsAuditEnabled attribute to true in the organization record. To audit the origin of user access, for example: web application, CRM for Outlook or SDK, you must enable auditing on the entities being accessed.

The frequency of auditing user access can be read or set using the Organization.UserAccessAuditingInterval attribute. The default attribute value of 4 indicates user access is audited once every 4 hours.

For more information about enabling auditing for an organization and entity, see Configure entities and attributes for auditing.

To search for audit records that are related to user access, your code should retrieve Audit records of an organization and filter on the value in Audit.Action. An enumeration named AuditAction is provided to identify supported audit actions. The actions related to user access are shown in the following list.

  • AuditAction.UserAccessviaWeb

  • AuditAction.UserAccessviaWebServices

  • AuditAction.UserAccessAuditStarted

  • AuditAction.UserAccessAuditStopped

UserAccessviaWeb indicates access from the Microsoft Dynamics CRM web application or Microsoft Outlook. UserAccessviaWebServices indicates a web service request from the SDK. The AuditAction enumeration is available to your code when you include SampleCode\CS\HelperCode\OptionSets.cs or SampleCode\VB\HelperCode\OptionSets.vb in your application’s project.

See Also

Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.
© 2015 Microsoft