Protecting your DocuSign Agreements with Azure Sentinel

Published 01-25-2021 12:18 PM 3,737 Views
Microsoft

With the proliferation of cyberattacks continuing to grow every day, it’s essential to stay ahead of the challenges and mitigate risk. It is important for security teams to research trends to protect their environment from persistent and ever-growing threats, phishing campaigns, and other forms of cyberattacks.


DocuSign allows organizations to manage electronic agreements. As part of the DocuSign Agreement Cloud, DocuSign offers eSignature, a way to sign documents electronically on different devices. As your DocuSign use cases continue to grow, the DocuSign Monitor API can be a powerful tool to bolster your systems' integrity, reinforce company policies, and help assure your customers that their sensitive data is in good hands.


This blog will cover integrating Azure Sentinel with critical DocuSign to stay on top of signs of intrusion or suspicious activity. The steps below demonstrate the process of collecting DocuSign telemetry, using an Azure Function to pull DocuSign security events through the DocuSign Monitor API & DocuSign Account Users and ingesting them into an Azure Log Analytics workspace.

 

Deploying the DocuSign connector

This section explains how to use the ARM template to deploy the data connector to ingest DocuSign security events into Azure Log Analytics Workspace.

To access the ARM template, navigate to https://github.com/Azure/Azure-Sentinel/tree/master/DataConnectors/DocuSign-SecurityEvents

  1. Click the Deploy to Azure Button
  2. Enter values for the following parameters
    • "Function Name": Function App Name
    • "DocuSign Integration Key": DocuSign Integration Key
    • "DocuSign Admin User GUID": DocuSign Admin User GUID
    • "DocuSign Account API ID": "DocuSign Account API ID
    • "Workspace Id": Azure Log Analytics Workspace Id​
    • "Workspace Key": Azure Log Analytics Workspace Key

v2DocuSigngif.gif

Note: DocuSign Integration Key,  DocuSign Admin User GUID, DocuSign Account API ID and Workspace Key values will be placed as "Secrets" in the <<FunctionAppName>><<uniqueid>>kv Azure KeyVault

 

 

 

For complete instructions, please refer to README.md.

 

Security events that can be collected from DocuSign Monitor API

Once it has been deployed, the data connector will be able to collect the following events from your DocuSign organization, for example:

  • Account administrator added.
  • Account password rules updated.
  • Account user deleted.

Docusign_table.gif

The complete list of all events that can be collected from DocuSign can be found here.

 

Example analytics rules using DocuSign event data

Once DocuSign security events are ingested into your Azure Sentinel Workspace, you can create a custom analytics rule with a scheduled query to help you discover threats and anomalous behaviors that may be present in your organization.

Below are some examples of analytics rules you could run against your ingested DocuSign data:

 

Rule #1:

Description: User fails six or more login attempts in an hour.

 

DocuSignSecurityEvents_CL
| where TimeGenerated > ago(1h)
| where object_s == 'User'
| where action_s == 'Login'
| where field_s == 'Status'
| where result_s == 'Failed'
| summarize Attempts = count() by userId_s, accountId_g
| where Attempts >= 6

 

 

Rule #2:

Description: Admin initiates a bulk account export.

 

DocuSignSecurityEvents_CL
| where TimeGenerated > ago(1h)
| where object_s == 'Organization'
| where action_s == 'Initiated'
| where property_s == 'BulkAccountsExport'

 

 

Rule #3:

Description: When a bulk user settings export is initiated

 

DocuSignSecurityEvents_CL
| where TimeGenerated > ago(1h)
| where object_s == 'Organization'
| where action_s == 'Initiated'
| where property_s == 'BulkUsersExport'

 

 

Summary

This post outlines the key components necessary to ingest DocuSign security events to Azure Log Analytics using DocuSign Monitor API. The DocuSign security events data connector helps to protect your organization’s electronic agreements with round-the-clock activity tracking. It provides near real-time visibility across your DocuSign organization operations which helps security teams to detect potential threats, investigate incidents and respond decisively. Try it out, and let us know what you think!

 

We will continue developing and adding custom analytics rules and hunting queries for DocuSign security event data over time, so make sure you keep an eye on the Azure Sentinel GitHub repo.  As always, if you have your own ideas for queries or detections, please feel free to contribute to the Azure Sentinel community.

 

Thanks to @Sarah_Young@Cristhofer Munoz@Chi Nguyen, and @Ofer_Shezaf for their input into this blog post.

1 Comment

This is fantastic!

%3CLINGO-SUB%20id%3D%22lingo-sub-2085502%22%20slang%3D%22en-US%22%3EProtecting%20your%20DocuSign%20Agreements%20with%20Azure%20Sentinel%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-2085502%22%20slang%3D%22en-US%22%3E%3CP%3EWith%20the%20proliferation%20of%20cyberattacks%20continuing%20to%20grow%20every%20day%2C%20it%E2%80%99s%20essential%20to%20stay%20ahead%20of%20the%20challenges%20and%20mitigate%20risk.%20It%20is%20important%20for%20security%20teams%20to%20research%20trends%20to%20protect%20their%20environment%20from%20persistent%20and%20ever-growing%20threats%2C%20phishing%20campaigns%2C%20and%20other%20forms%20of%20cyberattacks.%3C%2FP%3E%0A%3CP%3E%3CBR%20%2F%3EDocuSign%20allows%20organizations%20to%20manage%20electronic%20agreements.%20As%20part%20of%20the%20DocuSign%20Agreement%20Cloud%2C%20DocuSign%20offers%20eSignature%2C%20a%20way%20to%20sign%20documents%20electronically%20on%20different%20devices.%20As%20your%20DocuSign%20use%20cases%20continue%20to%20grow%2C%20the%20DocuSign%20Monitor%20API%20can%20be%20a%20powerful%20tool%20to%20bolster%20your%20systems'%20integrity%2C%20reinforce%20company%20policies%2C%20and%20help%20assure%20your%20customers%20that%20their%20sensitive%20data%20is%20in%20good%20hands.%3C%2FP%3E%0A%3CP%3E%3CBR%20%2F%3EThis%20blog%20will%20cover%20integrating%20Azure%20Sentinel%20with%20critical%20DocuSign%20to%20stay%20on%20top%20of%20signs%20of%20intrusion%20or%20suspicious%20activity.%20The%20steps%20below%20demonstrate%20the%20process%20of%20collecting%20DocuSign%20telemetry%2C%20using%20an%20Azure%20Function%20to%20pull%20DocuSign%20security%20events%20through%20the%20DocuSign%20Monitor%20API%20%26amp%3B%20DocuSign%20Account%20Users%20and%20ingesting%20them%20into%20an%20Azure%20Log%20Analytics%20workspace.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%225%22%3E%3CU%3EDeploying%20the%20DocuSign%20connector%3C%2FU%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3EThis%20section%20explains%20how%20to%20use%20the%20ARM%20template%20to%20deploy%20the%20data%20connector%20to%20ingest%26nbsp%3BDocuSign%20security%20events%20into%26nbsp%3BAzure%20Log%20Analytics%20Workspace.%3C%2FP%3E%0A%3CP%3ETo%20access%20the%20ARM%20template%2C%20navigate%20to%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2FAzure%2FAzure-Sentinel%2Ftree%2Fmaster%2FDataConnectors%2FDocuSign-SecurityEvents%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Ehttps%3A%2F%2Fgithub.com%2FAzure%2FAzure-Sentinel%2Ftree%2Fmaster%2FDataConnectors%2FDocuSign-SecurityEvents%3C%2FA%3E%3C%2FP%3E%0A%3COL%3E%0A%3CLI%3EClick%20the%26nbsp%3B%3CSTRONG%3EDeploy%20to%20Azure%3C%2FSTRONG%3E%26nbsp%3BButton%3C%2FLI%3E%0A%3CLI%3EEnter%20values%20for%20the%20following%20parameters%3C%2FLI%3E%0A%3C%2FOL%3E%0A%3COL%3E%0A%3CUL%3E%0A%3CLI%3E%22Function%20Name%22%3A%20Function%20App%20Name%3C%2FLI%3E%0A%3CLI%3E%22DocuSign%20Integration%20Key%22%3A%20DocuSign%20Integration%20Key%3C%2FLI%3E%0A%3CLI%3E%22DocuSign%20Admin%20User%20GUID%22%3A%26nbsp%3BDocuSign%20Admin%20User%20GUID%3C%2FLI%3E%0A%3CLI%3E%22DocuSign%20Account%20API%20ID%22%3A%20%22DocuSign%20Account%20API%20ID%3C%2FLI%3E%0A%3CLI%3E%22Workspace%20Id%22%3A%20Azure%20Log%20Analytics%20Workspace%20Id%3C%2FLI%3E%0A%3CLI%3E%22Workspace%20Key%22%3A%20Azure%20Log%20Analytics%20Workspace%20Key%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3C%2FOL%3E%0A%3CP%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20image-alt%3D%22v2DocuSigngif.gif%22%20style%3D%22width%3A%20999px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F258223i215E7ADE557F167F%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20role%3D%22button%22%20title%3D%22v2DocuSigngif.gif%22%20alt%3D%22v2DocuSigngif.gif%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3ENote%3A%20DocuSign%20Integration%20Key%2C%26nbsp%3B%20DocuSign%20Admin%20User%20GUID%2C%20DocuSign%20Account%20API%20ID%20and%20Workspace%20Key%20values%20will%20be%20placed%20as%20%22Secrets%22%20in%20the%20%3CSPAN%3E%26lt%3B%3CFUNCTIONAPPNAME%3E%26gt%3B%26lt%3B%3CUNIQUEID%3E%26gt%3Bkv%3C%2FUNIQUEID%3E%3C%2FFUNCTIONAPPNAME%3E%3C%2FSPAN%3E%26nbsp%3BAzure%20KeyVault%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EFor%20complete%20instructions%2C%20please%20refer%20to%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2FAzure%2FAzure-Sentinel%2Fblob%2Fmaster%2FDataConnectors%2FDocuSign-SecurityEvents%2FREADME.md%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EREADME.md%3C%2FA%3E.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%225%22%3E%3CU%3ESecurity%20events%20that%20can%20be%20collected%20from%20DocuSign%20Monitor%20API%3C%2FU%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3EOnce%20it%20has%20been%20deployed%2C%20the%20data%20connector%20will%20be%20able%20to%20collect%20the%20following%20events%20from%20your%20DocuSign%20organization%2C%20for%20example%3A%3C%2FP%3E%0A%3CUL%3E%0A%3CLI%3EAccount%20administrator%20added.%3C%2FLI%3E%0A%3CLI%3EAccount%20password%20rules%20updated.%3C%2FLI%3E%0A%3CLI%3EAccount%20user%20deleted.%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CP%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20image-alt%3D%22Docusign_table.gif%22%20style%3D%22width%3A%20999px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F248458i6C405B05F527B1DA%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20role%3D%22button%22%20title%3D%22Docusign_table.gif%22%20alt%3D%22Docusign_table.gif%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3EThe%20complete%20list%20of%20all%20events%20that%20can%20be%20collected%20from%20DocuSign%20can%20be%20found%20%3CA%20href%3D%22https%3A%2F%2Fdevelopers.docusign.com%2Fdocs%2Fmonitor-api%2Fmonitor101%2Fevents-alerts%2Fevents-list%2F%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noreferrer%22%3Ehere.%3C%2FA%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%225%22%3E%3CU%3EExample%20analytics%20rules%20using%20DocuSign%20event%20data%3C%2FU%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3EOnce%20DocuSign%20security%20events%20are%20ingested%20into%20your%20Azure%20Sentinel%20Workspace%2C%20you%20can%20create%20a%20custom%20analytics%20rule%20with%20a%20scheduled%20query%20to%20help%20you%20discover%20threats%20and%20anomalous%20behaviors%20that%20may%20be%20present%20in%20your%20organization.%3C%2FP%3E%0A%3CP%3EBelow%20are%20some%20examples%20of%20analytics%20rules%20you%20could%20run%20against%20your%20ingested%20DocuSign%20data%3A%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CU%3ERule%20%231%3A%3C%2FU%3E%3C%2FP%3E%0A%3CP%3EDescription%3A%20User%20fails%20six%20or%20more%20login%20attempts%20in%20an%20hour.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CPRE%20class%3D%22lia-code-sample%20language-applescript%22%3E%3CCODE%3EDocuSignSecurityEvents_CL%0A%7C%26nbsp%3Bwhere%26nbsp%3BTimeGenerated%26nbsp%3B%26gt%3B%26nbsp%3Bago(1h)%0A%7C%26nbsp%3Bwhere%26nbsp%3Bobject_s%26nbsp%3B%3D%3D%26nbsp%3B'User'%0A%7C%26nbsp%3Bwhere%26nbsp%3Baction_s%26nbsp%3B%3D%3D%26nbsp%3B'Login'%0A%7C%26nbsp%3Bwhere%26nbsp%3Bfield_s%26nbsp%3B%3D%3D%26nbsp%3B'Status'%0A%7C%26nbsp%3Bwhere%26nbsp%3Bresult_s%26nbsp%3B%3D%3D%26nbsp%3B'Failed'%0A%7C%26nbsp%3Bsummarize%26nbsp%3BAttempts%26nbsp%3B%3D%26nbsp%3Bcount()%26nbsp%3Bby%26nbsp%3BuserId_s%2C%26nbsp%3BaccountId_g%0A%7C%26nbsp%3Bwhere%26nbsp%3BAttempts%26nbsp%3B%26gt%3B%3D%26nbsp%3B6%0A%0A%3C%2FCODE%3E%3C%2FPRE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CU%3ERule%20%232%3A%3C%2FU%3E%3C%2FP%3E%0A%3CP%3EDescription%3A%20Admin%20initiates%20a%20bulk%20account%20export.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CPRE%20class%3D%22lia-code-sample%20language-applescript%22%3E%3CCODE%3EDocuSignSecurityEvents_CL%0A%7C%26nbsp%3Bwhere%26nbsp%3BTimeGenerated%26nbsp%3B%26gt%3B%26nbsp%3Bago(1h)%0A%7C%26nbsp%3Bwhere%26nbsp%3Bobject_s%26nbsp%3B%3D%3D%26nbsp%3B'Organization'%0A%7C%26nbsp%3Bwhere%26nbsp%3Baction_s%26nbsp%3B%3D%3D%26nbsp%3B'Initiated'%0A%7C%26nbsp%3Bwhere%26nbsp%3Bproperty_s%26nbsp%3B%3D%3D%26nbsp%3B'BulkAccountsExport'%3C%2FCODE%3E%3C%2FPRE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CU%3ERule%20%233%3A%3C%2FU%3E%3C%2FP%3E%0A%3CP%3EDescription%3A%20When%20a%20bulk%20user%20settings%20export%20is%20initiated%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CPRE%20class%3D%22lia-code-sample%20language-applescript%22%3E%3CCODE%3EDocuSignSecurityEvents_CL%0A%7C%26nbsp%3Bwhere%26nbsp%3BTimeGenerated%26nbsp%3B%26gt%3B%26nbsp%3Bago(1h)%0A%7C%26nbsp%3Bwhere%26nbsp%3Bobject_s%26nbsp%3B%3D%3D%26nbsp%3B'Organization'%0A%7C%26nbsp%3Bwhere%26nbsp%3Baction_s%26nbsp%3B%3D%3D%26nbsp%3B'Initiated'%0A%7C%26nbsp%3Bwhere%26nbsp%3Bproperty_s%26nbsp%3B%3D%3D%26nbsp%3B'BulkUsersExport'%3C%2FCODE%3E%3C%2FPRE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%225%22%3E%3CU%3ESummary%3C%2FU%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3EThis%20post%20outlines%20the%20key%20components%20necessary%20to%20ingest%20DocuSign%20security%20events%20to%20Azure%20Log%20Analytics%20using%20DocuSign%20Monitor%20API.%20The%20DocuSign%20security%20events%20data%20connector%20helps%20to%20protect%20your%20organization%E2%80%99s%20electronic%20agreements%20with%20round-the-clock%20activity%20tracking.%20It%20provides%20near%20real-time%20visibility%20across%20your%20DocuSign%20organization%20operations%20which%20helps%20security%20teams%20to%20detect%20potential%20threats%2C%20investigate%20incidents%20and%20respond%20decisively.%20Try%20it%20out%2C%20and%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fazure-sentinel%2Fbd-p%2FAzureSentinel%22%20target%3D%22_blank%22%3E%26nbsp%3Blet%20us%20know%3C%2FA%3E%26nbsp%3Bwhat%20you%20think!%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EWe%20will%20continue%20developing%20and%20adding%20custom%20analytics%20rules%20and%20hunting%20queries%20for%26nbsp%3BDocuSign%20security%20event%20data%26nbsp%3Bover%20time%2C%20so%20make%20sure%20you%20keep%20an%20eye%20on%20the%20Azure%20Sentinel%20GitHub%20repo.%26nbsp%3B%20As%20always%2C%20if%20you%26nbsp%3Bhave%26nbsp%3Byour%20own%20ideas%20for%20queries%26nbsp%3Bor%20detections%2C%20please%20feel%20free%20to%20contribute%20to%20the%26nbsp%3B%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2FAzure%2FAzure-Sentinel%2Fwiki%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EAzure%20Sentinel%20community.%3C%2FA%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CEM%3EThanks%20to%26nbsp%3B%3CSPAN%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F538161%22%20target%3D%22_blank%22%3E%40Sarah_Young%3C%2FA%3E%3C%2FSPAN%3E%2C%26nbsp%3B%3CSPAN%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F87823%22%20target%3D%22_blank%22%3E%40Cristhofer%20Munoz%3C%2FA%3E%2C%26nbsp%3B%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F232659%22%20target%3D%22_blank%22%3E%40Chi%20Nguyen%3C%2FA%3E%2C%26nbsp%3Band%26nbsp%3B%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F293879%22%20target%3D%22_blank%22%3E%40Ofer_Shezaf%3C%2FA%3E%26nbsp%3B%3C%2FSPAN%3Efor%20their%20input%20into%20this%20blog%20post.%3C%2FEM%3E%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-2085502%22%20slang%3D%22en-US%22%3E%3CP%3E%3CSPAN%3EBring%20DocuSign%20security%20events%20using%20Azure%20Sentinel%20custom%20data%20connector.%3C%2FSPAN%3E%3C%2FP%3E%3C%2FLINGO-TEASER%3E
Co-Authors
Version history
Last update:
‎Feb 28 2021 12:43 AM
Updated by: