ebook img

Lastline Analyst API Documentation PDF

132 Pages·2017·0.5 MB·English
by  
Save to my drive
Quick download
Download
Most books are stored in the elastic cloud where traffic is expensive. For this reason, we have a limit on daily download.

Preview Lastline Analyst API Documentation

Lastline Analyst API Documentation Release 2.0 Lastline, Inc. Nov 09, 2022 CONTENTS 1 Overview 1 1.1 SupportedArtifacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 GettingStarted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 1.3 APIConcepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.4 Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.5 HandlingofContainers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2 APIReference 15 2.1 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.2 ResponseFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.3 Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.4 ErrorCodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 2.5 SubmissionMetadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 2.6 Web-PortalIntegration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 3 AnalysisResults 49 3.1 AnalysisReportFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 3.2 ReportFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 3.3 ReportFormatll-int-win . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 3.4 ReportFormatll-int-osx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 3.5 ReportFormatll-win-timeline-based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 3.6 PEStatsinformation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 3.7 PEResourceStatsinformation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 3.8 ReportFormatll-osx-timeline-based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 3.9 ReportFormatll-int-win-doc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 3.10 ReportFormatll-int-apk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 3.11 ReportFormatll-int-archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 3.12 ReportFormatll-web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 3.13 ReportFormatll-static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 3.14 ReportFormatll-ioc-json . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 3.15 ReportFormatll-pcap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 3.16 ReportFormatll-flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 3.17 ReportFormatll-doc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 3.18 ReportDescriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 4 ChildTasks 129 5 SampleAPIClients 131 5.1 AnalystAPIclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 5.2 AnalysisClientShell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 i 5.3 AnalystAPIShellExample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 5.4 AnalystAPIShellHelpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 5.5 ApplicationBundleModule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 PythonModuleIndex 159 Index 161 ii CHAPTER ONE OVERVIEW TheLastlineAnalystAPIprovidesfunctionalityforsubmittingresourcesforanalysisandobtainingtheresults. Cur- rently,itsupportsURLsaswellasvarioustypesofexecutablesanddocuments. Executables areanalyzed by running theminside a sandbox, recordingthe behavior of theprogram, and classifying the file based on the observed actions. Similarly, documents are opened in an instrumented file-editor/viewer or by analyzinganyactivecomponents(suchasscripts)embeddedinsidethedocuments;ineithercase,thebehaviorofthe codeisusedfordetectingifthefilecontainsanyanomalies. Additionally, the content of a submitted file is analyzed for structural similarities with other, previously classified malwareartifacts. URLsareanalyzedbyvisitingthemwithspecial,instrumentedbrowsersandobservingactionsinsidethebrowseror itsinteractionswithitsenvironment. Thelatestversionofthisdocumentationcanbefoundathttps://analysis.lastline.com/analysis/api-docs/html/overview. html,ordownloadedinPDFformatfromhttps://analysis.lastline.com/analysis/api-docs/LastlineAnalystAPI.pdf. 1.1 Supported Artifacts TheAPIsupportssubmissionsofURLsandfiles. Themaximumfilesizeis64MBforthehostedLastlineinfrastruc- ture-forOn-Premisesdeployments,thelimitisconfigurable(upto100MB)anddefaultsto10MB. Thefollowingtableprovidesanoverviewofthesupportedfiletypes: • AceArchiveFile: ACEarchivedata Lastlinemimetype: application/x-ace Typicalextension: .ace • BzipArchiveFile: bzip2compresseddata Lastlinemimetype: application/x-bzip Typicalextensions: .bz,.bz2,.tbz,.tbz2 • CabArchiveFile: MicrosoftCabinetarchivedata Lastlinemimetype: application/vnd.ms-cab-compressed Typicalextension: .cab • DiagCabArchiveFile: MicrosoftDiagnosticCabinetarchivedata Lastlinemimetype: application/vnd.ms-diagcab-compressed Typicalextension: .diagcab 1 LastlineAnalystAPIDocumentation,Release2.0 • DmgArchiveFile: Applediskimage Lastlinemimetype: application/x-apple-diskimage Typicalextensions: .dmg,.smi • Rfc2822EmailArchiveFile: RFC2822-formattedEmailfile Lastlinemimetype: data/email-rfc2822 Typicalextension: .eml • GzipArchiveFile: gzipcompresseddata Lastlinemimetype: application/x-gzip Typicalextensions: .gz,.tgz • JarArchiveFile: JavaJARarchive Lastlinemimetype: application/java-archive Typicalextension: .jar • WebappJarArchiveFile: JavaWebapparchive Lastlinemimetype: application/war-archive Typicalextension: .war • LhaArchiveFile: LHaarchivedata Lastlinemimetype: application/x-lha Typicalextensions: .lha,.lzh • LzmaArchiveFile: LZMAcompresseddata Lastlinemimetype: application/x-lzma Typicalextension: .lzma • NugetArchiveFile: NuGetpackagearchive Lastlinemimetype: application/x-nuget Typicalextension: .nupkg • UDFISOArchiveFile: UDFfilesystemdata Lastlinemimetype: application/x-udf-image Typicalextensions: .iso,.udf • ISO9660ISOArchiveFile: ISO9660CD-ROMfilesystemdata Lastlinemimetype: application/x-iso9660-image Typicalextension: .iso • RarArchiveFile: RARarchivedata Lastlinemimetype: application/x-rar Typicalextension: .rar • Rar5ArchiveFile: RARarchivedata,version5 Lastlinemimetype: application/x-rar5 Typicalextension: .rar 2 Chapter1. Overview LastlineAnalystAPIDocumentation,Release2.0 • TarArchiveFile: POSIXtararchivedata Lastlinemimetype: application/tar Typicalextension: .tar • DocumentLLAppBundleTarArchiveFile: LastlineApplicationBundleDocumentType Lastlinemimetype: application/llappbundle-document Typicalextensions: .tar,.llappbundle,.llapp • WindowsExecutableLLAppBundleTarArchiveFile: LastlineApplicationBundleWindowsExecutableType Lastlinemimetype: application/llappbundle-windows-executable Typicalextensions: .tar,.llappbundle,.llapp • WebReplayLLAppBundleTarArchiveFile: LastlineApplicationBundleWebReplayType Lastlinemimetype: application/llappbundle-web-replay Typicalextensions: .tar,.llappbundle,.llapp • TnefArchiveFile: TransportNeutralEncapsulationFormat Lastlinemimetype: application/vnd.ms-tnef Typicalextension: .dat • XarArchiveFile: XARarchivedata Lastlinemimetype: application/x-xar Typicalextensions: .xar,.pkg • XzArchiveFile: XZcompresseddata Lastlinemimetype: application/x-xz Typicalextensions: .xz,.txz • ZipArchiveFile: Ziparchivedata Lastlinemimetype: application/zip Typicalextension: .zip • SevenZipArchiveFile: 7-ziparchivedata Lastlinemimetype: application/x-7z-compressed Typicalextension: .7z • MicrosoftSettingContentDataFile: MicrosoftContent-Settingsdatafile* Lastlinemimetype: text/ms-settingcontent Typicalextension: .settingcontent-ms • CsvDataFile: CSVData Lastlinemimetype: data/csv Typicalextension: .csv • InternetInquiryDataFile: InternetInquirydatafile* Lastlinemimetype: text/x-ms-iqy Typicalextension: .iqy 1.1. SupportedArtifacts 3 LastlineAnalystAPIDocumentation,Release2.0 • SymbolicLinkDataFile: SymbolicLinkdatafile Lastlinemimetype: data/symbolic-link Typicalextensions: .slk,.sylk • PcapDataFile: tcpdumpcapturefile Lastlinemimetype: application/vnd.tcpdump.pcap Typicalextensions: .pcap,.pcapng • WordHangulCdfDocFile: HangulWordProcessordocument Lastlinemimetype: application/hangul-word Typicalextension: .hwp • ChmDocFile: MicrosoftWindowsHtmlHelpdata Lastlinemimetype: application/x-chm Typicalextension: .chm • HangulDocFile: HangulHWP3/HWP2000document* Lastlinemimetype: application/x-hwp Typicalextension: .hwp • ExcelMsMimeDocFile: MicrosoftExceldocumentinMHTMLformat Lastlinemimetype: application/msoffice-mime-xls Typicalextension: .xls • PowerpointMsMimeDocFile: MicrosoftPowerpointdocumentinMHTMLformat Lastlinemimetype: application/msoffice-mime-ppt Typicalextension: .ppt • WordMsMimeDocFile: MicrosoftWorddocumentinMHTMLformat Lastlinemimetype: application/msoffice-mime-doc Typicalextension: .doc • ExcelMsDocFile: MicrosoftOfficeExceldocument Lastlinemimetype: application/msoffice-xls Typicalextension: .xls • TemplateExcelMsDocFile: MicrosoftOfficeExceltemplatedocument Lastlinemimetype: application/msoffice-xlt Typicalextension: .xlt • ExcelEncryptedKnownMsDocFile: MicrosoftOfficeExceldocument(withpassword) Lastlinemimetype: application/msoffice-xls-encrypted Typicalextensions: .xls,.xlsx • MacroExcelEncryptedKnownMsDocFile: MicrosoftOfficeExceldocument(withpassword),withmacros Lastlinemimetype: application/msoffice-xlam-encrypted Typicalextension: .xlam 4 Chapter1. Overview LastlineAnalystAPIDocumentation,Release2.0 • PowerpointEncryptedKnownMsDocFile: MicrosoftOfficePowerpointdocument(withpassword) Lastlinemimetype: application/msoffice-ppt-encrypted Typicalextensions: .ppt,.pptx • WordEncryptedKnownMsDocFile: MicrosoftOfficeWorddocument(withpassword) Lastlinemimetype: application/msoffice-doc-encrypted Typicalextensions: .doc,.docx • PowerpointMsDocFile: MicrosoftOfficePowerpointdocument Lastlinemimetype: application/msoffice-ppt Typicalextensions: .ppt,.pps • TemplatePowerpointMsDocFile: MicrosoftOfficePowerpointtemplatedocument Lastlinemimetype: application/msoffice-pot Typicalextension: .pot • WordMsDocFile: MicrosoftOfficeWorddocument Lastlinemimetype: application/msoffice-doc Typicalextension: .doc • PublisherWordMsDocFile: MicrosoftPublisherdocument Lastlinemimetype: application/msoffice-publisher Typicalextension: .pub • TemplateWordMsDocFile: MicrosoftOfficeWorddocumenttemplate Lastlinemimetype: application/msoffice-dot Typicalextension: .dot • OoDocFile: Open/LibreOfficedocument Lastlinemimetype: application/vnd.oasis.opendocument Typicalextensions: .odp,.otp,.ods,.odt,.ott,.odg,.otg • PdfDocFile: PDFdocument Lastlinemimetype: application/pdf Typicalextension: .pdf • WordPerfectDocFile: WordPerfectdocument Lastlinemimetype: application/wordperfect Typicalextension: .wpd • RtfDocFile: RTFdocument Lastlinemimetype: text/rtf Typicalextension: .rtf • SwfDocFile: MacromediaFlashdata Lastlinemimetype: application/x-shockwave-flash Typicalextension: .swf 1.1. SupportedArtifacts 5 LastlineAnalystAPIDocumentation,Release2.0 • ExcelXmlDocFile: XML-basedMicrosoftOfficeExceldocument,pre-Office2007 Lastlinemimetype: application/x-spreadsheetml Typicalextension: .xml • PowerpointXmlDocFile: XML-basedMicrosoftOfficePowerpointpresentation,pre-Office2007 Lastlinemimetype: application/x-presentationml Typicalextension: .xml • WordXmlDocFile: XML-basedMicrosoftOfficeWorddocument,pre-Office2007 Lastlinemimetype: application/x-wordprocessingml Typicalextension: .xml • XdpXmlDocFile: AdobeXDPdocument Lastlinemimetype: application/vnd.adobe.xdp+xml Typicalextension: .xdp • XslXmlDocFile: eXtensibleStylesheetLanguageforXMLfile Lastlinemimetype: text/xsl Typicalextension: .xsl • ExcelMsDocxFile: MicrosoftOfficeExceldocument,OfficeOpenXMLformat Lastlinemimetype: application/msoffice-xlsx Typicalextension: .xlsx • MacroExcelMsDocxFile: MicrosoftOfficeExceldocument,OfficeOpenXMLformat,withmacros Lastlinemimetype: application/msoffice-xlsm Typicalextension: .xlsm • BinaryMacroExcelMsDocxFile: Microsoft Office Excel document, Office Open XML format, with macros andbinarystorage Lastlinemimetype: application/msoffice-xlsb Typicalextension: .xlsb • TemplateExcelMsDocxFile: MicrosoftOfficeExceltemplatedocument,OfficeOpenXMLformat Lastlinemimetype: application/msoffice-xltx Typicalextension: .xltx • MacroTemplateExcelMsDocxFile: Microsoft Office Excel spreadsheet template, Office Open XML format, withmacros Lastlinemimetype: application/msoffice-xltm Typicalextension: .xltm • PowerpointMsDocxFile: MicrosoftOfficePowerpointdocument,OfficeOpenXMLformat Lastlinemimetype: application/msoffice-pptx Typicalextensions: .pptx,.ppsx • MacroAddInPowerpointMsDocxFile: MicrosoftOfficePowerpointAddIndocument,OfficeOpenXMLfor- mat,withmacros 6 Chapter1. Overview

Description:
WordMsMimeDocFile: Microsoft Word document in MHTML format. Lastline ExcelXmlDocFile: XML-based Microsoft Office Excel document, pre-Office2007 macros. Lastline mime type: application/msoffice-pptm. Typical extension: .pptm VBAVisualBasicScriptFile: Visual Basic for Applications text.
See more

The list of books you might like

Most books are stored in the elastic cloud where traffic is expensive. For this reason, we have a limit on daily download.