Analyze Attachments
the analyze attachments connector facilitates the automated analysis and management of file attachments, enhancing workflow efficiency analyze attachments is a versatile tool designed to efficiently manage and analyze file attachments within the swimlane turbine platform it provides functionalities such as retrieving attachment names, determining file extensions, hashing files with various algorithms, and checking for empty files additionally, it can guess mimetypes, calculate file sizes, and handle zip file operations including extraction and compression by integrating with analyze attachments, swimlane turbine end users can automate and streamline the processing of file attachments, enhancing their security operations with minimal manual intervention capabilities this connector provides the following capabilities get attachment name get attachment extension hash attachment is empty is zipfile get size zip unzip write get mimetype actions get attachment name retrieve the name of an attachment in analyze attachments using the provided attachment input input argument name type required description attachment object required attachment attachment file string optional parameter for get attachment name attachment file name string optional name of the resource input example {"attachment" {"file" "string","file name" "example name"}} output parameter type description attachment name string name of the attachment output example {"attachment name" "string"} get extension return the file extension of a given attachment name in analyze attachments input argument name type required description attachment object required attachment attachment file string optional parameter for get extension attachment file name string optional name of the resource input example {"attachment" {"file" "string","file name" "example name"}} output parameter type description extension string extension of the attachment name output example {"extension" "string"} hash attachment hash an attachment using specified algorithms requires the attachment as input input argument name type required description attachment object required attachment attachment file string optional parameter for hash attachment attachment file name string optional name of the resource algorithm string optional the hash algorithm input example {"attachment" {"file" "string","file name" "example name"},"algorithm" "md5"} output parameter type description hash string hash of the file output example {"hash" "string"} is empty determine if an attachment is empty, returning true if it is and false otherwise requires the attachment input input argument name type required description attachment object required attachment attachment file string optional parameter for is empty attachment file name string optional name of the resource input example {"attachment" {"file" "string","file name" "example name"}} output parameter type description is empty boolean true if the attachment is empty output example {"is empty"\ true} get mimetype & encoding guess the mimetype and encoding of an attachment file in analyze attachments input argument name type required description attachment object required attachment attachment file string optional parameter for get mimetype & encoding attachment file name string optional name of the resource input example {"attachment" {"file" "string","file name" "example name"}} output parameter type description type string type of the attachment encoding string encoding of the attachment output example {"type" "string","encoding" "string"} get size return the size of the specified attachment in bytes input argument name type required description attachment object required attachment attachment file string optional parameter for get size attachment file name string optional name of the resource input example {"attachment" {"file" "string","file name" "example name"}} output parameter type description size number size of attachment in bytes output example {"size" 123} unzip attachment extract attachments from a zip file for analysis requires an attachment input input argument name type required description attachment object required attachment zip to extract attachment file string optional parameter for unzip attachment attachment file name string optional name of the resource password string optional password of the zipfile input example {"attachment" {"file" "string","file name" "example name"},"password" "string"} output parameter type description attachments array array of attachments extracted from the zipfile attachments file string output field attachments file attachments file name string name of the resource output example {"attachments" \[]} write attachment write specified text to an attachment and return the updated attachment requires attachment name and text as inputs input argument name type required description attachment name string required name of the attachment text string required text to write to the attachment input example {"attachment name" "example name","text" "string"} output parameter type description attachment object output field attachment attachment file string output field attachment file attachment file name string name of the resource output example {"attachment" {"file" "string","file name" "example name"}} zip attachments return the size of attachments in bytes using analyze attachments requires attachments and attachment name as inputs input argument name type required description attachments array required array of attachments extracted from the zipfile attachments file string optional parameter for zip attachments attachments file name string optional name of the resource attachment name string required name for the new zipfile password string optional password to protect the zipfile compression number optional number between 1 to 9, 1 (more fast) < > 9 (more compress) input example {"attachments" \[{"file" "string","file name" "example name"}],"attachment name" "example name","password" "string","compression" 1} output parameter type description zip object output field zip zip file string output field zip file zip file name string name of the resource output example {"zip" {"file" "string","file name" "example name"}} response headers header description example content type the media type of the resource application/json date the date and time at which the message was originated thu, 01 jan 2024 00 00 00 gmt