#2398 Added processing of .zip attachments including files contained

pull/2759/head
graureiher 2023-02-08 09:13:08 +01:00
parent d2efb18ef1
commit efbddf10ea
1 changed files with 122 additions and 55 deletions

View File

@ -46,6 +46,93 @@ func (a Attachment) Validate() error {
return err return err
} }
// ApplyTemplateMSOffice parses MS Office attachment files and applies the supplied phishing template.
func (a *Attachment) ApplyTemplateMSOffice(ptx PhishingTemplateContext, decodedAttachment []byte) (io.Reader, error) {
// Most modern office formats are xml based and can be unarchived.
// .docm and .xlsm files are comprised of xml, and a binary blob for the macro code
// Zip archives require random access for reading, so it's hard to stream bytes. Solution seems to be to use a buffer.
// See https://stackoverflow.com/questions/16946978/how-to-unzip-io-readcloser
b := new(bytes.Buffer)
b.Write(decodedAttachment)
zipReader, err := zip.NewReader(bytes.NewReader(b.Bytes()), int64(b.Len())) // Create a new zip reader from the file
if err != nil {
return nil, err
}
newZipArchive := new(bytes.Buffer)
zipWriter := zip.NewWriter(newZipArchive) // For writing the new archive
// i. Read each file from the Word document archive
// ii. Apply the template to it
// iii. Add the templated content to a new zip Word archive
for _, zipFile := range zipReader.File {
ff, err := zipFile.Open()
if err != nil {
return nil, err
}
defer ff.Close()
contents, err := ioutil.ReadAll(ff)
if err != nil {
return nil, err
}
subFileExtension := filepath.Ext(zipFile.Name)
var tFile string
if subFileExtension == ".xml" || subFileExtension == ".rels" { // Ignore other files, e.g binary ones and images
// First we look for instances where Word has URL escaped our template variables. This seems to happen when inserting a remote image, converting {{.Foo}} to %7b%7b.foo%7d%7d.
// See https://stackoverflow.com/questions/68287630/disable-url-encoding-for-includepicture-in-microsoft-word
rx, _ := regexp.Compile("%7b%7b.([a-zA-Z]+)%7d%7d")
contents := rx.ReplaceAllFunc(contents, func(m []byte) []byte {
d, err := url.QueryUnescape(string(m))
if err != nil {
return m
}
return []byte(d)
})
// For each file apply the template.
tFile, err = ExecuteTemplate(string(contents), ptx)
if err != nil {
zipWriter.Close() // Don't use defer when writing files https://www.joeshaw.org/dont-defer-close-on-writable-files/
return nil, err
}
// Check if the subfile changed. We only need this to be set once to know in the future to check the 'parent' file
if tFile != string(contents) {
a.vanillaFile = false
}
} else {
tFile = string(contents) // Could move this to the declaration of tFile, but might be confusing to read
}
// Write new Word archive
newZipFile, err := zipWriter.Create(zipFile.Name)
if err != nil {
zipWriter.Close() // Don't use defer when writing files https://www.joeshaw.org/dont-defer-close-on-writable-files/
return nil, err
}
_, err = newZipFile.Write([]byte(tFile))
if err != nil {
zipWriter.Close()
return nil, err
}
}
zipWriter.Close()
return bytes.NewReader(newZipArchive.Bytes()), err
}
// ApplyTemplateTextFiles applies the supplied phishing template to text file attachments (txt, html, ics)
func (a *Attachment) ApplyTemplateTextFiles(ptx PhishingTemplateContext, decodedAttachment []byte) (io.Reader, error) {
processedAttachment, err := ExecuteTemplate(string(decodedAttachment), ptx)
if err != nil {
return nil, err
}
if processedAttachment != string(decodedAttachment) {
a.vanillaFile = false
}
return strings.NewReader(processedAttachment), nil
}
// ApplyTemplate parses different attachment files and applies the supplied phishing template. // ApplyTemplate parses different attachment files and applies the supplied phishing template.
func (a *Attachment) ApplyTemplate(ptx PhishingTemplateContext) (io.Reader, error) { func (a *Attachment) ApplyTemplate(ptx PhishingTemplateContext) (io.Reader, error) {
@ -61,18 +148,18 @@ func (a *Attachment) ApplyTemplate(ptx PhishingTemplateContext) (io.Reader, erro
// "application/vnd.openxmlformats-officedocument.wordprocessingml.document" // "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
fileExtension := filepath.Ext(a.Name) fileExtension := filepath.Ext(a.Name)
b, err := ioutil.ReadAll(decodedAttachment)
if err != nil {
return nil, err
}
// Initially assume that the attachment is vanilla and alter the state if changes are made to files
a.vanillaFile = true
switch fileExtension { switch fileExtension {
case ".docx", ".docm", ".pptx", ".xlsx", ".xlsm": case ".zip":
// Most modern office formats are xml based and can be unarchived. zipReader, err := zip.NewReader(bytes.NewReader(b), int64(len(b)))
// .docm and .xlsm files are comprised of xml, and a binary blob for the macro code
// Zip archives require random access for reading, so it's hard to stream bytes. Solution seems to be to use a buffer.
// See https://stackoverflow.com/questions/16946978/how-to-unzip-io-readcloser
b := new(bytes.Buffer)
b.ReadFrom(decodedAttachment)
zipReader, err := zip.NewReader(bytes.NewReader(b.Bytes()), int64(b.Len())) // Create a new zip reader from the file
if err != nil { if err != nil {
return nil, err return nil, err
} }
@ -80,75 +167,55 @@ func (a *Attachment) ApplyTemplate(ptx PhishingTemplateContext) (io.Reader, erro
newZipArchive := new(bytes.Buffer) newZipArchive := new(bytes.Buffer)
zipWriter := zip.NewWriter(newZipArchive) // For writing the new archive zipWriter := zip.NewWriter(newZipArchive) // For writing the new archive
// i. Read each file from the Word document archive // Iterate over every file in the zip and apply the template depending on the filetype
// ii. Apply the template to it
// iii. Add the templated content to a new zip Word archive
a.vanillaFile = true
for _, zipFile := range zipReader.File { for _, zipFile := range zipReader.File {
ff, err := zipFile.Open() ff, err := zipFile.Open()
if err != nil { if err != nil {
return nil, err return nil, err
} }
defer ff.Close() contents, err := io.ReadAll(ff)
contents, err := ioutil.ReadAll(ff)
if err != nil { if err != nil {
return nil, err return nil, err
} }
subFileExtension := filepath.Ext(zipFile.Name) defer ff.Close()
var tFile string
if subFileExtension == ".xml" || subFileExtension == ".rels" { // Ignore other files, e.g binary ones and images
// First we look for instances where Word has URL escaped our template variables. This seems to happen when inserting a remote image, converting {{.Foo}} to %7b%7b.foo%7d%7d.
// See https://stackoverflow.com/questions/68287630/disable-url-encoding-for-includepicture-in-microsoft-word
rx, _ := regexp.Compile("%7b%7b.([a-zA-Z]+)%7d%7d")
contents := rx.ReplaceAllFunc(contents, func(m []byte) []byte {
d, err := url.QueryUnescape(string(m))
if err != nil {
return m
}
return []byte(d)
})
// For each file apply the template. subfileExtension := filepath.Ext(zipFile.Name)
tFile, err = ExecuteTemplate(string(contents), ptx) var tFile io.Reader
switch subfileExtension {
case ".docx", ".docm", ".pptx", ".xlsx", ".xlsm":
tFile, err = a.ApplyTemplateMSOffice(ptx, contents)
if err != nil { if err != nil {
zipWriter.Close() // Don't use defer when writing files https://www.joeshaw.org/dont-defer-close-on-writable-files/ zipWriter.Close()
return nil, err return nil, err
} }
// Check if the subfile changed. We only need this to be set once to know in the future to check the 'parent' file case ".txt", ".html", ".ics":
if tFile != string(contents) { tFile, err = a.ApplyTemplateTextFiles(ptx, contents)
a.vanillaFile = false if err != nil {
zipWriter.Close()
return nil, err
} }
} else { default:
tFile = string(contents) // Could move this to the declaration of tFile, but might be confusing to read tFile = bytes.NewReader(contents)
} }
// Write new Word archive
newZipFile, err := zipWriter.Create(zipFile.Name) // Write the possibly changed file to the new zip file
tmp, err := zipWriter.Create(zipFile.Name)
if err != nil { if err != nil {
zipWriter.Close() // Don't use defer when writing files https://www.joeshaw.org/dont-defer-close-on-writable-files/ zipWriter.Close()
return nil, err return nil, err
} }
_, err = newZipFile.Write([]byte(tFile)) if _, err := io.Copy(tmp, tFile); err != nil {
if err != nil {
zipWriter.Close() zipWriter.Close()
return nil, err return nil, err
} }
} }
zipWriter.Close() zipWriter.Close()
return bytes.NewReader(newZipArchive.Bytes()), err return bytes.NewReader(newZipArchive.Bytes()), err
case ".docx", ".docm", ".pptx", ".xlsx", ".xlsm":
return a.ApplyTemplateMSOffice(ptx, b)
case ".txt", ".html", ".ics": case ".txt", ".html", ".ics":
b, err := ioutil.ReadAll(decodedAttachment) return a.ApplyTemplateTextFiles(ptx, b)
if err != nil {
return nil, err
}
processedAttachment, err := ExecuteTemplate(string(b), ptx)
if err != nil {
return nil, err
}
if processedAttachment == string(b) {
a.vanillaFile = true
}
return strings.NewReader(processedAttachment), nil
default: default:
return decodedAttachment, nil // Default is to simply return the file return decodedAttachment, nil // Default is to simply return the file
} }