Home
%3CLINGO-SUB%20id%3D%22lingo-sub-767727%22%20slang%3D%22en-US%22%3ESending%20Proofpoint%20TAP%20logs%20to%20Azure%20Sentinel%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-767727%22%20slang%3D%22en-US%22%3E%3CP%3EMore%20than%2090%25%20of%20targeted%20attacks%20start%20with%20email%E2%80%94and%20these%20threats%20are%20always%20evolving.%20Proofpoint%20Targeted%20Attack%20Protection%20(TAP)%20helps%20you%20stay%20ahead%20of%20attackers%20with%20an%20innovative%20approach%20that%20detects%2C%20analyzes%20and%20blocks%20advanced%20threats%20before%20they%20reach%20your%20inbox.%20This%20includes%20ransomware%20and%20other%20advanced%20email%20threats%20delivered%20through%20malicious%20attachments%20and%20URLs.%20And%20zero-day%20threats%2C%20polymorphic%20malware%2C%20weaponized%20documents%20and%20phishing%20attacks.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EAzure%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3ESentinel%20provides%20a%20practical%20way%20for%20you%20to%20connect%20your%20data%20sources.%20Azure%20Sentinel%20comes%20with%20several%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fazure%2Fsentinel%2Fconnect-data-sources%23data-connection-methods%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3Econnectors%3C%2FA%3Efor%20Microsoft%20solutions%20available%20out%20of%20the%20box.%20There%20are%20three%20major%20ways%20to%20ingest%20data%20into%20Azure%20Sentinel%3A%3C%2FP%3E%0A%3CUL%3E%0A%3CLI%3EMicrosoft%20sources%3C%2FLI%3E%0A%3CLI%3E3%3CSUP%3Erd%3C%2FSUP%3Eparty%20sources%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3C%2FLI%3E%0A%3CLI%3ECustom%20logs%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CP%3EMany%20%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3Esecurity%20technologies%20provide%20a%20set%20of%20APIs%20through%20which%20events%20can%20be%20retrieved.%20The%20below%20figure%20is%20a%20high-level%20architecture%20on%20how%20to%20ingest%20data%20from%20any%20set%20of%20APIs%20to%20Azure%20Sentinel.%20APIs%20can%20be%20consumed%20by%20a%20custom%20logic%20app%20connector%3B%20it%20supports%20both%20a%20push%20and%20pull%20implementation%20which%20is%20made%20available%20in%20Azure%20Log%20Analytics.%20Azure%20Sentinel%20is%20built%20on%20top%20of%20Azure%20Log%20Analytics%20making%20data%20imported%20to%20Azure%20Log%20Analytics%20available%20to%20Azure%20Sentinel%3CSPAN%3E.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20683px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124011i7D174F46C5B26E8A%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22AzureSentinel_CustomLogicApp.PNG%22%20title%3D%22AzureSentinel_CustomLogicApp.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%223%22%3E%3CEM%3EFigure%201%3A%26nbsp%3B%20High%20Level%20Process%20to%20ingest%20data%20into%20Azure%20Sentinel%20via%20custom%20API%20connector%3C%2FEM%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EIn%20a%20previous%20%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2FSecurity-Identity%2FSending-REST-API-data-to-Azure-Sentinel%2Ftd-p%2F558896%22%20target%3D%22_blank%22%20rel%3D%22noopener%22%3Eblogpost%3C%2FA%3Ewe%E2%80%99ve%20demonstrated%20how%20to%20send%20REST%20API%20data%20to%20Azure%20Sentinel.%20In%20this%20article%20we%20will%20walk%20through%20the%20process%20of%20how%20to%20ingest%20%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3Elogs%20using%20a%20custom%20Logic%20Apps%20workflow%20to%20retrieve%20REST%20API%20data.%20However%2C%20this%20article%20can%20be%20utilized%20as%20a%20step%20by%20step%20guide%20to%20ingest%20logs%20from%20any%20data%20source%20that%20provides%20a%20set%20of%20APIs.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EPlease%20reference%20%3CA%20href%3D%22https%3A%2F%2Fhelp.proofpoint.com%2FThreat_Insight_Dashboard%2FAPI_Documentation%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3EProofpoint%E2%80%99s%20API%20Documentation%3C%2FA%3Ewhich%20detail%20the%20various%20API%20endpoints%20made%20available%20which%20can%20be%20leveraged.%3C%2FP%3E%0A%3CH1%20style%3D%22box-sizing%3A%20border-box%3B%20color%3A%20inherit%3B%20font-family%3A%20inherit%3B%20font-size%3A%2030px%3B%20font-style%3A%20normal%3B%20font-variant%3A%20normal%3B%20font-weight%3A%20normal%3B%20letter-spacing%3A%20normal%3B%20line-height%3A%201.2%3B%20orphans%3A%202%3B%20text-align%3A%20left%3B%20text-decoration%3A%20none%3B%20text-indent%3A%200px%3B%20text-transform%3A%20none%3B%20-webkit-text-stroke-width%3A%200px%3B%20white-space%3A%20normal%3B%20word-spacing%3A%200px%3B%20margin%3A%2024px%200px%2012px%200px%3B%22%20id%3D%22toc-hId-1989996897%22%20id%3D%22toc-hId-1989996897%22%3EStep%201%3A%20Retrieve%20REST%20API%20data%3C%2FH1%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EThe%20first%20step%20is%20to%20retrieve%20REST%20API%20data%20from%20Proofpoint%E2%80%99s%20TAP%20service.%20Currently%2C%20the%20following%20event%20types%20are%20exposed%3A%3C%2FP%3E%0A%3CUL%3E%0A%3CLI%3EBlocked%20or%20permitted%20clicks%20to%26nbsp%3Bthreats%20recognized%20by%20URL%20Defense%3C%2FLI%3E%0A%3CLI%3EBlocked%20or%20delivered%20messages%20that%20contain%20threats%20recognized%20by%20URL%20Defense%20or%20Attachment%20Defense%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CH1%20id%3D%22toc-hId--562160064%22%20id%3D%22toc-hId--562160064%22%3EStep%202%3A%20Build%20a%20Custom%20Logic%20App%20Data%20Collector%3C%2FH1%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EOnce%20you%20have%20the%20logic%20apps%20designer%20opened%2C%20the%20first%20step%20is%20to%20add%20a%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fazure%2Fconnectors%2Fconnectors-native-recurrence%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3Erecurrence%3C%2FA%3Etrigger%2C%20in%20my%20case%20I%20will%20run%20my%20logic%20app%20every%20hour%3CSPAN%3E.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20640px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124012i6C89045C9B8DDF5D%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22Recurrence.PNG%22%20title%3D%22Recurrence.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%223%22%3E%3CEM%3ENote%3A%20The%20recurrence%20you%20specify%20must%20be%20coded%20in%20the%20SinceSeconds%20parameter%20of%20the%20Get%20request%3C%2FEM%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ENext%2C%20we%20will%20add%20a%20new%20step%20and%20select%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fazure%2Fconnectors%2Fconnectors-native-http%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3EHTTP%3C%2FA%3Eblock.%20In%20the%20method%20field%2C%20select%20GET%20to%20request%20data%20from%20Proofpoint.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20641px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124014iC6E5D29397C8DD5C%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22HTTP.PNG%22%20title%3D%22HTTP.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%223%22%3E%3CEM%3ENotes%3A%20Proofpoint%20requires%20Basic%20Authentication%20with%20an%20API%20key.%20%3C%2FEM%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%223%22%3E%3CEM%3EBy%20specifying%20%E2%80%9CBlocked%E2%80%9D%20you%20will%20fetch%20events%20for%20clicks%20to%20malicious%20URL%E2%80%99s%20blocked%20in%20the%20specified%20time%20period.%20You%20can%20fetch%20other%20events%20by%20leveraging%20additional%20endpoints%20available%20on%20the%20%3C%2FEM%3E%3CA%20href%3D%22https%3A%2F%2Fhelp.proofpoint.com%2FThreat_Insight_Dashboard%2FAPI_Documentation%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3E%3CEM%3EProofpoint%20TAP%20API%20Documentation.%3C%2FEM%3E%3C%2FA%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ETo%20send%20the%20data%20to%20the%20Azure%20Sentinel%20workspace%20we%20first%20need%20to%20parse%20the%20data.%20To%20achieve%20this%2C%20we%20leverage%20a%26nbsp%3B%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fazure%2Flogic-apps%2Flogic-apps-perform-data-operations%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3EParse%20JSON%26nbsp%3B%3C%2FA%3Ebuilding%20block%3A%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%3E%26nbsp%3B%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20595px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124015i67ED0B7AA585462D%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22Parse_JSON.PNG%22%20title%3D%22Parse_JSON.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CEM%3ENotes%3A%3C%2FEM%3E%3C%2FP%3E%0A%3CP%3E%3CEM%3EA%20query%20may%20return%20results%20that%20are%20null%20or%20be%20interpreted%20as%20a%20number%20instead%20of%20an%20integer.%20Adjusting%20the%20auto-generated%20schema%20to%20include%20all%20the%20possible%20types%20a%20query%20could%20return%20for%20that%20field%20is%20safer%20and%20will%20avoid%20JSON%20parse%20errors.%26nbsp%3B%3C%2FEM%3E%3C%2FP%3E%0A%3CP%3E%3CEM%3E%26nbsp%3B%3C%2FEM%3E%3C%2FP%3E%0A%3CP%3E%3CEM%3EIf%20you%20select%20a%20different%20end%20point%2C%20you%20will%20need%20also%20to%20change%20the%20element%20from%20the%20JSON%20you%20pick%20for%20pushing%20to%20Azure%20Log%20Analytics%3C%2FEM%3E%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3CEM%3E.%20%3C%2FEM%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EAt%20this%20point%2C%20we%20are%20ready%20to%20send%20the%20logs%20to%20the%20Azure%20Sentinel%20workspace.%20To%20send%20the%20data%2C%20we%20will%20add%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fconnectors%2Fazureloganalyticsdatacollector%2F%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noopener%20noreferrer%20noopener%20noreferrer%22%3E%3CSTRONG%3EAzure%20Log%20Analytics%20Data%20Collector%3C%2FSTRONG%3E%3C%2FA%3Ebuilding%20block%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E.%20Below%20you%20will%20specify%20the%20connection%20name%2C%20Workspace%20ID%2C%20and%20Workspace%20key%20associated%20to%20the%20desired%20workspace%20you%20wish%20to%20send%20data%20to.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20643px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124016i60EF62B63E21EEC6%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22Log_Analytics_Data_Collector.PNG%22%20title%3D%22Log_Analytics_Data_Collector.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3EOnce%20you%20specify%20those%20details%2C%20we%20will%20leverage%20the%20%E2%80%9CParse%20JSON%E2%80%9D%20output%20as%20the%20input%20and%20will%20specify%20a%20Custom%20Log%20Name%20i.e.%20Proofpoint%20Data%20as%20shown%20below%3A%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20550px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124017i241576CB0CFCD3B8%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22CustomLog.PNG%22%20title%3D%22CustomLog.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CH1%20id%3D%22toc-hId-1180650271%22%20id%3D%22toc-hId-1180650271%22%3EStep%203%3A%20See%20the%20data%20in%20Log%20Analytics%2FAzure%20Sentinel%3C%2FH1%3E%0A%3CP%3E%3CEM%3E%26nbsp%3B%3C%2FEM%3E%3C%2FP%3E%0A%3CP%3EAzure%20Sentinel%20is%20built%20on%20top%20of%20Log%20Analytics%3B%20hence%2C%20the%20data%20is%20available%20in%20both%20portals%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E(Log%20Analytics%20workspace%20blade%20%26amp%3B%20Azure%20Sentinel).%20After%20the%20logic%20app%20runs%2C%20the%20data%20can%20be%20found%20in%20the%20Azure%20Sentinel%20workspace%20under%20the%20%3CEM%3ECustom%20Logs%20%3C%2FEM%3Eschema.%3C%2FP%3E%0A%3CP%3ETo%20get%20to%20the%20custom%20log%20data%2C%20we%20first%20need%20to%20click%20on%20the%20%3CEM%3ELogs%20%3C%2FEM%3Etab%20under%20General%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%20style%3D%22text-align%3A%20center%3B%22%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20style%3D%22width%3A%20496px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124018i610AA67B05427D30%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22See_The_Data.PNG%22%20title%3D%22See_The_Data.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CEM%3ENote%3A%20%3C%2FEM%3E%3CEM%3ECustom%20Log%20View%20of%20ProofPointData_CL%20(%E2%80%9C_CL%E2%80%9D%20%3C%2FEM%3E%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3CEM%3Eis%20added%20to%20the%20name%20provided%20in%20the%20above%20%E2%80%9CSend%20Data%E2%80%9D%20block)%20We%20will%20append%20%E2%80%9C_CL%E2%80%9D%20for%20any%20custom%20logs%20ingested.%3C%2FEM%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ENow%20that%20we%20can%20see%20the%20data%20in%20Azure%20Sentinel%2C%20we%20now%20can%20build%20analytic%20rules%2C%20hunting%20queries%2C%20or%20associate%20it%20with%20any%20other%20data%20for%20correlation.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSPAN%3EIn%20the%20sample%20hunting%20query%20below%2C%20we%20are%20looking%20for%20the%20Top%2010%20Phishing%20sources%3A%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3EProofPointData_CL%20%7C%20where%20phishScore_d%20%26gt%3B%2080%20%7C%20summarize%20cnt%3Dcount%20()%20by%20fromAddress_s%20%7C%20top%2010%20by%20cnt%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-center%22%20style%3D%22width%3A%20875px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Fgxcuf89792.i.lithium.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F124022i7DBD83D88A9B5347%2Fimage-size%2Flarge%3Fv%3D1.0%26amp%3Bpx%3D999%22%20alt%3D%22huntin2.PNG%22%20title%3D%22huntin2.PNG%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CH1%20id%3D%22toc-hId--1371506690%22%20id%3D%22toc-hId--1371506690%22%3EWrapping%20up%3C%2FH1%3E%0A%3CP%3EIn%20this%20blogpost%20I%E2%80%99ve%20shown%20you%20how%20seamless%20it%20is%20to%20retrieve%20Proofpoint%20TAP%20REST%20API%20by%20leveraging%20a%20custom%20logic%20app.%20This%20exact%20same%20process%20can%20be%20leveraged%20for%20other%20vendors%20who%20provide%20APIs%20to%20their%20data%20sources%20for%20easy%20integration%20into%20Azure%20Log%20Analytics%2F%20Azure%20Sentinel.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3EReviewers%3A%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20style%3D%22background-color%3A%20%23ffffff%3B%22%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F94531%22%20target%3D%22_blank%22%3E%40Andrew%20Harris%20(AZURE%20SEC)%3C%2FA%3E%26nbsp%3B%3CBR%20%2F%3E%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20style%3D%22background-color%3A%20%23ffffff%3B%22%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F2864%22%20target%3D%22_blank%22%3E%40Nicholas%20DiCola%20(SECURITY%20JEDI)%3C%2FA%3E%26nbsp%3B%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20style%3D%22background-color%3A%20%23ffffff%3B%22%3E%40Ofer%20Shezaf%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20style%3D%22background-color%3A%20%23ffffff%3B%22%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F214230%22%20target%3D%22_blank%22%3E%40Tiander%20Turpijn%3C%2FA%3E%26nbsp%3B%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20style%3D%22background-color%3A%20%23ffffff%3B%22%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F124214%22%20target%3D%22_blank%22%3E%40Yuri%20Diogenes%3C%2FA%3E%26nbsp%3B%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-LABS%20id%3D%22lingo-labs-767727%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3EConnectors%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E

More than 90% of targeted attacks start with email—and these threats are always evolving. Proofpoint Targeted Attack Protection (TAP) helps you stay ahead of attackers with an innovative approach that detects, analyzes and blocks advanced threats before they reach your inbox. This includes ransomware and other advanced email threats delivered through malicious attachments and URLs. And zero-day threats, polymorphic malware, weaponized documents and phishing attacks.

 

Azure  Sentinel provides a practical way for you to connect your data sources. Azure Sentinel comes with several connectors for Microsoft solutions available out of the box. There are three major ways to ingest data into Azure Sentinel:

  • Microsoft sources
  • 3rd party sources 
  • Custom logs

Many  security technologies provide a set of APIs through which events can be retrieved. The below figure is a high-level architecture on how to ingest data from any set of APIs to Azure Sentinel. APIs can be consumed by a custom logic app connector; it supports both a push and pull implementation which is made available in Azure Log Analytics. Azure Sentinel is built on top of Azure Log Analytics making data imported to Azure Log Analytics available to Azure Sentinel.

 

AzureSentinel_CustomLogicApp.PNG

Figure 1:  High Level Process to ingest data into Azure Sentinel via custom API connector

 

In a previous blogpost we’ve demonstrated how to send REST API data to Azure Sentinel. In this article we will walk through the process of how to ingest  logs using a custom Logic Apps workflow to retrieve REST API data. However, this article can be utilized as a step by step guide to ingest logs from any data source that provides a set of APIs.

 

Please reference Proofpoint’s API Documentation which detail the various API endpoints made available which can be leveraged.

Step 1: Retrieve REST API data

 

The first step is to retrieve REST API data from Proofpoint’s TAP service. Currently, the following event types are exposed:

  • Blocked or permitted clicks to threats recognized by URL Defense
  • Blocked or delivered messages that contain threats recognized by URL Defense or Attachment Defense

Step 2: Build a Custom Logic App Data Collector

 

Once you have the logic apps designer opened, the first step is to add a recurrence trigger, in my case I will run my logic app every hour.

 

Recurrence.PNG

Note: The recurrence you specify must be coded in the SinceSeconds parameter of the Get request

 

Next, we will add a new step and select the HTTP block. In the method field, select GET to request data from Proofpoint.

 

HTTP.PNG

 

Notes: Proofpoint requires Basic Authentication with an API key.

By specifying “Blocked” you will fetch events for clicks to malicious URL’s blocked in the specified time period. You can fetch other events by leveraging additional endpoints available on the Proofpoint TAP API Documentation.

 

To send the data to the Azure Sentinel workspace we first need to parse the data. To achieve this, we leverage a Parse JSON building block:

 

 Parse_JSON.PNG

Notes:

A query may return results that are null or be interpreted as a number instead of an integer. Adjusting the auto-generated schema to include all the possible types a query could return for that field is safer and will avoid JSON parse errors. 

 

If you select a different end point, you will need also to change the element from the JSON you pick for pushing to Azure Log Analytics .

 

At this point, we are ready to send the logs to the Azure Sentinel workspace. To send the data, we will add the Azure Log Analytics Data Collector building block . Below you will specify the connection name, Workspace ID, and Workspace key associated to the desired workspace you wish to send data to.

 

Log_Analytics_Data_Collector.PNG

Once you specify those details, we will leverage the “Parse JSON” output as the input and will specify a Custom Log Name i.e. Proofpoint Data as shown below:

 

CustomLog.PNG

Step 3: See the data in Log Analytics/Azure Sentinel

 

Azure Sentinel is built on top of Log Analytics; hence, the data is available in both portals  (Log Analytics workspace blade & Azure Sentinel). After the logic app runs, the data can be found in the Azure Sentinel workspace under the Custom Logs schema.

To get to the custom log data, we first need to click on the Logs tab under General

 

See_The_Data.PNG

 

Note: Custom Log View of ProofPointData_CL (“_CL”  is added to the name provided in the above “Send Data” block) We will append “_CL” for any custom logs ingested.

 

Now that we can see the data in Azure Sentinel, we now can build analytic rules, hunting queries, or associate it with any other data for correlation.

 

In the sample hunting query below, we are looking for the Top 10 Phishing sources:

ProofPointData_CL | where phishScore_d > 80 | summarize cnt=count () by fromAddress_s | top 10 by cnt

 

 

huntin2.PNG

Wrapping up

In this blogpost I’ve shown you how seamless it is to retrieve Proofpoint TAP REST API by leveraging a custom logic app. This exact same process can be leveraged for other vendors who provide APIs to their data sources for easy integration into Azure Log Analytics/ Azure Sentinel.

 

Reviewers:

@Andrew Harris (AZURE SEC) 

@Nicholas DiCola (SECURITY JEDI) 

@Ofer Shezaf

@Tiander Turpijn 

@Yuri Diogenes